Bekerja dengan CodeDeploy agen

AWS CodeDeploy Agen adalah paket perangkat lunak yang, ketika diinstal dan dikonfigurasi pada sebuah instance, memungkinkan instance itu digunakan dalam CodeDeploy penerapan.

AWS mendukung versi minor terbaru dari CodeDeploy agen. Saat ini versi minor terbaru adalah 1.7.x.

catatan

CodeDeploy Agen hanya diperlukan jika Anda menerapkan ke platform komputasi EC2 /On-Premise. Agen tidak diperlukan untuk penerapan yang menggunakan platform komputasi Amazon atau ECS AWS Lambda.

File konfigurasi ditempatkan pada instance ketika agen diinstal. File ini digunakan untuk menentukan cara kerja agen. File konfigurasi ini menentukan jalur direktori dan pengaturan lain AWS CodeDeploy untuk digunakan saat berinteraksi dengan instance. Anda dapat mengubah beberapa opsi konfigurasi dalam file. Untuk informasi tentang bekerja dengan file konfigurasi CodeDeploy agen, lihatCodeDeploy referensi konfigurasi agen.

Untuk informasi selengkapnya tentang bekerja dengan CodeDeploy agen, seperti langkah-langkah untuk menginstal, memperbarui, dan memverifikasi versi, lihatMengelola operasi CodeDeploy agen.

Topik

• Sistem operasi yang didukung oleh CodeDeploy agen
• Protokol komunikasi dan port untuk CodeDeploy agen
• Riwayat versi CodeDeploy agen
• Mengelola CodeDeploy proses
• Revisi aplikasi dan pembersihan file log
• File yang diinstal oleh CodeDeploy agen
• Mengelola operasi CodeDeploy agen

Sistem operasi yang didukung oleh CodeDeploy agen

Sistem EC2 AMI operasi Amazon yang didukung

CodeDeploy Agen telah diuji pada sistem EC2 AMI operasi Amazon berikut:

• Amazon Linux 2023 (ARM, x86)

• Amazon Linux 2 (ARM, x86)

• Server Microsoft Windows 2022, 2019

• Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

• Server Ubuntu 22.04LTS, 20.04, 18.04LTS, LTS 16.04 LTS

CodeDeploy Agen tersedia sebagai open source bagi Anda untuk beradaptasi dengan kebutuhan Anda. Ini dapat digunakan dengan sistem EC2 AMI operasi Amazon lainnya. Untuk informasi lebih lanjut, buka repositori CodeDeploy agen di. GitHub

Sistem operasi lokal yang didukung

CodeDeploy Agen telah diuji pada sistem operasi lokal berikut:

• Server Microsoft Windows 2022, 2019

• Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

• Server Ubuntu 22.04LTS, 20.04 LTS

CodeDeploy Agen tersedia sebagai open source bagi Anda untuk beradaptasi dengan kebutuhan Anda. Hal ini dapat digunakan dengan sistem operasi instans lokal lainnya. Untuk informasi lebih lanjut, buka repositori CodeDeploy agen di. GitHub

Protokol komunikasi dan port untuk CodeDeploy agen

CodeDeploy Agen berkomunikasi keluar menggunakan HTTPS lebih dari port 443.

Ketika CodeDeploy agen berjalan pada sebuah EC2 instance, ia akan menggunakan titik akhir EC2metadata untuk mengambil informasi terkait instance. Cari tahu lebih lanjut tentang membatasi dan memberikan akses layanan metadata instans.

Riwayat versi CodeDeploy agen

Instans Anda harus menjalankan versi CodeDeploy agen yang didukung. Versi minimum yang didukung saat ini adalah 1.7.x.

catatan

Kami merekomendasikan menggunakan versi terbaru dari CodeDeploy agen. Jika Anda mengalami masalah, perbarui ke versi terbaru sebelum menghubungi AWS Support. Untuk informasi peningkatan, lihatPerbarui CodeDeploy agen.

Tabel berikut mencantumkan semua rilis CodeDeploy agen dan fitur serta penyempurnaan yang disertakan dengan setiap versi.

