Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Menggunakan AWS AppConfig Agen dengan Amazon ECS dan Amazon EKS Anda dapat berintegrasi AWS AppConfig dengan Amazon Elastic Container Service (Amazon ECS) dan Amazon Elastic Kubernetes Service (Amazon EKS) dengan menggunakan Agen. AWS AppConfig Agen berfungsi sebagai wadah sespan yang berjalan bersama aplikasi penampung Amazon ECS dan Amazon EKS Anda. Agen meningkatkan pemrosesan dan manajemen aplikasi kontainer dengan cara berikut: + Agen memanggil AWS AppConfig atas nama Anda dengan menggunakan peran AWS Identity and Access Management (IAM) dan mengelola cache lokal data konfigurasi. Dengan menarik data konfigurasi dari cache lokal, aplikasi Anda memerlukan lebih sedikit pembaruan kode untuk mengelola data konfigurasi, mengambil data konfigurasi dalam milidetik, dan tidak terpengaruh oleh masalah jaringan yang dapat mengganggu panggilan untuk data tersebut. \$1 + Agen menawarkan pengalaman asli untuk mengambil dan menyelesaikan flag AWS AppConfig fitur. + Di luar kotak, agen menyediakan praktik terbaik untuk strategi caching, interval polling, dan ketersediaan data konfigurasi lokal sambil melacak token konfigurasi yang diperlukan untuk panggilan layanan berikutnya. + Saat berjalan di latar belakang, agen secara berkala melakukan polling bidang AWS AppConfig data untuk pembaruan data konfigurasi. Aplikasi kontainer Anda dapat mengambil data dengan menghubungkan ke localhost pada port 2772 (nilai port default yang dapat disesuaikan) dan memanggil HTTP GET untuk mengambil data. + AWS AppConfig Agen memperbarui data konfigurasi dalam kontainer Anda tanpa harus memulai ulang atau mendaur ulang kontainer tersebut. \$1AWS AppConfig Agen menyimpan data saat pertama kali layanan mengambil data konfigurasi Anda. Untuk alasan ini, panggilan pertama untuk mengambil data lebih lambat dari panggilan berikutnya. **Sebelum Anda mulai** Untuk berintegrasi AWS AppConfig dengan aplikasi kontainer, Anda harus membuat AWS AppConfig artefak dan data konfigurasi, termasuk flag fitur atau data konfigurasi bentuk bebas. Untuk informasi selengkapnya, lihat [Membuat flag fitur dan data konfigurasi formulir gratis di AWS AppConfig](creating-feature-flags-and-configuration-data.md). Untuk mengambil data konfigurasi yang dihosting oleh AWS AppConfig, aplikasi kontainer Anda harus dikonfigurasi dengan akses ke bidang AWS AppConfig data. Untuk memberikan akses kepada aplikasi Anda, perbarui kebijakan izin IAM yang digunakan oleh peran IAM layanan kontainer Anda. Secara khusus, Anda harus menambahkan `appconfig:StartConfigurationSession` dan `appconfig:GetLatestConfiguration` tindakan ke kebijakan. Peran IAM layanan kontainer meliputi: + Peran tugas Amazon ECS + Peran simpul Amazon EKS + Peran eksekusi AWS Fargate pod (jika container Amazon EKS Anda menggunakan Fargate untuk pemrosesan komputasi) Untuk informasi selengkapnya tentang menambahkan izin ke kebijakan, lihat [Menambahkan dan menghapus izin identitas IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) di Panduan Pengguna *IAM*. **Topics** + [Memulai AWS AppConfig agen untuk integrasi Amazon ECS](appconfig-integration-containers-agent-starting-ecs.md) + [Memulai AWS AppConfig agen untuk integrasi Amazon EKS](appconfig-integration-containers-agent-starting-eks.md) + [(Opsional) Berjalan AWS AppConfig sebagai DaemonSet di Amazon EKS](appconfig-integration-containers-agent-daemon.md) + [(Opsional) Menggunakan variabel lingkungan untuk mengonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS](appconfig-integration-containers-agent-configuring.md) + [Mengambil data konfigurasi untuk aplikasi yang berjalan di Amazon ECS dan Amazon EKS](appconfig-integration-containers-agent-retrieving-data.md) # Memulai AWS AppConfig agen untuk integrasi Amazon ECS Kontainer sespan AWS AppConfig Agen tersedia secara otomatis di lingkungan Amazon ECS Anda. Untuk menggunakannya, Anda harus memulainya, seperti yang dijelaskan dalam prosedur berikut. **Untuk memulai Amazon ECS (konsol)** 1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2). 1. Di panel navigasi, pilih **Definisi tugas**. 1. Pilih definisi tugas untuk aplikasi Anda, lalu pilih revisi terbaru. 1. Pilih **Buat revisi baru**, **Buat revisi baru**. 1. Pilih **Tambahkan lebih banyak wadah**. 1. Untuk **Nama**, masukkan nama unik untuk wadah AWS AppConfig Agen. 1. Untuk **URI Gambar**, masukkan: **public.ecr.aws/aws-appconfig/aws-appconfig-agent:2.x** 1. Untuk **wadah Essential**, pilih **Ya**. 1. Di bagian **Pemetaan port**, pilih **Tambahkan pemetaan port**. 1. Untuk **port Kontainer**, masukkan**2772**. **catatan** AWS AppConfig Agen berjalan pada port 2772, secara default. Anda dapat menentukan port yang berbeda. 1. Pilih **Buat**. Amazon ECS membuat revisi kontainer baru dan menampilkan detailnya. 1. Di panel navigasi, pilih **Cluster**, lalu pilih cluster aplikasi Anda dalam daftar. 1. Pada tab **Layanan**, pilih layanan untuk aplikasi Anda. 1. Pilih **Perbarui**. 1. Di bawah **konfigurasi Deployment**, untuk **Revisi, pilih revisi** terbaru. 1. Pilih **Perbarui**. Amazon ECS menerapkan definisi tugas terbaru. 1. Setelah penerapan selesai, Anda dapat memverifikasi bahwa AWS AppConfig Agen berjalan di tab **Konfigurasi dan tugas**. Pada tab **Tugas**, pilih tugas yang sedang berjalan. 1. Di bagian **Kontainer**, verifikasi bahwa kontainer AWS AppConfig Agen terdaftar. 1. Untuk memverifikasi bahwa AWS AppConfig Agen dimulai, pilih tab **Log**. Temukan pernyataan seperti berikut untuk wadah AWS AppConfig Agen: `[appconfig agent] 1970/01/01 00:00:00 INFO serving on localhost:2772` **catatan** Perhatikan informasi berikut. AWS AppConfig Agen adalah proses yang berjalan lama. Sebagai praktik terbaik untuk kontainer Amazon ECS, konfigurasikan pemeriksaan kesehatan untuk kontainer Anda, secara khusus mengatur ketergantungan kontainer ke kondisi SEHAT. Untuk informasi selengkapnya, lihat [ContainerDependency](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDependency.html)di *Referensi API Amazon Elastic Container Service*. Anda dapat menyesuaikan perilaku default AWS AppConfig Agen dengan memasukkan atau mengubah variabel lingkungan. Untuk informasi tentang variabel lingkungan yang tersedia, lihat[(Opsional) Menggunakan variabel lingkungan untuk mengonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS](appconfig-integration-containers-agent-configuring.md). Untuk informasi tentang cara mengubah variabel lingkungan di Amazon ECS, lihat [Meneruskan variabel lingkungan ke wadah](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html) di *Panduan Pengembang Layanan Kontainer Elastis Amazon*. # Memulai AWS AppConfig agen untuk integrasi Amazon EKS Kontainer sespan AWS AppConfig Agen tersedia secara otomatis di lingkungan Amazon EKS Anda. Untuk menggunakannya, Anda harus memulainya. Prosedur berikut menjelaskan cara menggunakan alat baris `kubectl` perintah Amazon EKS untuk memulai agen. **catatan** Sebelum melanjutkan, pastikan `kubeconfig` file Anda mutakhir. Untuk informasi selengkapnya tentang membuat atau mengedit `kubeconfig` file, lihat [Membuat atau memperbarui file kubeconfig untuk klaster Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html) di Panduan Pengguna **Amazon EKS**. **Untuk memulai AWS AppConfig Agen (alat baris perintah kubectl)** 1. Buka manifes untuk aplikasi Anda dan verifikasi bahwa aplikasi Amazon EKS Anda berjalan sebagai penerapan kontainer tunggal. Isi file akan terlihat mirip dengan yang berikut ini. ``` apiVersion: apps/v1 kind: Deployment metadata: name: my-app namespace: my-namespace labels: app: my-application-label spec: replicas: 1 selector: matchLabels: app: my-application-label template: metadata: labels: app: my-application-label spec: containers: - name: my-app image: my-repo/my-image imagePullPolicy: IfNotPresent ``` 1. Tambahkan detail definisi kontainer AWS AppConfig Agen ke manifes penerapan Anda. ``` - name: appconfig-agent image: public.ecr.aws/aws-appconfig/aws-appconfig-agent:2.x ports: - name: http containerPort: 2772 protocol: TCP env: - name: SERVICE_REGION value: Wilayah AWS imagePullPolicy: IfNotPresent ``` **catatan** Perhatikan informasi berikut. AWS AppConfig Agen berjalan pada port 2772, secara default. Anda dapat menentukan port yang berbeda. Anda dapat menyesuaikan perilaku default AWS AppConfig Agen dengan memasukkan variabel lingkungan. Untuk informasi selengkapnya, lihat [(Opsional) Menggunakan variabel lingkungan untuk mengonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS](appconfig-integration-containers-agent-configuring.md). Untuk*Wilayah AWS*, tentukan Wilayah AWS kode (misalnya,`us-west-1`) tempat AWS AppConfig Agen mengambil data konfigurasi. 1. Jalankan `kubectl` perintah berikut untuk menerapkan perubahan ke cluster Anda. Ganti *my-deployment* dengan nama manifes penerapan Anda. ``` kubectl apply -f my-deployment.yml ``` 1. Setelah penerapan selesai, verifikasi bahwa AWS AppConfig Agen sedang berjalan. Gunakan perintah berikut untuk melihat file log pod aplikasi. ``` kubectl logs -n my-namespace -c appconfig-agent my-pod ``` Temukan pernyataan seperti berikut untuk wadah AWS AppConfig Agen: `[appconfig agent] 1970/01/01 00:00:00 INFO serving on localhost:2772` **catatan** Anda dapat menyesuaikan perilaku default AWS AppConfig Agen dengan memasukkan atau mengubah variabel lingkungan. Untuk informasi tentang variabel lingkungan yang tersedia, lihat[(Opsional) Menggunakan variabel lingkungan untuk mengonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS](appconfig-integration-containers-agent-configuring.md). # (Opsional) Berjalan AWS AppConfig sebagai DaemonSet di Amazon EKS Dengan Amazon EKS, Anda dapat menjalankan AWS AppConfig Agen sebagai sespan, yang menghasilkan satu wadah agen *per pod aplikasi*. Atau, jika Anda mau, Anda dapat menjalankan AWS AppConfig Agen sebagai [DaemonSet](https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/), yang menghasilkan satu wadah agen *per node di cluster Anda*. **catatan** Jika Anda menjalankan AWS AppConfig Agen sebagai a DaemonSet, agen berjalan di pod terpisah, yang berarti Anda tidak dapat mengaksesnya dengan panggilan ke`localhost`. Anda harus menyuntikkan atau menemukan alamat IP agen pod untuk memanggilnya. Untuk menjalankan AWS AppConfig Agen sebagai DaemonSet, buat file manifes dengan konten berikut. Ganti *highlighted* teks dengan detail untuk aplikasi dan lingkungan Anda. Untuk*Wilayah AWS*, tentukan Wilayah AWS kode (misalnya,`us-west-1`). ``` apiVersion: apps/v1 kind: DaemonSet metadata: name: aws-appconfig-agent namespace: my_namespace labels: app: my_application_label spec: selector: matchLabels: app: my_application_label template: metadata: labels: app: my_application_label spec: containers: - name: aws-appconfig-agent image: public.ecr.aws/aws-appconfig/aws-appconfig-agent:2.x ports: - name: http containerPort: 2772 protocol: TCP env: - name: SERVICE_REGION value: Wilayah AWS imagePullPolicy: IfNotPresent # set a high priority class to ensure the agent is running on every node priorityClassName: system-node-critical ``` Jalankan perintah berikut untuk menerapkan AWS AppConfig Agen DaemonSet ke cluster Anda. Ganti *aws\$1appconfig\$1agent\$1daemonset* dengan nama DaemonSet manifes Anda. ``` kubectl apply -f aws_appconfig_agent_daemonset.yml ``` # (Opsional) Menggunakan variabel lingkungan untuk mengonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS Anda dapat mengonfigurasi AWS AppConfig Agen dengan mengubah variabel lingkungan berikut untuk wadah agen Anda. **catatan** Tabel berikut mencakup kolom **Nilai sampel**. Tergantung pada resolusi monitor Anda, Anda mungkin perlu menggulir ke bagian bawah tabel dan kemudian gulir ke kanan untuk melihat kolom. **** | Variabel lingkungan | Detail | Nilai default | Nilai sampel | | --- | --- | --- | --- | | `ACCESS_TOKEN` | Variabel lingkungan ini mendefinisikan token yang harus disediakan saat meminta data konfigurasi dari server HTTP agen. Nilai token harus diatur dalam header otorisasi permintaan HTTP dengan jenis otorisasi. `Bearer` Inilah contohnya. 
GET /applications/my_app/...
                  Host: localhost:2772
                  Authorization: Bearer
