Pemecahan masalah umum - AWS CodeDeploy

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemecahan masalah umum

Daftar periksa pemecahan masalah umum

Anda dapat menggunakan daftar periksa berikut untuk memecahkan masalah penerapan yang gagal.

  1. 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.

  2. Periksa apakah Anda telah mengonfigurasi instance dengan benar:

  3. Periksa pengaturan grup aplikasi dan penyebaran:

  4. Konfirmasikan revisi aplikasi dikonfigurasi dengan benar:

  5. Periksa apakah peran layanan dikonfigurasi dengan benar. Untuk informasi, lihat Langkah 2: Buat peran layanan untuk CodeDeploy.

  6. 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.

  7. 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:

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 (^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 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.