Versi	Tanggal rilis	Detail
1.7.0	Maret 6, 2024	Ditambahkan: Pengaturan :disable_imds_v1: konfigurasi ke file konfigurasi CodeDeploy agen. Gunakan pengaturan ini untuk menonaktifkan fallback IMDSv1 saat IMDSv2 terjadi kesalahan. Default ke false (aktifkan fallback). Untuk informasi selengkapnya, lihat referensi konfigurasi CodeDeploy agen. Ditambahkan: Support untuk Red Hat Enterprise Linux 9 (RHEL9) sistem operasi. Ditambahkan: Support untuk Ruby versi 3.1 dan 3.2 pada Ubuntu Server. Tetap: CodeDeploy Agen sekarang menghasilkan kesalahan yang mudah digunakan jika file konfigurasi CodeDeploy agen gagal dimuat. Berubah: Upgrade Ruby ke 2.7.8-1 di agen untuk Windows. CodeDeploy
1.6.0	30 Maret 2023	Ditambahkan: Support untuk Ruby 3.1, 3.2. Ditambahkan: Support untuk Amazon Linux 2023. Ditambahkan: Support untuk Windows Server 2022. Berubah: Pengaturan default verbose sekarang false untuk instance Windows Server. Untuk terus mencetak pesan debug dalam file log di Windows, Anda harus mengatur verbose ketrue. Dihapus: Support untuk Windows Server 2016 dan Windows Server 2012 R2. Dihapus: Support untuk Amazon Linux 2018.03.x.
1.5.0	3 Maret 2023	Ditambahkan: Support untuk Ruby 3. Ditambahkan: Support untuk Ubuntu 22.04. Tetap: Masalah saat memulai ulang CodeDeploy agen segera setelah startup akan menyebabkan agen menggantung. Berubah: CodeDeploy Agen sekarang gagal dalam penerapan host pada startup agen jika layanan agen dimulai ulang secara tidak terduga saat menjalankan skrip hook. Perbaikan ini memungkinkan Anda menghindari menunggu periode batas waktu 70 menit sebelum mencoba kembali penerapan. Pemberitahuan penghentian: CodeDeploy agen 1.5.0 adalah rilis terakhir untuk mendukung Windows Server 2016 dan Windows Server 2012 R2. Dihapus: Support untuk CodeDeploy agen di Ubuntu 14.04LTS, Windows Server 2008 R2, dan Windows Server 2008 R2 32-bit.
1.4.1	6 Desember 2022	Tetap: Kerentanan keamanan terkait dengan logging. Peningkatan: Peningkatan logging saat polling untuk perintah host.
1.4.0	31 Agustus 2022	Ditambahkan: Support untuk Red Hat Enterprise Linux 8. Ditambahkan: Support untuk jalur file panjang pada CodeDeploy agen untuk Windows. Untuk mengaktifkan jalur file yang panjang, Anda harus mengatur kunci registri Windows yang sesuai dan kemudian restart agen Anda. Untuk informasi selengkapnya, lihat Jalur file yang panjang menyebabkan kesalahan “Tidak ada file atau direktori seperti itu”. Tetap: Masalah dengan operasi unzip saat disk penuh. CodeDeploy Agen sekarang mendeteksi kode keluar unzip 50 yang menunjukkan disk penuh, menghapus sebagian file yang diekstraksi, dan memunculkan pengecualian untuk memposting kegagalan ke server. CodeDeploy Pesan kesalahan terlihat sebagai pesan kesalahan peristiwa siklus hidup, dan penerapan tingkat host akan berhenti tanpa macet atau kehabisan waktu. Tetap: Masalah yang akan menyebabkan agen gagal. Tetap: Masalah di mana kait akan habis selama kondisi balapan edge-case. Kait tanpa skrip sekarang akan berlanjut dan tidak lagi menyebabkan kegagalan atau batas waktu. Berubah: update Skrip dari bin direktori CodeDeploy agen telah dihapus karena tidak lagi digunakan. Berubah: CodeDeploy Agen untuk Windows Server sekarang bundel Ruby 2.7. Berubah: Variabel lingkungan baru ditambahkan, untuk digunakan oleh skrip hook tergantung pada sumber bundel penerapan (Amazon GitHub S3 atau). Untuk informasi selengkapnya, lihat Ketersediaan variabel lingkungan untuk kait. penting Pemberitahuan penghentian: CodeDeploy agent 1.4.0 adalah rilis terakhir yang akan menyertakan installer untuk Windows Server 32-bit. Pemberitahuan penghentian: CodeDeploy agen 1.4.0 adalah rilis terakhir yang akan mendukung Windows Server 2008 R2. Dihapus: Support untuk CodeDeploy agen di Amazon berikut EC2AMIs: Amazon Linux 2014.09, 2016.03, 2016.09, dan 2017.03.
1.3.2	6 Mei 2021	penting CodeDeploy agen 1.3.2 alamat CVE-2018-1000201 yang memengaruhi host Windows yang menjalankan agen. CVEMengutip ruby-ffi, yang merupakan ketergantungan agen. CodeDeploy Jika agen Anda diinstal dengan Amazon EC2 Systems Manager (SSM) dan disetel untuk memperbarui secara otomatis, tidak ada tindakan yang diperlukan. Jika tidak, tindakan diperlukan untuk memperbarui agen secara manual. Untuk memutakhirkan agen, ikuti petunjuk di Perbarui CodeDeploy agen di Windows Server. Tetap: Masalah saat menginstal CodeDeploy agen di Ubuntu 20.04 dan yang lebih baru. Tetap: Masalah intermiten yang terjadi saat mengekstrak file terkompresi karena jalur relatif tidak ditangani dengan benar. Ditambahkan: Support untuk AWS PrivateLink dan VPC endpoint untuk instance Windows. Ditambahkan: perbaikan AppSpec file, seperti dijelaskan di bawah ini. Anda sekarang dapat menentukan nama file kustom untuk AppSpec file saat membuat penyebaran lokal. Untuk informasi selengkapnya, lihat Buat penerapan lokal. AppSpec File sekarang dapat memiliki ekstensi .yaml file. Anda sekarang dapat menimpa file yang digunakan menggunakan file_exists_behavior pengaturan opsional baru dalam file. AppSpec Untuk informasi selengkapnya, lihat AppSpec Bagian 'file' (EC2/Hanya penerapan Lokal). Upgrade: CodeDeploy sekarang menggunakan AWS SDK untuk Ruby 3.0.
1.3.1	22 Desember 2020	Diperbaiki: Masalah 1.3.0 yang mencegah instans lokal dimulai.
1.3.0	10 November 2020	penting Versi ini sudah usang. Tetap: Menghapus sertifikat kedaluwarsa yang tidak lagi digunakan. Tetap: Menghapus pesan prompt dari skrip uninstall agen yang digunakan oleh AWS Systems Manager, membuatnya lebih mudah untuk menurunkan versi host atau armada ke versi agen sebelumnya.
1.2.1	23 September 2020	Berubah: AWS SDK for Ruby Ketergantungan yang ditingkatkan dari v2 ke v3. Ditambahkan: Support untukIMDSv2. Termasuk fallback senyap ke IMDSv1 jika permintaan IMDSv2 http gagal. Berubah: Diperbarui dependensi Rake dan Rubyzip untuk patch keamanan. Tetap: Pastikan bahwa PID file kosong akan mengembalikan status No CodeDeploy Agent Running dan membersihkan PID file pada agen mulai.
1.1.2	4 Agustus 2020	Ditambahkan: Support untuk Ubuntu Server 19.10 dan 20.04. Catatan:: Versi 19.10 mencapai end-of-life tanggalnya dan tidak lagi didukung oleh Ubuntu atau CodeDeploy. Ditambahkan: Peningkatan efisiensi memori untuk Linux dan Ubuntu untuk merilis memori cadangan lebih tepat waktu. Ditambahkan: Kompatibilitas dengan Windows Server “silent-cleanup” yang menyebabkan agen menjadi tidak responsif dalam beberapa kasus. Ditambahkan: Abaikan direktori yang tidak kosong selama pembersihan untuk menghindari kegagalan pada penerapan. Ditambahkan: Support untuk Zona AWS Lokal di Los Angeles (LA). Ditambahkan: Ekstrak AZ dari metadata instance untuk menyediakan kompatibilitas untuk AWS Local Zones. Ditambahkan: Pengguna sekarang dapat menyediakan arsip mereka di subdirektori dan tidak diharuskan untuk menyimpannya di direktori root. Ditambahkan: Mendeteksi masalah dengan Rubyzip yang dapat mengakibatkan kebocoran memori. Memperbarui perintah unzip untuk pertama kali mencoba menggunakan utilitas unzip yang diinstal sistem sebelum menggunakan Rubyzip. Ditambahkan: :enable_auth_policy: sebagai pengaturan konfigurasi agen. Berubah: Peringatan unzip sekarang diabaikan sehingga penerapan akan berlanjut.
1.1.0	30 Juni 2020	Berubah: Versi CodeDeploy agen sekarang mengikuti konvensi versi standar Ruby. Ditambahkan: Parameter baru untuk menginstal dan memperbarui perintah untuk memungkinkan instalasi versi agen tertentu dari baris perintah. Dihapus: Menghapus CodeDeploy agen Auto Updater untuk Linux dan Ubuntu. Untuk mengonfigurasi pembaruan otomatis CodeDeploy agen, lihat Menginstal CodeDeploy agen menggunakan AWS Systems Manager.
1.0.1.1597	15 November 2018	Peningkatan: CodeDeploy mendukung Ubuntu 18.04. Peningkatan: CodeDeploy mendukung Ruby 2.5. Peningkatan: CodeDeploy mendukung titik FIPS akhir. Untuk informasi selengkapnya tentang FIPS titik akhir, lihat ikhtisar FIPS140-2. Untuk titik akhir yang dapat digunakan CodeBuild, lihat CodeDeploywilayah dan titik akhir.
1.0.1.1518	Juni 12, 2018	Peningkatan: Memperbaiki masalah yang menyebabkan kesalahan saat CodeDeploy agen ditutup saat menerima permintaan jajak pendapat. Peningkatan: Menambahkan fitur pelacakan penerapan yang mencegah CodeDeploy agen ditutup saat penerapan sedang berlangsung. Peningkatan: Peningkatan kinerja saat menghapus file.
1.0.1.1458	6 Maret 2018	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Peningkatan validasi sertifikat untuk mendukung otoritas yang lebih tepercaya. Peningkatan: Memperbaiki masalah yang menyebabkan lokal CLI gagal selama penerapan yang menyertakan peristiwa siklus BeforeInstall hidup. Peningkatan: Memperbaiki masalah yang mungkin menyebabkan penerapan aktif gagal saat CodeDeploy agen diperbarui.
1.0.1.1352	16 November 2017	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Memperkenalkan fitur baru untuk menguji dan men-debug penyebaran EC2 /On-Premise pada mesin lokal atau instance tempat agen diinstal. CodeDeploy
1.0.1.1106	16 Mei 2017	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Memperkenalkan dukungan baru untuk menangani konten di lokasi target yang bukan bagian dari revisi aplikasi dari penerapan sukses terbaru. Opsi penerapan untuk konten yang ada sekarang mencakup mempertahankan konten, menimpa konten, atau kegagalan penerapan. Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.9.2 dari AWS SDK for Ruby (aws-sdk-core2.9.2).
1.0.1.1095	Maret 29, 2017	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Memperkenalkan dukungan untuk CodeDeploy agen di Wilayah China (Beijing). Peningkatan: Boneka yang diaktifkan untuk berjalan di instance Windows Server saat dipanggil oleh hook peristiwa siklus hidup. Peningkatan: Meningkatkan penanganan untar operasi.
1.0.1.1067	Januari 6, 2017	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Merevisi banyak pesan kesalahan untuk menyertakan penyebab yang lebih spesifik untuk kegagalan penerapan. Peningkatan: Memperbaiki masalah yang mencegah CodeDeploy agen mengidentifikasi revisi aplikasi yang benar untuk diterapkan selama beberapa penerapan. Peningkatan: Mengembalikan penggunaan pushd dan popd sebelum dan sesudah operasi. untar
1.0.1.1045	21 November 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.6.11 dari AWS SDK for Ruby (aws-sdk-core2.6.11).
1.0.1.1037	19 Oktober 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. CodeDeploy Agen untuk Amazon Linux,RHEL, dan instance Server Ubuntu telah diperbarui dengan perubahan berikut. Untuk instance Windows Server, versi terbaru tetap 1.0.1.998. Peningkatan: Agen sekarang dapat menentukan versi Ruby mana yang diinstal pada sebuah instance sehingga dapat memanggil codedeploy-agent skrip menggunakan versi itu.
1.0.1.1011.1	Agustus 17, 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Menghapus perubahan yang diperkenalkan oleh versi 1.0.1.1011 karena masalah dengan dukungan shell. Versi agen ini secara fungsional setara dengan versi 1.0.1.998 yang dirilis pada 11 Juli 2016.
1.0.1.1011	Agustus 15, 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. CodeDeploy Agen untuk Amazon Linux,RHEL, dan instance Server Ubuntu telah diperbarui dengan perubahan berikut. Untuk instance Windows Server, versi terbaru tetap 1.0.1.998. Fitur: Menambahkan dukungan untuk memanggil CodeDeploy agen menggunakan bash shell pada sistem operasi tempat sistem init systemd digunakan. Peningkatan: Dukungan yang diaktifkan untuk semua versi Ruby 2.x di CodeDeploy agen dan pembaru agen. CodeDeploy CodeDeploy Agen yang diperbarui tidak lagi bergantung pada Ruby 2.0 saja. (Ruby 2.0 masih diperlukan untuk versi deb dan rpm dari penginstal CodeDeploy agen.)
1.0.1.998	Juli 11, 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Peningkatan: Dukungan tetap untuk menjalankan CodeDeploy agen dengan profil pengguna selain root. Variabel bernama USER diganti dengan CODEDEPLOY_USER untuk menghindari konflik dengan variabel lingkungan.
1.0.1.966	16 Juni 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Memperkenalkan dukungan untuk menjalankan CodeDeploy agen dengan profil pengguna selain root. Peningkatan: Dukungan tetap untuk menentukan jumlah revisi aplikasi yang Anda ingin CodeDeploy agen arsipkan untuk grup penyebaran. Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.3 dari AWS SDK for Ruby (aws-sdk-core 2.3). Peningkatan: Memperbaiki masalah dengan pengkodean UTF -8 selama penerapan. Peningkatan: Peningkatan akurasi saat mengidentifikasi nama proses.
1.0.1.950	24 Maret 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Menambahkan dukungan proxy instalasi. Peningkatan: Memperbarui skrip instalasi untuk tidak mengunduh CodeDeploy agen jika versi terbaru sudah diinstal.
1.0.1.934	11 Februari 2016	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Memperkenalkan dukungan untuk menentukan jumlah revisi aplikasi yang Anda ingin CodeDeploy agen arsipkan untuk grup penyebaran.
1.0.1.880	Januari 11, 2016	Catatan: Versi ini tidak lagi didukung dan dapat menyebabkan penerapan gagal. Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.2 dari AWS SDK for Ruby (aws-sdk-core 2.2). Versi 2.1.2 masih didukung.
1.0.1.854	17 November 2015	Catatan: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal. Fitur: Memperkenalkan dukungan untuk algoritma hash SHA -256. Fitur: Memperkenalkan dukungan pelacakan versi dalam .version file. Fitur: Membuat ID grup penyebaran tersedia melalui penggunaan variabel lingkungan. Peningkatan: Menambahkan dukungan untuk memantau log CodeDeploy agen menggunakan Amazon CloudWatch Logs.

