Beranda>Terkait pemrograman>Kode sumber lainnya
Unduh

AWS AppConfig Java Sampel

V2-2024

Ringkasan

Proyek ini adalah demo agen pengembang Amazon Q untuk transformasi kode. Ini adalah aplikasi Microservice berbasis Java 1.8 yang menampilkan daftar film gratis untuk bulan berdasarkan konfigurasi yang disimpan dalam layanan AWS AppConfig menggunakan AWS SDK. Aplikasi ini pertama kali bersumber terbuka pada tahun 2020 dan menggunakan versi warisan perpustakaan seperti Spring Boot 2.x, Log4J 2.13.x, Mockito 1.x, Javax dan Junit 4.

Agen pengembang Amazon Q untuk transformasi kode dapat meningkatkan versi bahasa kode file Anda. Anda dapat mengubah modul di JetBrains dan proyek atau seluruh ruang kerja dalam kode studio visual. Amazon Q pertama -tama membangun kode Anda dalam versi bahasa sumber dan memverifikasi bahwa ia memiliki informasi yang diperlukan untuk mengubah kode Anda. Setelah Amazon Q berhasil mengubah kode Anda, Anda memverifikasi dan menerima perubahan dalam Lingkungan Pengembangan Terpadu Anda (IDE). Untuk informasi lebih lanjut, lihat bagaimana agen pengembang amazon Q untuk transformasi kode bekerja. Artinya, Amazon Q dapat meningkatkan kode Java 8 dan Java 11 ke kode Java 17.

Lihat Panduan Memulai dan 3 cara bagaimana Amazon Q Developer Agent untuk transformasi kode mempercepat peningkatan Java Anda.

Instruksi Instalasi

Lokal

  1. Kompilasi aplikasi dalam IDE lokal
  2. Buka terminal baru dan ketik java -jar .targetmovie-service-0.1.0.jar
  3. Ikuti bagian Langkah 1 di AWS di bawah ini untuk mengatur konfigurasi AppConfig di profil akun AWS default Anda
  4. Buka browser dan buka http: // localhost: 8080/film/getmovies
  5. Anda harus dapat melihat daftar film berbayar

AWS

Langkah 1: Buat Aplikasi, Lingkungan, dan Profil Konfigurasi di AWS AppConfig

  1. Buka konsol AWS Systems Manager.
  2. Di panel navigasi kiri, pilih AWS AppConfig dan klik Mulai
  3. Jika halaman Welcome AWS AppConfig muncul, klik Buat Aplikasi di Navigasi Kiri.
  4. Untuk nama, masukkan nama untuk aplikasi. ( MyContainerApplication ) Anda dapat menambahkan deskripsi opsional dan menerapkan tag ke aplikasi. Pilih Buat Aplikasi.
  5. Setelah aplikasi dibuat, Anda diarahkan ke halaman dengan lingkungan dan profil konfigurasi memilih Create Environment, dan kemudian masukkan nama ( MyContainerApplicationProductionEnvironment ) dan deskripsi opsional untuk lingkungan. Anda juga dapat secara opsional menambahkan tag dan mengkonfigurasi alarm Amazon CloudWatch untuk lingkungan ini.
  6. Di navigasi atas, pilih nama aplikasi, dan pada tab Konfigurasi dan Tab Fitur Bendera, pilih Buat Profil Konfigurasi dan Konfigurasi Bentuk Bebas.
  7. Masukkan nama ( MyContainerApplicationConfigurationProfile ) dan deskripsi opsional untuk profil konfigurasi.
  8. Di bawah Sumber Konfigurasi, pilih AWS AppConfig Hosted Configuration. Konten di bawah, pilih JSON, tempel konten berikut, dan kemudian pilih Next. 
    {
  "movies": [
    {
      "id": 1,
      "movieName": "The Shawshank Redemption"
    },
    {
      "id": 2,
      "movieName": "City of God"
    },
    {
      "id": 3,
      "movieName": "Memento"
    },
    {
      "id": 4,
      "movieName": "The Intouchables"
    },
    {
      "id": 5,
      "movieName": "Stardust"
    },
    {
      "id": 6,
      "movieName": "Apocalypto"
    },
    {
      "id": 7,
      "movieName": "Taxi Driver"
    },
    {
      "id": 8,
      "movieName": "No Country for Old Men"
    },
    {
      "id": 9,
      "movieName": "Planet 51"
    },
    {
      "id": 10,
      "movieName": "The Beach"
    }
  ]
}
  1. (Opsional) Anda dapat menambahkan validator untuk memvalidasi konfigurasi. Untuk informasi, periksa tentang validator dalam dokumentasi AWS AppConfig.
  2. Pilih Buat Profil Konfigurasi.
  3. Pilih Mulai Penempatan.
  4. Pilih lingkungan, versi konfigurasi yang di -host, strategi penyebaran, dan deskripsi opsional untuk memulai proses penyebaran.
  5. Untuk membuat strategi penyebaran khusus, pilih Buat Strategi Penyebaran. Atau pilih salah satu strategi penempatan yang telah ditentukan sebelumnya yang disediakan oleh AWS AppConfig. Untuk informasi lebih lanjut, periksa membuat strategi penyebaran dalam dokumentasi AWS AppConfig. Untuk keperluan posting ini, kami memilih AppConfig.Linear50Sentevery30seconds strategi penyebaran.

