Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemecahan masalah umum
Topik
Daftar periksa pemecahan masalah umum
Anda dapat menggunakan daftar periksa berikut untuk memecahkan masalah penerapan yang gagal.
-
Lihat Lihat CodeDeploy detail penerapan dan View Instance Details untuk menentukan mengapa penerapan gagal. Jika Anda tidak dapat menentukan penyebabnya, tinjau item dalam daftar periksa ini.
-
Periksa apakah Anda telah mengonfigurasi instance dengan benar:
-
Apakah instance diluncurkan dengan EC2 key pair ditentukan? Untuk informasi selengkapnya, lihat Pasangan EC2 Kunci di Panduan EC2 Pengguna Amazon.
-
Apakah profil IAM instance yang benar dilampirkan ke instance? Untuk informasi selengkapnya, silakan lihat Konfigurasikan EC2 instans Amazon agar berfungsi CodeDeploy dan Langkah 4: Buat profil IAM instans untuk EC2 instans Amazon Anda.
-
Apakah instance itu ditandai? Untuk informasi selengkapnya, lihat Bekerja dengan tag di konsol di Panduan EC2 Pengguna Amazon.
-
Apakah CodeDeploy agen diinstal, diperbarui, dan berjalan pada instance? Untuk informasi selengkapnya, lihat Mengelola operasi CodeDeploy agen. Untuk memeriksa versi agen mana yang diinstal, lihatTentukan versi CodeDeploy agen.
-
-
Periksa pengaturan grup aplikasi dan penyebaran:
-
Untuk memeriksa pengaturan aplikasi Anda, lihatLihat detail aplikasi dengan CodeDeploy.
-
Untuk memeriksa setelan grup penerapan, lihatLihat detail grup penerapan dengan CodeDeploy.
-
-
Konfirmasikan revisi aplikasi dikonfigurasi dengan benar:
-
Periksa format AppSpec file Anda. Untuk informasi selengkapnya, silakan lihat Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy dan CodeDeploy AppSpec referensi berkas.
-
Periksa bucket atau GitHub repositori Amazon S3 Anda untuk memverifikasi revisi aplikasi Anda berada di lokasi yang diharapkan.
-
Tinjau detail revisi CodeDeploy aplikasi Anda untuk memastikan bahwa itu terdaftar dengan benar. Untuk informasi, lihat Lihat detail revisi aplikasi dengan CodeDeploy.
-
Jika Anda menerapkan dari Amazon S3, periksa bucket Amazon S3 Anda untuk CodeDeploy memverifikasi izin telah diberikan untuk mengunduh revisi aplikasi. Untuk informasi tentang kebijakan bucket, lihatPrasyarat penyebaran.
-
Jika Anda menerapkan dari GitHub, periksa GitHub repositori Anda untuk memverifikasi CodeDeploy telah diberikan izin untuk mengunduh revisi aplikasi. Untuk informasi selengkapnya, silakan lihat Buat penerapan dengan CodeDeploy dan GitHub otentikasi dengan aplikasi di CodeDeploy.
-
-
Periksa apakah peran layanan dikonfigurasi dengan benar. Untuk informasi, lihat Langkah 2: Buat peran layanan untuk CodeDeploy.
-
Konfirmasikan bahwa Anda mengikuti langkah-langkah Memulai dengan CodeDeploy untuk:
-
Menyediakan pengguna dengan izin yang sesuai.
-
Instal atau tingkatkan dan konfigurasikan file AWS CLI.
-
Buat profil IAM instance dan peran layanan.
Untuk informasi selengkapnya, lihat Identity and access management untuk AWS CodeDeploy.
-
-
Konfirmasikan bahwa Anda menggunakan AWS CLI versi 1.6.1 atau yang lebih baru. Untuk memeriksa versi yang telah Anda instal, hubungiaws --version.
Jika Anda masih tidak dapat memecahkan masalah penerapan yang gagal, tinjau masalah lain dalam topik ini.
CodeDeploy sumber daya penyebaran didukung hanya di beberapa Wilayah AWS
Jika Anda tidak melihat atau tidak dapat mengakses aplikasi, grup penyebaran, instance, atau sumber daya penerapan lainnya dari AWS CLI atau CodeDeploy konsol, pastikan Anda mereferensikan salah satu Wilayah yang terdaftar di Wilayah dan AWS titik akhir di. Referensi Umum AWS
EC2instans dan grup EC2 Auto Scaling Amazon yang digunakan CodeDeploy dalam penerapan harus diluncurkan dan dibuat di salah satu Wilayah ini. AWS
Jika Anda menggunakan AWS CLI, jalankan aws configure perintah dari file AWS CLI. Kemudian Anda dapat melihat dan mengatur AWS Wilayah default Anda.
Jika Anda menggunakan CodeDeploy konsol, pada bilah navigasi, dari pemilih wilayah, pilih salah satu AWS Wilayah yang didukung.
penting
Untuk menggunakan layanan di Wilayah China (Beijing) atau Wilayah China (Ningxia), Anda harus memiliki akun dan kredensional untuk wilayah tersebut. Akun dan kredensional untuk AWS wilayah lain tidak berfungsi untuk Wilayah Beijing dan Ningxia, dan sebaliknya.
Informasi tentang beberapa sumber daya untuk Wilayah China, seperti nama bucket CodeDeploy Resource Kit dan prosedur pemasangan CodeDeploy agen, tidak disertakan dalam edisi Panduan CodeDeploy Pengguna ini.
Untuk informasi selengkapnya:
-
CodeDeploy Panduan Pengguna untuk Wilayah China (versi bahasa Inggris | Versi bahasa
Mandarin )
Prosedur dalam panduan ini tidak cocok dengan CodeDeploy konsol
Prosedur dalam panduan ini ditulis untuk mencerminkan desain konsol baru. Jika Anda menggunakan versi konsol yang lebih lama, banyak konsep dan prosedur dasar dalam panduan ini masih berlaku. Untuk mengakses bantuan di konsol baru, pilih ikon informasi.
IAMPeran yang diperlukan tidak tersedia
Jika Anda mengandalkan profil IAM instans atau peran layanan yang dibuat sebagai bagian dari AWS CloudFormation tumpukan, jika Anda menghapus tumpukan, semua IAM peran juga akan dihapus. Ini mungkin mengapa IAM peran tidak lagi ditampilkan di IAM konsol dan CodeDeploy tidak lagi berfungsi seperti yang diharapkan. Untuk memperbaiki masalah ini, Anda harus membuat ulang IAM peran yang dihapus secara manual.
Menggunakan beberapa editor teks untuk membuat AppSpec file dan skrip shell dapat menyebabkan penerapan gagal
Beberapa editor teks memperkenalkan karakter yang tidak sesuai dan tidak dicetak ke dalam file. Jika Anda menggunakan editor teks untuk membuat atau memodifikasi AppSpec file atau file skrip shell untuk dijalankan di Amazon Linux, Ubuntu Server, atau RHEL instance, maka penerapan apa pun yang bergantung pada file ini mungkin gagal. Saat CodeDeploy menggunakan file-file ini selama penyebaran, keberadaan karakter ini dapat menyebabkan kegagalan validasi hard-to-troubleshoot AppSpec file dan kegagalan eksekusi skrip.
Di CodeDeploy konsol, pada halaman detail acara untuk penerapan, pilih Lihat log. (Atau Anda menggunakan AWS CLI untuk memanggil get-deployment-instanceperintah.) Cari kesalahan sepertiinvalid
character,command not found, ataufile not found.
Untuk mengatasi masalah ini, kami merekomendasikan yang berikut:
-
Jangan gunakan editor teks yang memperkenalkan karakter non-cetak seperti carriage return (
^Mkarakter) ke dalam AppSpec file dan file skrip shell Anda. -
Gunakan editor teks yang menampilkan karakter non-pencetakan seperti carriage return dalam AppSpec file dan file skrip shell Anda, sehingga Anda dapat menemukan dan menghapus semua yang mungkin diperkenalkan. Untuk contoh jenis editor teks ini, cari di internet untuk editor teks yang menunjukkan pengembalian carriage.
-
Gunakan editor teks yang berjalan di Amazon Linux, Ubuntu Server, atau RHEL instance untuk membuat file skrip shell yang berjalan di Amazon Linux, Ubuntu Server, atau RHEL instance. Untuk contoh jenis editor teks ini, cari di internet untuk editor skrip shell Linux.
-
Jika Anda harus menggunakan editor teks di Windows atau macOS untuk membuat file skrip shell agar berjalan di Amazon Linux, Ubuntu Server, atau RHEL instance, gunakan program atau utilitas yang mengonversi teks dalam format Windows atau macOS ke format Unix. Untuk contoh program dan utilitas ini, cari di internet untuk DOS to UNIX atau MacUNIX. Pastikan untuk menguji file skrip shell yang dikonversi pada sistem operasi target.
Menggunakan Finder di macOS untuk menggabungkan revisi aplikasi dapat menyebabkan penerapan gagal
Penerapan mungkin gagal jika Anda menggunakan aplikasi antarmuka pengguna grafis Finder (GUI) di Mac untuk menggabungkan (zip) AppSpec file dan file serta skrip terkait ke dalam file arsip revisi aplikasi (.zip). Ini karena Finder membuat __MACOSX folder perantara dalam file.zip dan menempatkan file komponen ke dalamnya. CodeDeploy tidak dapat menemukan file komponen, sehingga penerapan gagal.
Untuk mengatasi masalah ini, kami sarankan Anda menggunakan perintah AWS CLI to call the push, yang mem-zip file komponen ke dalam struktur yang diharapkan. Atau, Anda dapat menggunakan Terminal alih-alih GUI untuk zip file komponen. Terminal tidak membuat __MACOSX folder perantara.