Untuk informasi terkait, lihat yang berikut ini:

• Tentukan versi CodeDeploy agen

• Instal CodeDeploy agen

Untuk riwayat versi CodeDeploy agen, lihat repositori Rilis aktif. GitHub

Mengelola CodeDeploy proses

Semua distribusi Linux dari CodeDeploy agen (rpm dan deb) menggunakan systemd secara default untuk mengelola proses agen.

Namun, distribusi rpm dan deb dikirimkan dengan skrip startup yang berada di. /etc/init.d/codedeploy-agent Bergantung pada distribusi yang Anda gunakan, saat menggunakan perintah sepertisudo service codedeploy-agent restart, skrip di /etc/init.d dapat dijalankan untuk meluncurkan proses agen alih-alih memungkinkan systemd untuk mengelola proses. Menjalankan skrip di tidak /etc/init.d diinginkan.

Untuk mencegah masalah ini, untuk sistem yang mendukung systemd kami sarankan menggunakan systemctl utilitas untuk operasi agen apa pun alih-alih menggunakan service perintah.

Misalnya, untuk memulai ulang penggunaan CodeDeploy agen sudo systemctl restart codedeploy-agent alih-alih perintah yang setara dengan service utilitas.

Revisi aplikasi dan pembersihan file log

CodeDeploy Agen mengarsipkan revisi dan file log pada instance. CodeDeploy Agen membersihkan artefak ini untuk menghemat ruang disk.