| Tidak ada | MyAccessToken | | `BACKUP_DIRECTORY` | Variabel lingkungan ini memungkinkan AWS AppConfig Agen untuk menyimpan cadangan dari setiap konfigurasi yang diambil ke direktori yang ditentukan. Konfigurasi yang dicadangkan ke disk tidak dienkripsi. Jika konfigurasi Anda berisi data sensitif, AWS AppConfig sarankan Anda mempraktikkan prinsip hak istimewa paling sedikit dengan izin sistem file Anda. Untuk informasi selengkapnya, lihat [Keamanan di AWS AppConfig](appconfig-security.md). | Tidak ada | /path/to/backups | | `HTTP_PORT` | Variabel lingkungan ini menentukan port di mana server HTTP untuk agen berjalan. | 2772 | 2772 | | `HTTP_HOST` | Variabel HTTP\$1HOST mengontrol bagaimana AWS AppConfig Agen mengikat ke antarmuka jaringan. Perilaku mengikat berbeda berdasarkan lingkungan runtime untuk memastikan keamanan dan aksesibilitas yang optimal. | ECS, EKS [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) EC2 dan on-prem [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | Opsi Konfigurasi Kustom. Anda dapat mengganti perilaku default menggunakan nilai-nilai ini: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) | | `LOG_LEVEL` | Variabel lingkungan ini menentukan tingkat detail yang dicatat agen. Setiap level mencakup level saat ini dan semua level yang lebih tinggi. Nilainya tidak peka huruf besar/kecil. Dari sebagian besar hingga yang paling tidak detail, level log adalah: `trace``debug`,`info`,,`warn`,`error`,`fatal`, dan`none`. `trace`Log mencakup informasi terperinci, termasuk informasi waktu, tentang agen. | info | jejak debug info menegur kesalahan mematikan none | | `LOG_PATH` | Lokasi disk tempat log ditulis. Jika tidak ditentukan, log ditulis ke stderr. | Tidak ada | /path/to/logs/agent.log | | `MANIFEST` | Variabel lingkungan ini mengonfigurasi AWS AppConfig Agen untuk memanfaatkan fitur per-konfigurasi tambahan seperti pengambilan multi-akun dan menyimpan konfigurasi ke disk. Untuk informasi lebih lanjut tentang fitur ini, lihat [Menggunakan manifes untuk mengaktifkan fitur pengambilan tambahan](appconfig-agent-how-to-use-additional-features.md). | Tidak ada | Saat menggunakan AWS AppConfig konfigurasi sebagai manifes:`MyApp:MyEnv:MyManifestConfig`.Saat memuat manifes dari disk: `file:/path/to/manifest.json` | | `MAX_CONNECTIONS` | Variabel lingkungan ini mengonfigurasi jumlah maksimum koneksi yang digunakan agen untuk mengambil konfigurasi dari. AWS AppConfig | 3 | 3 | | `POLL_INTERVAL` | Variabel lingkungan ini mengontrol seberapa sering agen melakukan polling AWS AppConfig untuk data konfigurasi yang diperbarui. Anda dapat menentukan sejumlah detik untuk interval tersebut. Anda juga dapat menentukan angka dengan satuan waktu: s untuk detik, m untuk menit, dan h selama berjam-jam. Jika unit tidak ditentukan, agen default ke detik. Misalnya, 60, 60-an, dan 1m menghasilkan interval jajak pendapat yang sama. | 45 detik | 4545-an5m1 jam | | `PREFETCH_LIST` | Variabel lingkungan ini menentukan data konfigurasi permintaan agen AWS AppConfig segera setelah dimulai. Beberapa pengidentifikasi konfigurasi dapat disediakan dalam daftar yang dipisahkan koma. | Tidak ada | MyApp:MyEnv:MyConfigabcd123:efgh456:ijkl789MyApp::Config1, MyEnv ::Config2 MyApp MyEnv | | `PRELOAD_BACKUPS` | Jika disetel ke`true`, AWS AppConfig Agen memuat cadangan konfigurasi yang ditemukan di memori `BACKUP_DIRECTORY` ke dalam dan segera memeriksa untuk melihat apakah ada versi yang lebih baru dari layanan. Jika disetel ke`false`, AWS AppConfig Agen hanya memuat konten dari cadangan konfigurasi jika tidak dapat mengambil data konfigurasi dari layanan, misalnya jika ada masalah dengan jaringan Anda. | true | true SALAH | | PROXY\$1HEADERS | Variabel lingkungan ini menentukan header yang diperlukan oleh proxy yang direferensikan dalam variabel lingkungan. PROXY\$1URL Nilainya adalah daftar header yang dipisahkan koma. | Tidak ada | header: nilai h1: v1, h2: v2 | | PROXY\$1URL | Variabel lingkungan ini menentukan URL proxy yang akan digunakan untuk koneksi dari agen ke Layanan AWS, termasuk AWS AppConfig. HTTPSdan HTTP URLs didukung. | Tidak ada | http://localhost:7474https://my-proxy.example.com | | `REQUEST_TIMEOUT` | Variabel lingkungan ini mengontrol jumlah waktu agen menunggu respons. AWS AppConfig Jika layanan tidak merespons, permintaan gagal. Jika permintaan untuk pengambilan data awal, agen mengembalikan kesalahan ke aplikasi Anda. Jika batas waktu terjadi selama pemeriksaan latar belakang untuk data yang diperbarui, agen mencatat kesalahan dan mencoba lagi setelah penundaan singkat. Anda dapat menentukan jumlah milidetik untuk batas waktu. Anda juga dapat menentukan angka dengan satuan waktu: ms untuk milidetik dan s untuk detik. Jika unit tidak ditentukan, agen default ke milidetik. Sebagai contoh, 5000, 5000 ms dan 5s menghasilkan nilai batas waktu permintaan yang sama. | 3000ms | 30003000ms5s | | ROLE\$1ARN | Variabel lingkungan ini menentukan Amazon Resource Name (ARN) dari peran IAM. AWS AppConfig Agen mengasumsikan peran ini untuk mengambil data konfigurasi. | Tidak ada | arn:aws:iam: :123456789012: peran/MyRole | | ROLE\$1EXTERNAL\$1ID | Variabel lingkungan ini menentukan ID eksternal untuk digunakan dengan peran ARN yang diasumsikan. | Tidak ada | MyExternalId | | ROLE\$1SESSION\$1NAME | Variabel lingkungan ini menentukan nama sesi yang akan dikaitkan dengan kredensyal untuk peran IAM yang diasumsikan. | Tidak ada | AWSAppConfigAgentSession | | SERVICE\$1REGION | Variabel lingkungan ini menentukan alternatif Wilayah AWS yang digunakan AWS AppConfig Agen untuk memanggil AWS AppConfig layanan. Jika dibiarkan tidak terdefinisi, agen mencoba menentukan Wilayah saat ini. Jika tidak bisa, agen gagal memulai. | Tidak ada | us-east-1eu-west-1 | | `WAIT_ON_MANIFEST` | Variabel lingkungan ini mengonfigurasi AWS AppConfig Agen untuk menunggu hingga manifes diproses sebelum menyelesaikan startup. | true | trueSALAH | # Mengambil data konfigurasi untuk aplikasi yang berjalan di Amazon ECS dan Amazon EKS Anda dapat mengambil data konfigurasi dari AWS AppConfig Agen untuk aplikasi yang berjalan di Amazon ECS dan Amazon EKS dengan menggunakan panggilan localhost HTTP. Contoh berikut digunakan `curl` dengan klien HTTP. Anda dapat menghubungi agen menggunakan klien HTTP yang tersedia yang didukung oleh bahasa aplikasi Anda atau pustaka yang tersedia. **catatan** Untuk mengambil data konfigurasi jika aplikasi Anda menggunakan garis miring maju, misalnya “test-backend/test-service”, Anda harus menggunakan pengkodean URL. **Untuk mengambil konten lengkap dari konfigurasi yang diterapkan** ``` $ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name" ``` **Untuk mengambil bendera tunggal dan atributnya dari AWS AppConfig konfigurasi tipe `Feature Flag`** ``` $ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name" ``` **Untuk mengakses beberapa flag dan atributnya dari AWS AppConfig konfigurasi tipe `Feature Flag`** ``` $ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two" ``` Panggilan mengembalikan metadata konfigurasi di header HTTP, termasuk versi konfigurasi, jenis konten, dan label versi konfigurasi (jika ada). Tubuh respon agen berisi konten konfigurasi. Inilah contohnya: ``` HTTP/1.1 200 OK Configuration-Version: 1 Content-Type: application/json Date: Tue, 18 Feb 2025 20:20:16 GMT Content-Length: 31 My test config ```