Catatan: Bergantung pada strategi penyebaran yang Anda pilih, operasi ini mungkin membutuhkan beberapa menit untuk diselesaikan. Konfigurasi tersedia untuk aplikasi segera setelah status penempatan selesai.

** V1 - 2020 **

Catatan: Gunakan versi ini hanya jika Anda ingin mencoba fitur terkait AppConnFig.

Ringkasan

Ini adalah demo dari aplikasi AWS AppConfig Java seperti yang dijelaskan dalam penyebaran konfigurasi aplikasi posting blog ke beban kerja kontainer menggunakan AWS AppConfig. Demo ini menunjukkan cara mengintegrasikan aplikasi Java Microservices dengan layanan AWS AppConfig bersama dengan menerapkan cache dalam memori untuk mengelola konfigurasi aplikasi secara efisien.

AWS AppConfig membantu pelanggan AWS untuk dengan cepat meluncurkan konfigurasi aplikasi di seluruh aplikasi yang di-host pada contoh EC2, wadah, AWS Lambda, aplikasi seluler, perangkat IoT, dan server di tempat dengan cara yang divalidasi, dikendalikan, dan dipantau.

Kode sampel ini menjelaskan

  1. Cara memisahkan konfigurasi aplikasi dari kode aplikasi untuk aplikasi yang dimasukkan.
  2. Gunakan AWS AppConfig untuk mengelola dan menggunakan konfigurasi aplikasi.
  3. Cara mengotomatisasi dan mengelola konfigurasi aplikasi secara efisien dalam aplikasi yang dimasukkan.

Demo ini menggunakan templat CloudFormation untuk menggunakan cluster layanan wadah elastis Amazon dan tugas AWS Fargate. Pengguna akan mengkloning repositori ini, membangun gambar Docker dan mendorong ke Amazon Elastic Container Registry dan berinteraksi dengan layanan AWS AppConfig.

Aplikasi ini memiliki lapisan caching yang dibangun untuk menyimpan tanggapan dari layanan AWS AppConfig. Panggilan berikutnya untuk mengambil nilai konfigurasi memeriksa cache terlebih dahulu dan mengembalikan respons dari cache. Jika cache kosong, maka itu membuat panggilan ke AWS AppConfig API untuk mengambil nilainya. Cache Expiry didasarkan pada set TTL di properti.

Instruksi Instalasi

