View a markdown version of this page

Bekerja dengan CodeDeploy agen - AWS CodeDeploy

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

Bekerja dengan CodeDeploy agen

Status peluncuran versi 2.0.x

Versi 2.0.x dari CodeDeploy agen sedang diluncurkan Wilayah AWS dan mungkin belum tersedia di semua Wilayah. Versi 2.0.0 adalah peningkatan opt-in. Untuk meningkatkan ke versi 2.0.x dari revisi lama, lihat. Instal CodeDeploy agen

AWS CodeDeploy Agen adalah paket perangkat lunak yang, ketika diinstal dan dikonfigurasi pada sebuah instance, memungkinkan instance tersebut untuk digunakan dalam pener CodeDeploy apan.

AWS secara aktif mendukung versi minor terbaru dari CodeDeploy agen. Untuk versi terbaru yang dirilis, lihatRiwayat versi CodeDeploy agen.

catatan

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

File konfigurasi ditempatkan pada instance saat 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, lihatMengel CodeDeploy ola operasi agen.

Sistem operasi yang didukung oleh CodeDeploy agen

Sistem operasi Amazon EC2 AMI yang didukung

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

  • Amazon Linux 2023 (x86_64, aarch64)

  • Amazon Linux 2 (x86_64, aarch64)

  • Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

  • Oracle Linux 8, 9, 10 (x86_64, aarch64)

  • Rocky Linux 9, 10 (x86_64, aarch64)

  • Aliran CentOS 9, 10 (x86_64, aarch64)

  • SLES 15 (x86_64, aarch64)

  • Debian 11, 12, 13 (x86_64, aarch64)

  • Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86_64, aarch64)

  • Windows Server 2016, 2019, 2022, 2025 (x86_64)

catatan

Platform berikut telah diuji pada versi CodeDeploy agen 2.0.x dan yang lebih baru saja: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13, dan Ubuntu Server 24.04, 25.04, 26.04.

CodeDeploy Agen tersedia sebagai open source bagi Anda untuk beradaptasi dengan kebutuhan Anda. Ini dapat digunakan dengan sistem operasi Amazon EC2 AMI 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:

  • Windows Server 2016, 2019, 2022, 2025 (x86_64)

  • Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

  • Oracle Linux 8, 9, 10 (x86_64, aarch64)

  • Rocky Linux 9, 10 (x86_64, aarch64)

  • Aliran CentOS 9, 10 (x86_64, aarch64)

  • SLES 15 (x86_64, aarch64)

  • Debian 11, 12, 13 (x86_64, aarch64)

  • Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86_64, aarch64)

catatan

Platform berikut telah diuji pada versi CodeDeploy agen 2.0.x dan yang lebih baru saja: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13, dan Ubuntu Server 24.04, 25.04, 26.04.

CodeDeploy Agen tersedia sebagai open source bagi Anda untuk beradaptasi dengan kebutuhan Anda. 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 melalui port 443.

Ketika CodeDeploy agen berjalan pada instans EC2, ia akan menggunakan titik akhir metadata EC2 untuk mengambil informasi terkait instans. 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.8.x.

catatan

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

Status peluncuran versi 2.0.x

Versi 2.0.x dari CodeDeploy agen sedang diluncurkan Wilayah AWS dan mungkin belum tersedia di semua Wilayah. Versi 2.0.0 adalah peningkatan opt-in. Untuk meningkatkan ke versi 2.0.x dari revisi lama, lihat. Instal CodeDeploy agen

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

Versi Tanggal rilis Rincian

2.0.1

Agustus 24, 2026