Log penerapan revisi aplikasi: Anda dapat menggunakan opsi:max_revisions: di file konfigurasi agen untuk menentukan jumlah revisi aplikasi yang akan diarsipkan dengan memasukkan bilangan bulat positif apa pun. CodeDeploy juga mengarsipkan file log untuk revisi tersebut. Semua yang lain dihapus, dengan pengecualian file log dari penerapan terakhir yang berhasil. File log itu selalu dipertahankan, bahkan jika jumlah penerapan yang gagal melebihi jumlah revisi yang dipertahankan. Jika tidak ada nilai yang ditentukan, CodeDeploy pertahankan lima revisi terbaru selain revisi yang saat ini diterapkan.

CodeDeploy log: Untuk Amazon Linux, Ubuntu Server, dan RHEL instance, CodeDeploy agen memutar file log di bawah folder/var/log/aws/codedeploy-agent. File log diputar pada 00:00:00 (waktu instance) setiap hari. File log dihapus setelah tujuh hari. Pola penamaan untuk file log yang diputar adalahcodedeploy-agent.YYYYMMDD.log.

File yang diinstal oleh CodeDeploy agen

CodeDeploy Agen menyimpan revisi, riwayat penerapan, dan skrip penerapan di direktori root pada sebuah instance. Nama default dan lokasi direktori ini adalah:

