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
- CodeDeploy sumber daya penyebaran didukung hanya di beberapa Wilayah AWS
- Prosedur dalam panduan ini tidak cocok dengan CodeDeploy konsol
- Peran IAM yang diperlukan tidak tersedia
- Menggunakan beberapa editor teks untuk membuat AppSpec file dan skrip shell dapat menyebabkan penerapan gagal
- Menggunakan Finder di macOS untuk menggabungkan revisi aplikasi dapat menyebabkan penerapan gagal
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 key pair EC2 ditentukan? Untuk informasi selengkapnya, lihat Pasangan Kunci EC2 di Panduan Pengguna Amazon EC2.
-
Apakah profil instans IAM yang benar dilampirkan ke instance? Untuk informasi selengkapnya, lihat Konfigurasikan instans Amazon EC2 agar berfungsi CodeDeploy dan Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda.
-
Apakah instance itu ditandai? Untuk informasi selengkapnya, lihat Bekerja dengan tag di konsol di Panduan Pengguna Amazon EC2.
-
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, lihat Tambahkan file spesifikasi aplikasi ke revisi untuk CodeDeploy dan CodeDeploy AppSpec referensi file.
-
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, 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 instans IAM 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
Instans EC2 dan grup Auto Scaling Amazon EC2 yang CodeDeploy digunakan 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 kredensil untuk wilayah tersebut. Akun dan kredensil 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.
Peran IAM yang diperlukan tidak tersedia
Jika Anda mengandalkan profil instans IAM atau peran layanan yang dibuat sebagai bagian dari AWS CloudFormation tumpukan, jika Anda menghapus tumpukan, semua peran IAM juga akan dihapus. Ini mungkin mengapa peran IAM tidak lagi ditampilkan di konsol IAM dan CodeDeploy tidak lagi berfungsi seperti yang diharapkan. Untuk memperbaiki masalah ini, Anda harus secara manual membuat ulang peran IAM yang dihapus.
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 instans RHEL, 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 (
^M
karakter) 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 instans RHEL untuk membuat file skrip shell yang berjalan di Amazon Linux, Ubuntu Server, atau instans RHEL. 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 instance RHEL, 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 ke UNIX atau Mac ke UNIX. 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.