Tet ap: Pada Windows, jalur AppSpec file yang dimulai dengan garis miring terbalik (\) atau dengan lebih dari satu pemisah (misalnya,//my-folder) sekarang diselesaikan di dalam revisi, bukan di root drive.

Untuk contoh source nilai yang didukung, lihatAppSpec Bagian 'file' (EC2/On-Premises hanya penerapan).

2.0.0

Juli 15, 2026

Diubah: CodeDeploy Agen sekarang Rust-based dan dikirimkan sebagai biner asli mandiri tunggal. Ketergantungan runtime Ruby telah dihapus. Ruby tidak lagi diperlukan untuk menginstal atau menjalankan agen. Agen ini kompatibel dengan perilaku dengan versi 1.8.x secara default; file konfigurasi yang ada, AppSpec penanganan, semantik lif-cycle-hook, tata letak on-disk, dan hasil penerapan tidak berubah kecuali disebutkan di bawah ini.

Ditambahkan: Dukungan sistem operasi yang diperluas, termasuk Windows Server 2025, RHEL 10, dan Ubuntu Server 26.04, serta distribusi Linux tambahan dan varian ARM (aarch64). Untuk daftar lengkap platform yang diuji dengan versi ini, lihatSistem operasi yang didukung oleh CodeDeploy agen.

Ditambahkan: Per codedeploy-agent update intah untuk pembaruan mandiri agen sesuai permintaan.

Ditambahkan: Port perintah lokal. Ini adalah antarmuka manajemen TCP opsional yang hanya mendengarkan pada alamat loopback (127.0.0.1) untuk menanyakan status agen dan menyuntikkan perintah secara lokal. Ini dinonaktifkan secara default dan diaktifkan denganenable_command_port.

Diubah: Perintah penerapan lokal sekarangcodedeploy-agent deploy-local. Per codedeploy-local intah tetap tersedia untuk kompatibilitas mundur. Semua opsi perintah dipertahankan, dan jalur lokal, Amazon S3 (s3://), dan sumber GitHub bundel masih didukung.

Diubah: Di Linux, agen dikelola oleh unit systemd asli (codedeploy-agent.service); skrip SysV init.d tidak lagi diinstal. Gunakan systemctl untuk mengelola agen.

Diubah (keamanan): Verifikasi sertifikat TLS selalu diaktifkan, dan dump inti dinonaktifkan secara default.

Ditambahkan: Pengaturan pengerasan opsional yang dapat Anda aktifkan untuk memenuhi persyaratan keamanan Anda sendiri. Setiap pengaturan dimatikan secara default, dan Anda mengaktifkan yang Anda inginkan secara individual. Anda dapat menolak bundel yang berisi tautan simbolik, lintasan jalur, atau izin yang tidak aman; membatasi lingkungan kait peristiwa siklus hidup; dan membatasi izin direktori agen dan file log. Untuk daftar lengkapnya, lihat CodeDeploy referensi konfigurasi agen.

Diubah: Skrip instalasi baris perintah sekarang ditulis dalam Bash (sebelumnya Ruby). Ini membutuhkan salah satu curl atauwget.

Diubah: Skrip instalasi untuk versi 2.0.x diterbitkan di bawah latestv2/ awalan di bucket regionalaws-codedeploy-region-identifier. A latest/ walan terus melayani skrip instal versi 1.8.x.

Diubah: AWS sekarang menerbitkan versi 2.0.x sebagai paket Distributor Manajer AWSCodeDeployAgentV2 Sistem. AWSCodeDeployAgentPaket terus melayani versi 1.8.x.

D ihapus: Pengaturan ssl_verify_peer konfigurasi dan kunci ProcessManager konfigurasi Ruby.

Penting: Tidak ada jalur pembaruan otomatis saat ini dari versi 1.8.x ke 2.0.0. Untuk memutakhirkan ke 2.0.0, instal dengan paket Distributor Manajer AWSCodeDeployAgentV2 Sistem atau jalankan latestv2/install skrip regional secara manual. Untuk petunjuk, lihat Instal CodeDeploy agen.

1.8.1

Februari 3, 2026

Tetap: perbaikan bug titik akhir S3.

Ditambahkan: Sertifikat CA Sectigo ke daftar CA Windows.

1.8.0

Juli 31, 2025

Diubah: Meningkatkan Ruby yang dibundel ke 3.2 di CodeDeploy agen untuk Windows.

1.7.1

14 November 2024

Diubah: Diperbarui dependensi untuk patch keamanan.

1.7.0

Maret 6, 2024

Ditambahkan: :disable_imds_v1: Pengaturan konfigurasi ke file konfigurasi CodeDeploy agen. Gunakan pengaturan ini untuk menonaktifkan fallback ke IMDSv1 saat terjadi kesalahan IMDSv2. Defaultnya false (aktifkan fallback). Untuk informasi selengkapnya, lihat referensi konfigurasi CodeDeploy agen.

Ditambahkan: Dukungan untuk sistem operasi Red Hat Enterprise Linux 9 (RHEL 9).

Ditambahkan: Dukungan untuk Ruby versi 3.1 dan 3.2 di Ubuntu Server.

Tet ap: CodeDeploy Agen sekarang menghasilkan kesalahan yang ramah pengguna jika file konfigurasi CodeDeploy agen gagal dimuat.

Diubah: Ruby ditingkatkan menjadi 2.7.8-1 di CodeDeploy agen untuk Windows.

1.6.0

30 Maret 2023

Ditambahkan: Dukungan untuk Ruby 3.1, 3.2.

Ditambahkan: Dukungan untuk Amazon Linux 2023.

Ditambahkan: Dukungan untuk Windows Server 2022.

Diubah: Pengaturan default verbose sekarang false untuk instance Windows Server. Untuk terus mencetak pesan debug di file log di Windows, Anda harus mengatur verbose ketrue.

D ihapus: Dukungan untuk Windows Server 2016 dan Windows Server 2012 R2.

Dihapus: Dukungan untuk Amazon Linux 2018.03.x.

1.5.0

3 Maret 2023

Ditambahkan: Dukungan untuk Ruby 3.

Ditambahkan: Dukungan untuk Ubuntu 22.04.

Diperbaiki: Masalah di mana memulai ulang CodeDeploy agen segera setelah startup akan menyebabkan agen digantung.

Diubah: CodeDeploy Agen sekarang gagal dalam penerapan host pada startup agen jika layanan agen memulai ulang secara tak terduga saat menjalankan skrip hook. Perbaikan ini memungkinkan Anda menghindari menunggu periode batas waktu 70 menit sebelum mencoba lagi penerapan.

Pemberitahuan penghenti an penggunaan: CodeDeploy agen 1.5.0 adalah rilis terakhir yang mendukung Windows Server 2016 dan Windows Server 2012 R2.

Dih apus: Dukungan untuk CodeDeploy agen di Ubuntu 14.04 LTS, 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 melakukan polling untuk perintah host.

1.4.0

31 Agustus 2022

Ditambahkan: Dukungan untuk Red Hat Enterprise Linux 8.

Ditambahkan: Dukungan 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 memulai ulang agen Anda. Untuk informasi selengkapnya, lihat Jalur file yang panjang menyebabkan kesalahan “Tidak ada file atau direktori seperti itu”.

Tet ap: Masalah dengan operasi unzip saat disk penuh. CodeDeploy Agen sekarang mendeteksi kode keluar unzip 50 yang menunjukkan disk penuh, menghapus file yang diekstraksi sebagian, dan memunculkan pengecualian untuk memposting kegagalan ke CodeDeploy server. Pesan kesalahan terlihat sebagai pesan kesalahan peristiwa siklus hidup, dan penerapan tingkat host akan berhenti tanpa macet atau batas waktu.

Tet ap: Masalah yang akan menyebabkan agen gagal.

Diperbaiki: Masalah saat hook akan habis waktu selama kondisi balapan edge-case. Pengait tanpa skrip sekarang akan berlanjut dan tidak lagi menyebabkan kegagalan atau batas waktu.

Diubah: update Skrip dari bin direktori CodeDeploy agen telah dihapus karena tidak lagi digunakan.

Diubah: CodeDeploy Agen untuk Windows Server sekarang bundel Ruby 2.7.

Diubah: Variabel lingkungan baru ditambahkan, untuk digunakan oleh skrip hook tergantung pada sumber bundel penerapan (Amazon S3 atau GitHub).

Untuk informasi selengkapnya, lihat Ketersediaan variabel lingkungan untuk kait.

penting

Pemberitahuan penghentian: CodeDeploy agen 1.4.0 adalah rilis terakhir yang akan menyertakan installer untuk Windows Server 32-bit.

Pemberitahuan penghenti an: CodeDeploy agen 1.4.0 adalah rilis terakhir yang akan mendukung Windows Server 2008 R2.

Dihapus: Dukungan untuk CodeDeploy agen pada AMI Amazon EC2 berikut: Amazon Linux 2014.09, 2016.03, 2016.09, dan 2017.03.

1.3.2

6 Mei 2021

penting

CodeDeploy alamat agen 1.3.2 CVE-2018-1000201 yang mempengaruhi host Windows yang menjalankan agen. CVE mengutip ruby-ffi, yang merupakan ketergantungan agen. CodeDeploy Jika agen Anda diinstal dengan Amazon EC2 Systems Manager (SSM) dan diatur 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.

Tet ap: Masalah saat menginstal CodeDeploy agen di Ubuntu 20.04 dan yang lebih baru.

Tet ap: Masalah intermiten yang terjadi saat mengekstrak file terkompresi karena jalur relatif tidak ditangani dengan benar.

Ditambahkan: Dukungan untuk AWS PrivateLink dan titik akhir VPC untuk instance Windows.

Ditambahkan: perbaikan AppSpec file, seperti dijelaskan di bawah ini.

  • Anda sekarang dapat menentukan nama file khusus untuk AppSpec file saat membuat penerapan lokal. Untuk informasi selengkapnya, lihat Buat penerapan lokal.

  • AppSpec File sekarang dapat memiliki ekstensi .yaml file.

  • Anda sekarang dapat mengganti file yang digunakan menggunakan file_exists_behavior pengaturan opsional baru dalam AppSpec file. Untuk informasi selengkapnya, lihat AppSpec Bagian 'file' (EC2/On-Premises hanya penerapan).

Up grade: CodeDeploy sekarang menggunakan AWS SDK untuk Ruby 3.0.

1.3.1

22 Desember 2020

Tet ap: Masalah 1.3.0 yang mencegah instans lokal dimulai.

1.3.0

10 November 2020

penting

Versi ini tidak digunakan lagi.

Tet ap: Menghapus sertifikat kedaluwarsa yang tidak lagi digunakan.

Tet ap: Menghapus pesan prompt dari skrip penghapusan agen yang digunakan oleh AWS Systems Manager, sehingga lebih mudah untuk menurunkan versi host atau armada ke versi agen sebelumnya.

1.2.1

23 September 2020

Diubah: Keter AWS SDK untuk Ruby gantungan yang ditingkatkan dari v2 ke v3.

Ditambahkan: Dukungan untuk IMDSv2. Termasuk fallback diam ke IMDSv1 jika permintaan http IMDSv2 gagal.

Diubah: Diperbarui dependensi Rake dan Rubyzip untuk patch keamanan.

Tet ap: Pastikan bahwa file PID kosong akan mengembalikan status No CodeDeploy Agent Running dan membersihkan file PID saat agen mulai.

1.1.2

4 Agustus 2020

Ditambahkan: Dukungan untuk Ubuntu Server 19.10 dan 20.04.

Catatan:: Versi 19.10 mencapai tanggal akhir masa pakainya 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 tidak responsif dalam beberapa kasus.

Ditambahkan: Abaikan direktori yang tidak kosong selama pembersihan untuk menghindari kegagalan pada penerapan.

Ditambahkan: Dukungan untuk Zona AWS Lokal di Los Angeles (LA).

Ditambahkan: Ekstrak AZ dari metadata instance untuk memberikan kompatibilitas untuk AWS Zona Lokal.

Ditambahkan: Pengguna sekarang dapat menyediakan arsip mereka di subdirektori dan tidak diharuskan untuk menyimpannya di direktori root.

Ditambahkan: Mendeteksi masalah dengan Rubyzip yang dapat menyebabkan 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.

Diubah: Peringatan unzip sekarang diabaikan sehingga penerapan akan berlanjut.

1.1.0

30 Juni 2020

Diubah: Pembuatan versi CodeDeploy agen sekarang mengikuti konvensi versi standar Ruby.

Ditambahkan: Parameter baru untuk perintah install dan update untuk memungkinkan instalasi versi agen tertentu dari baris perintah.

D ihapus: Mengh CodeDeploy apus agen Auto Updater untuk Linux dan Ubuntu. Untuk mengonfigurasi pembaruan otomatis CodeDeploy agen, lihat Menginstal CodeDeploy agen menggunakan AWS Systems Manager.

1.0.1597

15 November 2018

Peningkatan: CodeDeploy mendukung Ubuntu 18.04.

Peningkatan: CodeDeploy mendukung Ruby 2.5.

Peningkatan: CodeDeploy mendukung titik akhir FIPS. Untuk informasi selengkapnya tentang titik akhir FIPS, lihat ikhtisar FIPS 140-2. Untuk titik akhir yang dapat digunakan dengan CodeBuild, lihat Wil CodeDeploy ayah dan titik akhir.

1.0.1518

12 Juni 2018

Peningkatan: Memperbaiki masalah yang menyebabkan kesalahan saat CodeDeploy agen ditutup saat menerima permintaan jajak pendapat.

Peningkatan: Menambahkan fitur pelacakan pener CodeDeploy apan yang mencegah agen ditutup saat penerapan sedang berlangsung.

Peningkatan: Peningkatan kinerja saat menghapus file.

1.0.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 CLI lokal gagal selama penerapan yang menyertakan peristiwa BeforeInstall siklus hidup.

Peningkatan: Memperbaiki masalah yang mungkin menyebabkan penerapan aktif gagal saat CodeDeploy agen diperbarui.

1.0.11352

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- EC2/On-Premises debug penerapan pada mesin lokal atau instance tempat CodeDeploy agen diinstal.

1.0.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 terbaru yang berhasil. Opsi penerapan untuk konten yang ada sekarang termasuk mempertahankan konten, mengganti konten, atau gagal penerapan.

Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.9.2 dari AWS SDK untuk Ruby (aws-sdk-core 2.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: Memungkinkan Puppet untuk berjalan pada instans 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 memasukkan 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 untar operasi.

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 untuk Ruby (aws-sdk-core 2.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 instans Amazon Linux, RHEL, dan Ubuntu Server telah diperbarui dengan perubahan berikut. Untuk instans Windows Server, versi terbaru tetap 1.0.1.998.

Peningkatan: Agen sekarang dapat menentukan versi Ruby mana yang diinstal pada 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 instans Amazon Linux, RHEL, dan Ubuntu Server telah diperbarui dengan perubahan berikut. Untuk instans 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: Diaktifkan dukungan untuk semua versi Ruby 2.x di CodeDeploy agen dan CodeDeploy agen updater. A CodeDeploy gen yang diperbarui tidak lagi bergantung pada Ruby 2.0 saja. (Ruby 2.0 masih diperlukan untuk versi deb dan rpm dari peng CodeDeploy instal 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.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 ingin CodeDeploy agen mengarsipkan untuk grup penerapan.

Peningkatan: Membuat CodeDeploy agen kompatibel dengan versi 2.3 dari AWS SDK untuk Ruby (aws-sdk-core 2.3).

Peningkatan: Memperbaiki masalah dengan UTF-8 pengkodean 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.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 ingin CodeDeploy agen mengarsipkan untuk grup penerapan.

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 untuk 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 SHA-256 hash.

Fitur: Memperkenalkan dukungan pelacakan versi dalam .version file.

Fitur: Membuat ID grup penerapan tersedia melalui penggunaan variabel lingkungan.

Peningkatan: Menambahkan dukungan untuk memantau log CodeDeploy agen menggunakan Amazon CloudWatch Logs.

Untuk informasi terkait, lihat berikut ini:

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

Mengelola CodeDeploy proses

CodeDeploy Agen menggunakan systemd untuk mengelola proses agen pada semua distribusi Linux yang didukung.

Untuk versi 2.0.x dan yang lebih baru, agen mengirimkan unit systemd asli () codedeploy-agent.service saja. Tidak ada /etc/init.d/codedeploy-agent naskah. Gunakan systemctl untuk mengelola agen, atau memanggil biner secara langsung denganstart,, stoprestart, atau status subperintah.

Untuk versi 1.8.x dan sebelumnya, distribusi rpm dan deb dikirimkan dengan skrip startup di. /etc/init.d/codedeploy-agent Pada sistem yang mendukung systemd, menggunakan service perintah dapat secara tidak sengaja menjalankan skrip init.d alih-alih mengizinkan systemd untuk mengelola proses. Gunakan systemctl untuk operasi agen untuk menghindari masalah ini.

Untuk mengelola CodeDeploy agen, gunakan systemctl utilitas:

sudo systemctl start codedeploy-agent sudo systemctl stop codedeploy-agent sudo systemctl restart codedeploy-agent sudo systemctl status codedeploy-agent

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: dalam 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 sedang digunakan.

CodeDeploy log: Untuk instans Amazon Linux, Ubuntu Server, dan RHEL, CodeDeploy agen memutar file log di bawah /var/log/aws/codedeploy-agent folder. File log diputar pada 00:00:00 (waktu instans) setiap hari, atau ketika file mencapai 64 MB, mana saja yang lebih dulu. Jika rotasi kedua terjadi pada hari yang sama, agen menambahkan akhiran numerik (misalnya,codedeploy-agent.20260715.1.log). Agen menghapus file log 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 dan lokasi default direktori ini adalah:

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

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

Anda dapat menggunakan pengaturan root_dir dalam file konfigurasi CodeDeploy agen untuk mengkonfigurasi 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 penerapan, dan setiap grup penerapan berisi N jumlah penerapan.

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

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

    Anda dapat menggunakan perintah batch-get-deployments untuk menemukan ID grup penerapan.

  • F older ID penerapan mewakili setiap penerapan dalam grup penerapan. Setiap nama direktori penerapan 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 konten revisi penerapan.

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

    Jika Anda ingin menemukan folder untuk penerapan tetapi tidak mengetahui ID penerapan atau ID grup penerapannya, 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 penerapan adalah lima. Ketika jumlah itu tercapai, penerapan di masa mendatang 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 jumlah yang Anda tentukan.

  • deployment-instrucțiuni berisi empat file teks untuk setiap grup penerapan:

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

    • [ID Grup Deployment] -install.json, file JSON 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_successful_install, file teks yang mencantumkan direktori arsip penerapan terakhir yang berhasil. File ini dibuat ketika CodeDeploy agen telah menyalin semua file dalam aplikasi penerapan ke instance. Ini digunakan oleh CodeDeploy agen selama penerapan berikutnya untuk menentukan mana ApplicationStop dan BeforeInstall skrip yang akan dijalankan. Contoh nama file adalahacde1916-9099-7caf-fd21-012345abcdef_last_successful_install.

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

  • deployment-logs berisi file log berikut:

    • file codedeploy-agent.yyyymmdd.log dibuat untuk setiap hari ada penerapan. Setiap file log berisi informasi tentang penerapan hari itu. File log ini mungkin berguna untuk masalah debugging seperti masalah izin. File log awalnya diberi namacodedeploy-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 penerapan. scripts.logFile terletak di logs subfolder di bawah setiap Deployment ID folder. Entri dalam file ini didahului oleh ID penerapan. Misalnya, "[d-ABCDEF123]LifecycleEvent - BeforeInstall" mungkin ditulis selama penerapan dengan IDd-ABCDEF123. Ketika codedeploy-agent-deployments.log mencapai ukuran maksimumnya, CodeDeploy agen terus menulis ke sana sambil menghapus konten lama.