'/opt/codedeploy-agent/deployment-root'untuk Amazon Linux, Ubuntu Server, dan RHEL instans.

'C:\ProgramData\Amazon\CodeDeploy'untuk instance Windows Server.

Anda dapat menggunakan pengaturan root_dir dalam file konfigurasi CodeDeploy agen untuk mengonfigurasi nama dan lokasi direktori. Untuk informasi selengkapnya, lihat CodeDeploy referensi konfigurasi agen.

Berikut ini adalah contoh struktur file dan direktori di bawah direktori root. Struktur mengasumsikan ada N jumlah grup penyebaran, dan setiap grup penyebaran berisi N jumlah penyebaran.

|--deployment-root/
|-- deployment group 1 ID 
|    |-- deployment 1 ID 
|    |    |-- Contents and logs of the deployment's revision
|    |-- deployment 2 ID
|    |    |-- Contents and logs of the deployment's revision
|    |-- deployment N ID
|    |    |-- Contents and logs of the deployment's revision
|-- deployment group 2 ID
|    |-- deployment 1 ID
|    |    |-- bundle.tar
|    |    |-- deployment-archive
|    |    |    | -- contents of the deployment's revision
|    |    |-- logs
|    |    |    | -- scripts.log     
|    |-- deployment 2 ID
|    |    |-- bundle.tar
|    |    |-- deployment-archive
|    |    |    | -- contents of the deployment's revision
|    |    |-- logs
|    |    |    | -- scripts.log     
|    |-- deployment N ID
|    |    |-- bundle.tar
|    |    |-- deployment-archive
|    |    |    | -- contents of the deployment's revision
|    |    |-- logs
|    |    |    | -- scripts.log     
|-- deployment group N ID
|    |-- deployment 1 ID
|    |    |-- Contents and logs of the deployment's revision
|    |-- deployment 2 ID
|    |    |-- Contents and logs of the deployment's revision
|    |-- deployment N ID
|    |    |-- Contents and logs of the deployment's revision
|-- deployment-instructions
|    |-- [deployment group 1 ID]_cleanup
|    |-- [deployment group 2 ID]_cleanup
|    |-- [deployment group N ID]_cleanup
|    |-- [deployment group 1 ID]_install.json
|    |-- [deployment group 2 ID]_install.json
|    |-- [deployment group N ID]_install.json
|    |-- [deployment group 1 ID]_last_successful_install
|    |-- [deployment group 2 ID]_last_successful_install
|    |-- [deployment group N ID]_last_successful_install
|    |-- [deployment group 1 ID]_most_recent_install
|    |-- [deployment group 2 ID]_most_recent_install
|    |-- [deployment group N ID]_most_recent_install
|-- deployment-logs
|    |-- codedeploy-agent-deployments.log

