Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah lingkungan Elastic Beanstalk Anda
Bab ini memberikan panduan untuk memecahkan masalah dengan lingkungan Elastic Beanstalk Anda. Ini termasuk yang berikut:
+ Pengantar AWS Systems Manager, termasuk prosedur untuk menjalankan runbook Elastic Beanstalk yang telah ditentukan sebelumnya yang menampilkan langkah dan rekomendasi pemecahan masalah.
+ Panduan umum untuk tindakan dan sumber daya yang akan digunakan saat status lingkungan Anda menurun.
+ Kiat pemecahan masalah khusus yang diatur berdasarkan kategori.
**Jika kesehatan lingkungan Anda berubah menjadi merah**, kami sarankan Anda terlebih dahulu menggunakan AWS Systems Manager alat yang menyertakan runbook yang telah ditentukan untuk memecahkan masalah Elastic Beanstalk. Untuk informasi lebih lanjut lihat[ Menggunakan alat Systems Manager](#troubleshooting-systems-manager).
**Coba Amazon Q Developer CLI untuk pemecahan masalah yang dibantu AI**
Amazon Q Developer CLI dapat membantu Anda memecahkan masalah lingkungan dengan cepat. Q CLI memberikan solusi dengan memeriksa status lingkungan, meninjau peristiwa, menganalisis log, dan mengajukan pertanyaan klarifikasi. Untuk informasi selengkapnya dan penelusuran terperinci, lihat [Memecahkan Masalah Lingkungan Elastic Beanstalk dengan CLI](https://aws.amazon.com/blogs/devops/troubleshooting-elastic-beanstalk-environments-with-amazon-q-developer-cli/) Pengembang Amazon Q di blog. AWS
**Topics**
+ [Menggunakan analisis lingkungan bertenaga AI](#troubleshooting-ai-analysis)
+ [Menggunakan runbook AWS Systems Manager Elastic Beanstalk](#troubleshooting-systems-manager)
+ [Panduan umum untuk mengatasi masalah lingkungan Elastic Beanstalk Anda](#troubleshooting-general)
+ [Lingkungan yang mengakses rahasia dan parameter dengan variabel lingkungan](#troubleshooting-secrets-env-variables)
+ [Pembuatan lingkungan dan peluncuran instans](#troubleshooting-envcreate)
+ [Deployment](#troubleshooting-deployments)
+ [Health](#troubleshooting-health)
+ [Lingkungan dengan penyeimbang beban terkonfigurasi dual-stack](#troubleshooting-dual-stack-load-balancer)
+ [Konfigurasi](#troubleshooting-configuration)
+ [Mengatasi masalah kontainer Docker](#troubleshooting-docker)
+ [Pertanyaan yang Sering Diajukan](#troubleshooting-faq)
+ [Kesalahan Umum](#common-errors)
+ [Kesalahan penerapan](#python-common-troubleshooting)
## Menggunakan analisis lingkungan bertenaga AI
Elastic Beanstalk menyediakan analisis bertenaga AI untuk membantu mengidentifikasi akar penyebab dan merekomendasikan solusi untuk masalah kesehatan lingkungan. Anda dapat mengakses fitur ini melalui tombol **Analisis AI** konsol, dengan menggunakan Elastic Beanstalk API AWS CLI melalui, atau dengan **eb logs --analyze** menjalankan dengan EB CLI. Analisis ini memeriksa log, peristiwa, dan kesehatan instans lingkungan Anda untuk mengidentifikasi masalah kritis dan memberikan rekomendasi step-by-step pemecahan masalah.
Untuk informasi selengkapnya, lihat [Analisis lingkungan bertenaga AI](health-ai-analysis.md).
## Menggunakan runbook AWS Systems Manager Elastic Beanstalk
Anda dapat menggunakan Systems Manager untuk memecahkan masalah lingkungan Elastic Beanstalk Anda. Untuk membantu Anda memulai dengan cepat, Systems Manager menyediakan runbook Otomasi yang telah ditentukan untuk Elastic Beanstalk. Runbook Otomasi adalah jenis dokumen Systems Manager yang mendefinisikan tindakan yang harus dilakukan pada instance lingkungan Anda dan sumber daya lainnya. AWS
Dokumen `AWSSupport-TroubleshootElasticBeanstalk` ini adalah runbook Otomasi yang dirancang untuk membantu mengidentifikasi sejumlah masalah umum yang dapat menurunkan lingkungan Elastic Beanstalk Anda. Untuk melakukannya, ia memeriksa komponen lingkungan Anda, termasuk yang berikut: instans EC2, VPC, CloudFormation tumpukan, penyeimbang beban, grup Auto Scaling, dan konfigurasi jaringan yang terkait dengan aturan grup keamanan, tabel rute, dan. ACLs
Ini juga menyediakan opsi untuk mengunggah file log yang dibundel dari lingkungan Anda ke AWS Support.
Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html) di *referensi buku runbook Otomatisasi AWS Systems Manager *.
**Menggunakan Systems Manager untuk menjalankan `AWSSupport-TroubleshootElasticBeanstalk` runbook**
**catatan**
Jalankan prosedur ini di tempat yang sama Wilayah AWS di mana lingkungan Elastic Beanstalk Anda berada.
1. Buka konsol [AWS Systems Manager](https://console.aws.amazon.com/systems-manager/home).
1. Dari panel navigasi, di bagian **Manajemen Perubahan**, pilih **Otomasi**.
1. Pilih **Eksekusi otomatisasi**.
1. Pada tab **Dimiliki oleh Amazon**, di kotak pencarian **dokumen Otomasi**, masukkan`AWSSupport-TroubleshootElasticBeanstalk`.
1. Pilih **AWSSupport-TroubleshootElasticBeanstalk**kartu, lalu pilih **Berikutnya**.
1. Pilih **Jalankan**.
1. Di bagian **Parameter input**:
1. Dari **AutomationAssumeRole**dropdown, pilih ARN dari peran yang memungkinkan Systems Manager untuk melakukan tindakan atas nama Anda.
1. Untuk **ApplicationName**, masukkan nama aplikasi Elastic Beanstalk.
1. Untuk **Nama Lingkungan**, masukkan lingkungan Elastic Beanstalk.
1. (Opsional) Untuk **S3 UploaderLink**, masukkan tautan jika AWS Support Engineer telah memberi Anda tautan S3 untuk pengumpulan log.
1. Pilih **Eksekusi**.
Jika salah satu langkah gagal, pilih tautan di bawah kolom **ID Langkah** untuk langkah yang gagal. Ini menampilkan halaman **detail Eksekusi** untuk langkah tersebut. **VerificationErrorMessage**Bagian ini akan menampilkan ringkasan langkah-langkah yang membutuhkan perhatian. Misalnya, `IAMPermissionCheck` dapat menampilkan pesan Peringatan. Dalam hal ini, Anda dapat memeriksa apakah peran yang dipilih di **AutomationAssumeRole**dropdown memiliki izin yang diperlukan.
Setelah semua langkah berhasil diselesaikan, output memberikan langkah pemecahan masalah dan rekomendasi untuk memulihkan lingkungan Anda ke keadaan sehat.
## Panduan umum untuk mengatasi masalah lingkungan Elastic Beanstalk Anda
Pesan kesalahan dapat muncul di halaman Acara di konsol, di log, atau di halaman Kesehatan. Anda juga dapat mengambil tindakan untuk pulih dari lingkungan terdegradasi yang disebabkan oleh perubahan baru-baru ini. Jika kesehatan lingkungan Anda berubah menjadi Merah, coba yang berikut ini:
+ Minta analisis lingkungan Anda yang didukung AI. Untuk informasi selengkapnya, lihat [Analisis lingkungan bertenaga AI](health-ai-analysis.md).
+ Jika operasi di lingkungan Anda menampilkan kesalahan yang berisi teks`The stack {{stack_id}} associated with environment {{environment-ID}} is in {{stack-status}} state`, lihat bantuan [Memulihkan lingkungan Elastic Beanstalk Anda dari keadaan tidak valid](environment-management-invalid-stack.md) pemecahan masalah.
+ Jika operasi di lingkungan Anda mengembalikan kesalahan yang berisi teks`Environment {{environment-name}} associated CloudFormation stack {{stack_arn}} does not exist`, hentikan lingkungan Anda dan buat yang lain.
+ Tinjau [peristiwa](using-features.events.md) lingkungan terbaru. Pesan dari Elastic Beanstalk tentang masalah deployment, beban, dan konfigurasi sering muncul di sini.
+ Tinjau [riwayat perubahan](using-features.changehistory.md) lingkungan terbaru. Riwayat perubahan mencantumkan semua perubahan konfigurasi yang dibuat pada lingkungan Anda dan termasuk informasi lainnya, seperti pengguna IAM yang membuat perubahan dan parameter konfigurasi yang ditetapkan.
+ [Tarik log](using-features.logging.md) untuk melihat entri berkas log terbaru. Log server web berisi informasi tentang permintaan dan kesalahan yang masuk.
+ [Connect ke instans](using-features.ec2connect.md) dan periksa sumber daya sistem.
+ [Gulung kembali](using-features.deploy-existing-version.md) ke versi aplikasi yang berfungsi sebelumnya.
+ Membatalkan perubahan konfigurasi terbaru atau memulihkan [konfigurasi tersimpan](environment-configuration-methods-before.md#configuration-options-before-savedconfig).
+ Men-deploy lingkungan baru. Jika lingkungan tampak sehat, lakukan [swap CNAME](using-features.CNAMESwap.md) untuk merutekan lalu lintas ke lingkungan baru dan terus men-debug yang sebelumnya.
## Lingkungan yang mengakses rahasia dan parameter dengan variabel lingkungan
**Acara:** *Penerapan instance gagal mendapatkan satu atau lebih rahasia*
Pesan ini menunjukkan bahwa Elastic Beanstalk tidak dapat mengambil satu atau lebih rahasia yang ditentukan selama penerapan aplikasi Anda.
+ Periksa apakah sumber daya yang ditentukan oleh nilai ARN dalam konfigurasi variabel lingkungan Anda ada.
+ Konfirmasikan bahwa peran profil instans Elastic Beanstalk EC2 Anda [memiliki izin IAM yang diperlukan untuk mengakses sumber daya](AWSHowTo.secrets.IAM-permissions.md#AWSHowTo.secrets.IAM-permissions.secrets-manager).
+ Jika peristiwa ini dipicu melalui `RestartAppServer` operasi, setelah masalah diperbaiki, coba lagi `RestartAppServer` panggilan untuk menyelesaikan masalah.
+ Jika acara dipicu melalui `UpdateEnvironment` panggilan, coba lagi `UpdateEnvironment` operasi.
Untuk contoh perintah ini, lihat [https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html](https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html). Untuk informasi selengkapnya tentang tindakan API untuk operasi ini, lihat *[Referensi AWS Elastic Beanstalk API](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/)*.
**Peristiwa:** *Penerapan instance mendeteksi satu atau lebih nilai lingkungan multiline, yang tidak didukung untuk platform* ini
Variabel multiline tidak didukung untuk platform Amazon Linux 2, tidak termasuk platform Docker yang dikelola Docker dan ECS. Untuk opsi yang tersedia untuk melanjutkan, lihat[Nilai multiline](AWSHowTo.secrets.env-vars.md#AWSHowTo.secrets.multiline).
**Acara: CreateEnvironment ** *gagal ketika rahasia ditentukan*
Ketika `CreateEnvironment` gagal dan Anda memiliki rahasia sebagai variabel lingkungan, Anda perlu mengatasi masalah mendasar dan kemudian menggunakannya `UpdateEnvironment` untuk menyelesaikan pengaturan lingkungan. Jangan gunakan`RestartAppServer`, karena tidak akan cukup untuk memunculkan lingkungan dalam situasi ini. Untuk contoh perintah ini, lihat [https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html](https://docs.aws.amazon.com//cli/latest/userguide/cli_elastic-beanstalk_code_examples.html). Untuk informasi selengkapnya tentang tindakan API untuk operasi ini, lihat *[Referensi AWS Elastic Beanstalk API](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/)*.
## Pembuatan lingkungan dan peluncuran instans
**Peristiwa:** *Gagal Meluncurkan Lingkungan*
Peristiwa ini terjadi ketika Elastic Beanstalk mencoba untuk meluncurkan lingkungan dan menemukan kegagalan di sepanjang jalan. Peristiwa sebelumnya di halaman **Peristiwa** akan memberi tahu Anda akar masalahnya.
**Peristiwa:** *Membuat operasi lingkungan selesai, tetapi dengan batas waktu perintah. Coba tingkatkan batas waktu periode.*
Aplikasi Anda mungkin membutuhkan waktu lama untuk men-deploy jika Anda menggunakan file konfigurasi yang menjalankan perintah di instans, mengunduh file besar, atau memasang paket. Tingkatkan [batas wkatu perintah](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console) untuk memberikan aplikasi Anda lebih banyak waktu untuk mulai berjalan selama deployment.
**Peristiwa:** *Sumber daya berikut gagal dibuat: [AWSEBInstanceLaunchWaitCondition]*
Pesan ini menunjukkan bahwa lingkungan instans Amazon EC2 Anda tidak berkomunikasi dengan Elastic Beanstalk bahwa instans berhasil diluncurkan. Hal ini dapat terjadi jika instans tidak memiliki konektivitas Internet. Jika Anda mengonfigurasi lingkungan Anda untuk meluncurkan instans di subnet VPC pribadi, [pastikan subnet memiliki NAT](vpc.md) untuk mengizinkan instans terhubung ke Elastic Beanstalk.
**Peristiwa:** *Peran Layanan diperlukan di wilayah ini. Harap tambahkan opsi Peran Layanan ke lingkungan.*
Elastic Beanstalk menggunakan peran layanan untuk memantau sumber daya di lingkungan dan mendukung [pembaruan platform terkelola](environment-platform-update-managed.md). Lihat [Mengelola peran layanan Elastic Beanstalk](iam-servicerole.md) untuk informasi selengkapnya.
## Deployment
**Masalah:** *Aplikasi menjadi tidak tersedia selama deployment*
Karena Elastic Beanstalk menggunakan proses peningkatan drop-in, mungkin ada waktu henti beberapa detik. Gunakan [deployment bergulir](using-features.rolling-version-deploy.md) untuk meminimalkan efek deployment di lingkungan produksi Anda.
**Acara:** *Gagal membuat versi aplikasi AWS Elastic Beanstalk*
Paket sumber aplikasi Anda mungkin terlalu besar, atau Anda mungkin telah mencapai [kuota versi aplikasi](applications-versions.md).
**Peristiwa:** *Pembaruan operasi lingkungan selesai, tetapi dengan batas waktu perintah. Coba tingkatkan batas waktu periode.*
Aplikasi Anda mungkin membutuhkan waktu lama untuk men-deploy jika Anda menggunakan file konfigurasi yang menjalankan perintah di instans, mengunduh file besar, atau memasang paket. Tingkatkan [batas wkatu perintah](using-features.rolling-version-deploy.md#environments-cfg-rollingdeployments-console) untuk memberikan aplikasi Anda lebih banyak waktu untuk mulai berjalan selama deployment.
## Health
**Peristiwa:** *Penggunaan CPU melebihi 95,00%*
Coba [jalankan lebih banyak instans](using-features.managing.as.md), atau [pilih tipe instans yang berbeda](using-features.managing.ec2.md).
**Event:** *Elastic Load Balancer awseb- {{myapp}} Memiliki Nol Instans Sehat*, *proses ELB tidak* sehat di luar instans. {{X}} {{Y}} , *Proses ELB tidak sehat pada semua contoh*.
Pesan-pesan ini menunjukkan bahwa pemeriksaan kesehatan penyeimbang beban Anda gagal pada satu atau lebih contoh. Jika aplikasi Anda tampak berfungsi, pastikan URL pemeriksaan kesehatan aplikasi Anda dikonfigurasi dengan benar. Jika tidak, coba yang berikut ini:
+ Periksa log aplikasi Anda (misalnya,`/var/log/web.stdout.log`) dan `/var/log/eb-engine.log` untuk kesalahan, kegagalan startup, atau masalah penerapan.
+ Periksa log proxy untuk kesalahan koneksi di `/var/log/nginx/` (nginx) `/var/log/httpd/` atau (Apache).
+ Verifikasi aplikasi Anda merespons dengan HTTP 200 ke jalur pemeriksaan kesehatan yang dikonfigurasi dan mendengarkan pada port yang diharapkan.
+ Verifikasi grup keamanan mengizinkan lalu lintas masuk dari penyeimbang beban ke instance di port pemeriksaan kesehatan. Di konsol EC2, periksa aturan masuk pada grup keamanan instans untuk mengonfirmasi port pemeriksaan kesehatan terbuka untuk grup keamanan penyeimbang beban.
+ Periksa pemanfaatan CPU dan memori dalam CloudWatch metrik (`CPUUtilization`,`EnvironmentHealth`). Kelelahan sumber daya dapat menyebabkan batas waktu pemeriksaan kesehatan.
Untuk detail selengkapnya, [ambil log bundel lengkap](using-features.logging.md) atau [aktifkan streaming CloudWatch log](AWSHowTo.cloudwatchlogs.md). Anda juga dapat menjalankan runbook [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html)otomatisasi untuk membantu mendiagnosis masalah.
**Acara:** *Elastic Load Balancer awseb* - Tidak Dapat Ditemukan {{myapp}}
Penyeimbang beban lingkungan Anda mungkin telah dihapus out-of-band. Hanya buat perubahan pada sumber daya lingkungan Anda dengan opsi konfigurasi dan [perpanjangan](ebextensions.md) yang disediakan oleh Elastic Beanstalk. Bangun kembali lingkungan Anda atau luncurkan yang baru.
**Peristiwa:** *Kegagalan Peluncuran Instans EC2. Menunggu instans EC2 baru untuk Diluncurkan...*
Ketersediaan untuk tipe instans lingkungan Anda mungkin rendah, atau Anda mungkin telah mencapai kuota instans akun Anda. Periksa [service health dashboard](https://status.aws.amazon.com/) untuk memastikan bahwa layanan Elastic Compute Cloud (Amazon EC2) berwarna hijau, atau [meminta peningkatan kuota](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-ec2-instances).
**Peristiwa:** *Tidak ada contoh yang mengirim data*.
Elastic Beanstalk tidak menerima data kesehatan dari instans Anda. Hal ini dapat disebabkan oleh masalah konektivitas jaringan, masalah agen kesehatan, atau kegagalan tingkat sistem.
+ Verifikasi konektivitas jaringan. Periksa apakah grup keamanan mengizinkan HTTPS keluar (port 443). Untuk instance di subnet pribadi, verifikasi gateway NAT atau titik akhir VPC dikonfigurasi. Periksa tabel rute untuk rute keluar yang benar dan pastikan resolusi DNS berfungsi dengan baik di VPC Anda.
+ Periksa agen pemantauan kesehatan. Lihatlah `/var/log/healthd/daemon.log` kesalahan agen kesehatan dan `/var/log/messages` untuk kesalahan tingkat sistem. Verifikasi layanan healthd berjalan dengan menghubungkan ke instance melalui SSH dan berjalan. `systemctl status healthd`
+ Periksa masalah tingkat sistem seperti kelelahan sumber daya (memori, CPU, ruang disk), sinkronisasi NTP/system jam, dan konektivitas layanan metadata instance.
Untuk detail selengkapnya, [ambil log bundel lengkap](using-features.logging.md) atau [aktifkan streaming CloudWatch log](AWSHowTo.cloudwatchlogs.md). Anda juga dapat menjalankan runbook [https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html](https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-awssupport-troubleshoot-elastic-beanstalk.html)otomatisasi untuk membantu mendiagnosis masalah.
## Lingkungan dengan penyeimbang beban terkonfigurasi dual-stack
**Acara:** *VPC {{vpc\_id}} tidak memiliki blok IPv6 CIDR yang dikonfigurasi. IPv6 Blok CIDR diperlukan untuk penyeimbang beban dualstack. Harap kaitkan blok IPv6 CIDR dengan VPC Anda sebelum menggunakan mode dualstack.*
VPC Anda dan semua subnet harus memiliki blok IPv6 CIDR yang terkait dengannya. Ini adalah salah satu prasyarat VPC yang harus Anda selesaikan sebelum mengonfigurasi penyeimbang beban Anda untuk dukungan dualstack. Untuk informasi lebih lanjut untuk menyelesaikan tugas ini lihat [Prasyarat Amazon VPC](environments-cfg-elbv2-ipv6-dualstack.md#environments-cfg-elbv2-ipv6-dualstack.prereqs) sebelumnya dalam topik ini.
**Peristiwa:** *Satu atau lebih subnet untuk {{vpc\_id}} VPC tidak IPv6 memiliki blok CIDR yang dikonfigurasi. IPv6 Blok CIDR diperlukan untuk subnet yang digunakan dengan penyeimbang beban dualstack. Harap kaitkan blok IPv6 CIDR dengan semua subnet yang diperlukan sebelum menggunakan mode dualstack.*
Semua subnet untuk VPC Anda harus IPv6 memiliki blok CIDR yang terkait dengannya. Ini adalah salah satu prasyarat VPC yang harus Anda selesaikan sebelum mengonfigurasi penyeimbang beban Anda untuk dukungan dualstack. Untuk informasi lebih lanjut untuk menyelesaikan tugas ini lihat [Prasyarat Amazon VPC](environments-cfg-elbv2-ipv6-dualstack.md#environments-cfg-elbv2-ipv6-dualstack.prereqs) sebelumnya dalam topik ini.
**Kesalahan: `IpAddressType`** *Opsi ini hanya dapat diterapkan pada lingkungan Elastic Beanstalk yang dikonfigurasi dengan Application Load Balancer atau Network Load Balancer*.
Pesan ini menunjukkan bahwa lingkungan Elastic Beanstalk Anda mungkin merupakan lingkungan instans tunggal atau mungkin menggunakan Classic Load Balancer. Hanya lingkungan yang dikonfigurasi dengan Application Load Balancer atau Network Load Balancer yang dapat dikonfigurasi. `IpAddressType`
## Konfigurasi
**Acara:** *Tumpukan `{{stack_id}}` yang terkait dengan lingkungan `{{environment-ID}}` berada dalam `{{stack-status}}` status*
CloudFormation Tumpukan yang mendasari lingkungan Anda mungkin dalam status *\*\_FAILED*. Status ini harus diperbaiki untuk melanjutkan operasi Elastic Beanstalk di lingkungan Anda. Untuk informasi selengkapnya, lihat [Memulihkan lingkungan Elastic Beanstalk Anda dari keadaan tidak valid](environment-management-invalid-stack.md).
**Peristiwa:** *Anda tidak dapat mengonfigurasi lingkungan Elastic Beanstalk dengan nilai-nilai untuk kedua opsi Target Elastic Load Balancing dan opsi URL Pemeriksaan Kondisi Aplikasi*
Opsi `Target` di namespace `aws:elb:healthcheck` tidak lagi digunakan. Menghapus namespace opsi `Target`) dari lingkungan Anda dan coba perbarui lagi.
**Acara:** *ELB tidak dapat dilampirkan ke beberapa subnet di AZ yang sama*
Pesan ini dapat dilihat jika Anda mencoba untuk memindahkan penyeimbang beban antar subnet di Availability Zone yang sama. Mengubah subnet di penyeimbang beban perlu memindahkannya keluar dari availability zone aslinya dan kemudian kembali ke aslinya dengan subnet yang diinginkan. Selama proses berlangsung, semua instans Anda akan dimigrasikan antara AZs, menyebabkan downtime yang signifikan. Sebagai gantinya, pertimbangkan untuk membuat lingkungan baru dan [lakukan penggantian CNAME](using-features.CNAMESwap.md).
## Mengatasi masalah kontainer Docker
**Peristiwa:** *Gagal menarik gambar Docker: terbaru: Nama repositori tidak valid (), hanya [a-z0-9-\_.] yang diizinkan. Ekor log untuk detail selengkapnya.*
Periksa sintaks file `dockerrun.aws.json` menggunakan validator JSON. Verifikasi juga konten dockerfile terhadap persyaratan yang dijelaskan di [Mempersiapkan image Docker Anda untuk penyebaran ke Elastic Beanstalk](single-container-docker-configuration.md)
**Peristiwa:** *Tidak ada arahan EXPOSE ditemukan di Dockerfile, batalkan deployment*
`Dockerfile` atau file `dockerrun.aws.json` tidak menyatakan port kontainer. Gunakan petunjuk `EXPOSE` (`Dockerfile`) atau blok `Ports` (file `dockerrun.aws.json`) untuk mengekspos port lalu lintas masuk.
**Acara:** *Gagal mengunduh {{repository}} kredensi otentikasi* dari {{bucket name}}
`dockerrun.aws.json`Ini menyediakan bucket and/or S3 key pair EC2 yang tidak valid untuk file tersebut. `.dockercfg` Atau, profil instance tidak memiliki GetObject otorisasi untuk bucket S3. Verifikasi bahwa file `.dockercfg` berisi bucket S3 yang valid dan pasangan kunci EC2. Berikan izin untuk tindakan `s3:GetObject` ke IAM role di profil instans. Untuk detail, lanjutkan ke [Mengelola profil instans Elastic Beanstalk](iam-instanceprofile.md)
**Peristiwa:** *Aktivitas pelaksanaan gagal, karena: PERINGATAN: File konfigurasi autentikasi tidak valid*
File autentikasi Anda (`config.json`) tidak diformat dengan benar. Lihat [Mengautentikasi dengan repositori gambarMenggunakan AWS Secrets Manager](docker-configuration.remote-repo.md)
## Pertanyaan yang Sering Diajukan
**Pertanyaan:** *Bagaimana cara mengubah URL aplikasi saya dari myapp.us-west-2.elasticbeanstalk.com ke www.myapp.com?*
Di server DNS, daftarkan data catatan CNAME, seperti **www.mydomain.com CNAME mydomain.elasticbeanstalk.com**.
**Pertanyaan:** *Bagaimana cara menentukan Availability Zone spesifik untuk aplikasi Elastic Beanstalk saya?*
Anda dapat memilih Availability Zone tertentu dengan menggunakan plugin APIs, CLI, Eclipse, atau Visual Studio. Untuk petunjuk tentang cara menggunakan konsol Elastic Beanstalk untuk menentukan Availability Zone, lihat [Auto Scaling instance lingkungan Elastic Beanstalk Anda](using-features.managing.as.md).
**Pertanyaan:** *Bagaimana cara mengubah tipe instans lingkungan saya?*
Untuk mengubah tipe instans lingkungan Anda, lanjutkan ke halaman konfigurasi lingkungan dan pilih **Edit** di kategori konfigurasi **Instans**. Kemudian, pilih tipe instans baru dan pilih **Terapkan** untuk memperbarui lingkungan Anda. Setelah ini, Elastic Beanstalk mengakhiri semua instans berjalan dan menggantikannya dengan yang baru.
**Pertanyaan:** *Bagaimana cara menentukan apakah ada yang membuat perubahan konfigurasi ke lingkungan?*
Untuk melihat informasi ini, di panel navigasi konsol Elastic Beanstalk, pilih **Riwayat perubahan** untuk menampilkan daftar perubahan konfigurasi untuk semua lingkungan. Daftar ini mencakup tanggal dan waktu perubahan, parameter konfigurasi dan nilai yang diubah, dan pengguna IAM yang membuat perubahan. Untuk informasi selengkapnya, lihat [Riwayat perubahan](using-features.changehistory.md).
**Pertanyaan:** *Dapatkah saya mencegah volume Amazon EBS dihapus ketika instans diakhiri?*
Instans di lingkungan Anda menggunakan Amazon EBS untuk penyimpanan; namun, volume akar dihapus ketika instans diakhiri oleh Auto Scaling. Kami tidak merekomendasikan Anda menyimpan status atau data lain di instans Anda. Jika diperlukan, Anda dapat mencegah volume dihapus dengan AWS CLI: `$ aws ec2 modify-instance-attribute -b '/dev/sdc=:false` seperti yang dijelaskan dalam [AWS CLI Referensi](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html).
**Pertanyaan:** *Bagaimana cara menghapus informasi pribadi dari aplikasi Elastic Beanstalk saya?*
AWS sumber daya yang digunakan aplikasi Elastic Beanstalk Anda mungkin menyimpan informasi pribadi. Ketika Anda mengakhiri lingkungan Anda, Elastic Beanstalk mengakhiri semua sumber daya yang dibuatnya. Sumber daya yang Anda tambahkan menggunakan [file konfigurasi](ebextensions.md) juga diakhiri. Namun, jika Anda membuat AWS sumber daya di luar lingkungan Elastic Beanstalk dan menghubungkannya dengan aplikasi Anda, Anda mungkin perlu memeriksa secara manual bahwa informasi pribadi yang mungkin disimpan aplikasi Anda tidak disimpan. Sepanjang panduan developer ini, setiap kali kita membahas pembuatan sumber daya tambahan, kami juga menyebutkan kapan Anda harus mempertimbangkan untuk menghapusnya.
## Kesalahan Umum
Topik ini berisi daftar pesan kesalahan umum yang ditemui saat menggunakan EB CLI dan solusi yang memungkinkan. Jika Anda mengalami pesan kesalahan yang tidak ditampilkan di sini, gunakan tautan *Umpan Balik* untuk memberi tahu kami tentang hal itu.
**ERROR: Terjadi kesalahan saat menangani perintah git. Kode kesalahan: Kesalahan 128: fatal: Bukan nama objek valid HEAD**
**Penyebab:** Pesan kesalahan ini ditampilkan ketika Anda telah menginisialisasi repositori Git tetapi belum berkomitmen. EB CLI mencari revisi HEAD ketika folder proyek Anda berisi repositori Git.
**Solusi:** tambahkan file di folder proyek Anda ke area persiapan dan lakukan:
```
~/my-app$ git add .
~/my-app$ git commit -m "First commit"
```
**KESALAHAN: Cabang ini tidak memiliki lingkungan default. Anda harus menentukan lingkungan dengan mengetikkan “status eb my-env-name" atau mengatur lingkungan default dengan mengetik “eb use my-env-name”.**
**Penyebab:** Ketika Anda membuat cabang baru di git, itu tidak terlampir ke lingkungan Elastic Beanstalk secara default.
**Solusi:** Jalankan **eb list** untuk melihat daftar lingkungan yang tersedia. Kemudian jalankan **eb use {{env-name}}** untuk menggunakan salah satu lingkungan yang tersedia.
**EROR: 2.0\+ Platform memerlukan peran layanan. Anda dapat memberikan satu dengan --opsi peran layanan**
**Penyebab:** Jika Anda menentukan nama lingkungan dengan **eb create** (misalnya, **eb create my-env**), EB CLI tidak akan mencoba membuat peran layanan untuk Anda. Jika Anda tidak memiliki peran layanan default, kesalahan di atas akan ditampilkan.
**Solusi:** Jalankan **eb create** tanpa nama lingkungan dan ikuti prompt untuk membuat peran layanan default.
## Kesalahan penerapan
Penerapan Elastic Beanstalk Anda mungkin merespons dengan respons 404 (jika aplikasi Anda gagal diluncurkan) atau 500 (jika aplikasi Anda gagal selama runtime). Untuk memecahkan banyak masalah umum, Anda dapat menggunakan EB CLI untuk memeriksa status penerapan Anda, melihat lognya, mendapatkan akses ke instans EC2 Anda dengan SSH, atau untuk membuka AWS halaman Konsol Manajemen untuk lingkungan aplikasi Anda.
**Untuk menggunakan EB CLI untuk membantu memecahkan masalah deployment**
1. Jalankan **eb status** untuk melihat status deployment dan kondisi host EC2 Anda saat ini. Sebagai contoh:
```
$ eb status --verbose
Environment details for: python_eb_app
Application name: python_eb_app
Region: us-west-2
Deployed Version: app-150206_035343
Environment ID: e-wa8u6rrmqy
Platform: 64bit Amazon Linux 2014.09 v1.1.0 running Python 2.7
Tier: WebServer-Standard-
CNAME: python_eb_app.elasticbeanstalk.com
Updated: 2015-02-06 12:00:08.557000+00:00
Status: Ready
Health: Green
Running instances: 1
i-8000528c: InService
```
**catatan**
Menggunakan switch `--verbose` memberikan informasi tentang status instans berjalan Anda. Tanpa itu, **eb status** hanya akan mencetak informasi umum tentang lingkungan Anda.
1. Jalankan **eb health** untuk melihat informasi kondisi tentang lingkungan Anda:
```
$ eb health --refresh
elasticBeanstalkExa-env Degraded 2016-03-28 23:13:20
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 2 0 2 1 0 0 0
instance-id status cause
Overall Degraded Incorrect application version found on 3 out of 5 instances. Expected version "Sample Application" (deployment 1).
i-d581497d Degraded Incorrect application version "v2" (deployment 2). Expected version "Sample Application" (deployment 1).
i-d481497c Degraded Incorrect application version "v2" (deployment 2). Expected version "Sample Application" (deployment 1).
i-136e00c0 Severe Instance ELB health has not been available for 5 minutes.
i-126e00c1 Ok
i-8b2cf575 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10
Overall 646.7 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-dac3f859 167.5 1675 0 0 0 0.003 0.002 0.001 0.001 0.000
i-05013a81 161.2 1612 0 0 0 0.003 0.002 0.001 0.001 0.000
i-04013a80 0.0 - - - - - - - - -
i-3ab524a1 155.9 1559 0 0 0 0.003 0.002 0.001 0.001 0.000
i-bf300d3c 162.1 1621 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait%
i-d581497d t2.micro 1a 25 mins 0.16 0.1 7.0 0.0 1.7 91.0 0.1
i-d481497c t2.micro 1a 25 mins 0.14 0.1 7.2 0.0 1.6 91.1 0.0
i-136e00c0 t2.micro 1b 25 mins 0.0 0.01 0.0 0.0 0.0 99.9 0.1
i-126e00c1 t2.micro 1b 25 mins 0.03 0.08 6.9 0.0 2.1 90.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.05 0.41 6.9 0.0 2.0 90.9 0.0
instance-id status id version ago deployments
i-d581497d Deployed 2 v2 9 mins
i-d481497c Deployed 2 v2 7 mins
i-136e00c0 Failed 2 v2 5 mins
i-126e00c1 Deployed 1 Sample Application 25 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
Contoh di atas menunjukkan lingkungan dengan lima instans yang deployment versi "v2" gagal di instans ketiga. Setelah deployment gagal, versi yang diharapkan diatur ulang ke versi terakhir yang berhasil, yang dalam hal ini adalah "Aplikasi Sampel" dari deployment pertama. Lihat [Menggunakan EB CLI untuk memantau kondisi lingkungan](health-enhanced-ebcli.md) untuk informasi selengkapnya.
1. Jalankan **eb logs** untuk mengunduh dan melihat log yang terkait dengan deployment aplikasi Anda.
```
$ eb logs
```
1. Jalankan **eb ssh** untuk terhubung dengan instans EC2 yang menjalankan aplikasi Anda dan memeriksanya secara langsung. Di instans, aplikasi yang di-deploy dapat ditemukan di direktori `/opt/python/current/app`, dan lingkungan Python Anda akan ditemukan di `/opt/python/run/venv/`.
1. Jalankan **eb console** untuk melihat lingkungan aplikasi Anda di [Konsol Manajemen AWS](https://aws.amazon.com/console/). Anda dapat menggunakan antarmuka web untuk dengan mudah memeriksa berbagai aspek deployment Anda, termasuk konfigurasi, status, peristiwa, log aplikasi Anda. Anda juga dapat mengunduh versi aplikasi saat ini atau sebelumnya yang telah Anda deploy ke server.