Lokal

  1. Kompilasi aplikasi dalam IDE lokal
  2. Buka terminal baru dan ketik java -jar .targetmovie-service-0.1.0.jar
  3. Ikuti bagian Langkah 1 di AWS di bawah ini untuk mengatur konfigurasi AppConfig di profil akun AWS default Anda
  4. Buka browser dan buka http: // localhost: 8080/film/getmovies
  5. Anda harus dapat melihat daftar 5 film berbayar

AWS

Langkah 1: Buat Aplikasi, Lingkungan, dan Profil Konfigurasi di AWS AppConfig

  1. Buka konsol AWS Systems Manager.
  2. Di panel navigasi kiri, pilih AWS AppConfig.
  3. Jika halaman Welcome AWS AppConfig muncul, klik Buat Data Konfigurasi. Jika tidak, klik Buat Aplikasi.
  4. Untuk nama, masukkan nama untuk aplikasi. ( MyContainerApplication ) Anda dapat menambahkan deskripsi opsional dan menerapkan tag ke aplikasi. Pilih Buat Aplikasi.
  5. Setelah aplikasi dibuat, Anda diarahkan ke halaman dengan lingkungan dan profil konfigurasi memilih Create Environment, dan kemudian masukkan nama ( MyContainerApplicationProductionEnvironment ) dan deskripsi opsional untuk lingkungan. Anda juga dapat secara opsional menambahkan tag dan mengkonfigurasi alarm Amazon CloudWatch untuk lingkungan ini.
  6. Di navigasi atas, pilih nama aplikasi, dan pada tab Profil Konfigurasi, pilih Buat Profil Konfigurasi.
  7. Masukkan nama ( MyContainerApplicationConfigurationProfile ) dan deskripsi opsional untuk profil konfigurasi.
  8. Di bawah Sumber Konfigurasi, pilih AWS AppConfig Hosted Configuration. Konten di bawah, pilih JSON, tempel konten berikut, dan kemudian pilih Next. 
    {
      "boolEnableFeature": true,
      "intItemLimit": 5
    }
  1. (Opsional) Anda dapat menambahkan validator untuk memvalidasi konfigurasi. Untuk informasi, periksa tentang validator dalam dokumentasi AWS AppConfig.
  2. Pilih Buat Profil Konfigurasi.
  3. Pilih Mulai Penempatan.
  4. Pilih lingkungan, versi konfigurasi yang di -host, strategi penyebaran, dan deskripsi opsional untuk memulai proses penyebaran.
  5. Untuk membuat strategi penyebaran khusus, pilih Buat Strategi Penyebaran. Atau pilih salah satu strategi penempatan yang telah ditentukan sebelumnya yang disediakan oleh AWS AppConfig. Untuk informasi lebih lanjut, periksa membuat strategi penyebaran dalam dokumentasi AWS AppConfig. Untuk keperluan posting ini, kami memilih AppConfig.Linear50Sentevery30seconds strategi penyebaran.

Catatan: Bergantung pada strategi penyebaran yang Anda pilih, operasi ini mungkin membutuhkan beberapa menit untuk diselesaikan. Konfigurasi tersedia untuk aplikasi segera setelah status penempatan selesai.

Langkah 2: Siapkan aplikasi dasar dengan Amazon ECS dan Amazon ECR dan komponen jaringan terkait menggunakan AWS CloudFormation

  1. Buka CloudFormation Console dan klik "Buat Stack", pilih opsi "dengan sumber daya baru".
  2. Di layar berikutnya, di bawah bagian "Tentukan template" pilih "Unggah File Template", dan berikan file yang Anda unduh dari repo /templates/ecs-cluster.yml.
  3. Klik Berikutnya, berikan tumpukan nama seperti "ecscluster-dev", dan pilih dev sebagai nilai untuk parameter lingkungan. Klik berikutnya, secara opsional tentukan tag Anda, dan klik berikutnya lagi. Di layar terakhir, jangan lupa untuk mencentang kotak centang di bagian "Kemampuan", dan akhirnya klik tombol "Buat Stack".