• Folder ID Grup Deployment mewakili setiap grup penyebaran Anda. Nama direktori grup penyebaran adalah ID-nya (misalnya,acde1916-9099-7caf-fd21-012345abcdef). Setiap direktori grup penyebaran berisi satu subdirektori untuk setiap upaya penerapan dalam grup penyebaran tersebut.

  Anda dapat menggunakan batch-get-deploymentsperintah untuk menemukan ID grup penyebaran.

• Folder ID Deployment mewakili setiap penerapan dalam grup penyebaran. Setiap nama direktori penyebaran adalah ID-nya. Setiap folder berisi:

  • bundle.tar, file terkompresi dengan isi revisi penerapan. Gunakan utilitas dekompresi zip jika Anda ingin melihat revisi.

  • deployment-archive, direktori yang berisi isi revisi penyebaran.

  • log, direktori yang berisi scripts.log file. File ini mencantumkan output dari semua skrip yang ditentukan dalam file penyebaran. AppSpec

  Jika Anda ingin menemukan folder untuk penerapan tetapi tidak mengetahui ID penyebaran atau ID grup penyebaran, Anda dapat menggunakan AWS CodeDeploy konsol atau AWS CLI untuk menemukannya. Untuk informasi selengkapnya, lihat Lihat CodeDeploy detail penerapan .

  Jumlah maksimum penerapan default yang dapat diarsipkan dalam grup penyebaran adalah lima. Ketika nomor itu tercapai, penerapan future diarsipkan dan arsip tertua dihapus. Anda dapat menggunakan pengaturan max_revisions dalam file konfigurasi CodeDeploy agen untuk mengubah default. Untuk informasi selengkapnya, lihat CodeDeploy referensi konfigurasi agen.

  catatan

  Jika Anda ingin memulihkan ruang hard disk yang digunakan oleh penerapan yang diarsipkan, perbarui pengaturan max_revisions ke angka rendah, seperti 1 atau 2. Penerapan berikutnya menghapus penerapan yang diarsipkan sehingga jumlahnya sama dengan yang Anda tentukan.

• deployment-instructions berisi empat file teks untuk setiap grup penyebaran:

  • [ID Grup Deployment] -cleanup, file teks dengan versi undo dari setiap perintah yang dijalankan selama penerapan. Contoh nama file adalahacde1916-9099-7caf-fd21-012345abcdef-cleanup.

  • [ID Grup Penerapan] -install.json, JSON file yang dibuat selama penerapan terbaru. Ini berisi perintah yang dijalankan selama penerapan. Contoh nama file adalahacde1916-9099-7caf-fd21-012345abcdef-install.json.

  • [ID Grup Deployment] _last_successfull_install, file teks yang mencantumkan direktori arsip dari penerapan terakhir yang berhasil. File ini dibuat ketika CodeDeploy agen telah menyalin semua file dalam aplikasi penyebaran ke instance. Ini digunakan oleh CodeDeploy agen selama penyebaran berikutnya untuk menentukan BeforeInstall skrip mana ApplicationStop dan yang akan dijalankan. Contoh nama file adalahacde1916-9099-7caf-fd21-012345abcdef_last_successfull_install.

  • [ID Grup Deployment] _most_recent_install, file teks yang mencantumkan nama direktori arsip dari penerapan terbaru. File ini dibuat ketika file dalam penyebaran berhasil diunduh. File [deployment group ID] _last_successfull_install dibuat setelah file ini, ketika file yang diunduh disalin ke tujuan akhir. Contoh nama file adalahacde1916-9099-7caf-fd21-012345abcdef_most_recent_install.

• deployment-logs berisi file log berikut:

  • codedeploy-agent.yyyymmdd.log file dibuat untuk setiap hari ada penyebaran. Setiap file log berisi informasi tentang penerapan hari itu. File log ini mungkin berguna untuk masalah debugging seperti masalah izin. File log awalnya bernamacodedeploy-agent.log. Keesokan harinya, tanggal penerapannya dimasukkan ke dalam nama file. Misalnya, jika hari ini adalah 3 Januari 2018, Anda dapat melihat informasi tentang semua penerapan hari ini di. codedeploy-agent.log Besok, pada 4 Januari 2018, file log diganti namanyacodedeploy-agent.20180103.log.

  • codedeploy-agent-deployments.log mengkompilasi isi scripts.log file untuk setiap penyebaran. scripts.logFile-file tersebut terletak di logs subfolder di bawah setiap Deployment ID folder. Entri dalam file ini didahului oleh ID penyebaran. Misalnya, "[d-ABCDEF123]LifecycleEvent - BeforeInstall" mungkin ditulis selama penerapan dengan ID dari. d-ABCDEF123 Ketika codedeploy-agent-deployments.log mencapai ukuran maksimumnya, CodeDeploy agen terus menulis kepadanya sambil menghapus konten lama.