Langkah 3: Kloning Kode Repositori, Buat Wadah Docker, dan Publikasikan ke Amazon ECR

  1. Git mengkloning repositori ini
  2. Arahkan ke Amazon Elastic Container Registry Console, klik pada repositori yang Anda buat dan klik Lihat Perintah Push.
  3. Arahkan ke repositori kode di prompt perintah dan jalankan perintah push untuk mengunggah proyek.
  4. Saat unggahan selesai, salin URL gambar di repositori. Gunakan URL ini sebagai parameter input (ImageUrl) ke template AWS Cloudformation yang disebutkan di bagian selanjutnya.

Langkah 4: Buat tugas Fargate dan sebarkan aplikasi wadah ke Amazon ECS di AWS Fargate menggunakan AWS CloudFormation

  1. Buka CloudFormation Console dan klik "Buat Stack", pilih opsi "dengan sumber daya baru".
  2. Di layar berikutnya, di bawah bagian "Tentukan Template" pilih "Unggah File Template", dan berikan file yang Anda unduh dari repo /templates/fargate-tkk.yml.
  3. Klik Berikutnya, berikan nama ke tumpukan seperti "Fargate-Task-Dev". Pilih "dev" sebagai nilai untuk parameter lingkungan.
  4. Berikan URL gambar yang diperoleh pada langkah sebelumnya untuk parameter ImageUrl dan tinggalkan sisa parameter sebagai default.
  5. Klik Berikutnya dan secara opsional tentukan tag Anda. Klik berikutnya lagi. Di layar terakhir, jangan lupa untuk mencentang kotak centang di bagian "Kemampuan", dan akhirnya klik tombol "Buat Stack".

Langkah 5: Verifikasi aplikasi yang digunakan, perbarui data konfigurasi AppConfig, dan gunakan konfigurasi yang diperbarui

  1. Arahkan ke AWS Cloudformation Console dan buka tumpukan Fargate-Task-Dev yang Anda buat
  2. Klik output dan salin externalurl untuk LoadBalancer
  3. Verifikasi aplikasi dengan menggunakan URL eksternal untuk penyeimbang beban. http: // eksternalur/film/getMovies
  4. Selanjutnya, kami akan mengubah nilai konfigurasi di AWS AppConfig dan melihat bagaimana itu akan tercermin dalam aplikasi kontainer.
  5. Buka konsol AWS AppConfig, klik pada aplikasi Anda dan buka tab Profil Konfigurasi dan klik pada profil konfigurasi yang Anda buat
  6. Klik pada Buat versi konfigurasi yang di -host, ini akan membuka layar baru di mana Anda dapat mengedit data konfigurasi.
  7. Edit nilai konfigurasi dan klik Buat tombol versi konfigurasi yang di -host.
  8. Selanjutnya, klik Mulai Penyebaran dan pilih lingkungan, versi konfigurasi hosting terbaru, strategi penyebaran dan deskripsi opsional untuk memulai proses penyebaran.
  9. Setelah penyebaran selesai, kunjungi URL aplikasi lagi untuk melihat perubahan yang tercermin segera.
  10. Perhatikan bahwa perubahan ini tidak mengharuskan aplikasi kontainer untuk dimulai ulang karena aplikasi mengambil nilai yang diperbarui dalam panggilan berikutnya ke AWS AppConfig.

Pembersihan

Hapus semua sumber daya yang dibuat di seluruh proses ini dan mencegah biaya tambahan.

AppConfig

  1. Konfigurasi yang di -host
  2. Profil konfigurasi
  3. Lingkungan
  4. Aplikasi

Aplikasi Kontainer Dasar dan Tugas Fargate

  1. Arahkan ke konsol AWS Cloudformation
  2. Pilih tumpukan Fargate-Task-Dev dan klik Hapus
  3. Pilih tumpukan ecscluster-dev dan klik hapus

Lisensi

Kode sampel ini dilisensikan di bawah lisensi MIT-0. Lihat file lisensi.

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua