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

# Bekerja dengan CodeDeploy agen
<a name="codedeploy-agent"></a>

 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.8.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 ECS atau Lambda AWS . 

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, lihat[CodeDeploy referensi konfigurasi agen](reference-agent-configuration.md).

Untuk informasi selengkapnya tentang bekerja dengan CodeDeploy agen, seperti langkah-langkah untuk menginstal, memperbarui, dan memverifikasi versi, lihat[Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md).

**Topics**
+ [Sistem operasi yang didukung oleh CodeDeploy agen](#codedeploy-agent-supported-operating-systems)
+ [Protokol komunikasi dan port untuk CodeDeploy agen](#codedeploy-agent-outbound-port)
+ [Riwayat versi CodeDeploy agen](#codedeploy-agent-version-history)
+ [Mengelola CodeDeploy proses](#codedeploy-agent-processes)
+ [Revisi aplikasi dan pembersihan file log](#codedeploy-agent-revisions-logs-cleanup)
+ [File yang diinstal oleh CodeDeploy agen](#codedeploy-agent-install-files)
+ [Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md)

## Sistem operasi yang didukung oleh CodeDeploy agen
<a name="codedeploy-agent-supported-operating-systems"></a>

### Sistem operasi Amazon EC2 AMI yang didukung
<a name="codedeploy-agent-supported-operating-systems-ec2"></a>

 CodeDeploy Agen telah diuji pada sistem operasi Amazon EC2 AMI 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.04 LTS, 20.04 LTS, 18.04 LTS, 16.04 LTS

 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](https://github.com/aws/aws-codedeploy-agent) di. GitHub

### Sistem operasi lokal yang didukung
<a name="codedeploy-agent-supported-operating-systems-on-premises"></a>

 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.04 LTS, 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](https://github.com/aws/aws-codedeploy-agent) di. GitHub

## Protokol komunikasi dan port untuk CodeDeploy agen
<a name="codedeploy-agent-outbound-port"></a>

 CodeDeploy Agen berkomunikasi keluar menggunakan HTTPS melalui port 443.

Ketika CodeDeploy agen berjalan pada instans EC2, ia akan menggunakan titik akhir [metadata EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) untuk mengambil informasi terkait instance. Cari tahu lebih lanjut tentang [membatasi dan memberikan akses layanan metadata instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access).

## Riwayat versi CodeDeploy agen
<a name="codedeploy-agent-version-history"></a>

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 Support. Untuk informasi peningkatan, lihat[Perbarui CodeDeploy agen](codedeploy-agent-operations-update.md).

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


| Versi | Tanggal rilis | Detail | 
| --- | --- | --- | 
| 1.8.1 | Februari 3, 2026 | **Tetap**: S3 endpoint perbaikan bug.<br />**Ditambahkan**: Sertifikat Sectigo CA ke daftar Windows CA. | 
| 1.8.0 | Juli 31, 2025 | **Berubah**: Upgrade Ruby yang dibundel ke 3.2 di CodeDeploy agen untuk Windows. | 
| 1.7.1 | November 14, 2024 | **Berubah**: Dependensi yang diperbarui untuk patch keamanan. | 
| 1.7.0 | 6 Maret 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html).<br />**Ditambahkan**: Support untuk sistem operasi Red Hat Enterprise Linux 9 (RHEL 9).<br />**Ditambahkan**: Support untuk Ruby versi 3.1 dan 3.2 pada Ubuntu Server.<br />**Tetap**: CodeDeploy Agen sekarang menghasilkan kesalahan yang mudah digunakan jika file konfigurasi CodeDeploy agen gagal dimuat.<br />**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.<br />**Ditambahkan**: Support untuk Amazon Linux 2023.<br />**Ditambahkan**: Support untuk Windows Server 2022.<br />**Berubah**: Pengaturan default `verbose` sekarang `false` untuk instance Windows Server. Untuk terus mencetak pesan debug dalam file log di Windows, Anda harus mengatur `verbose` ke`true`.<br />**Dihapus**: Support untuk Windows Server 2016 dan Windows Server 2012 R2.<br />**Dihapus**: Support untuk Amazon Linux 2018.03.x. | 
| 1.5.0 | 3 Maret 2023 | **Ditambahkan**: Support untuk Ruby 3.<br />**Ditambahkan**: Support untuk Ubuntu 22.04.<br />**Tetap**: Masalah saat memulai ulang CodeDeploy agen segera setelah startup akan menyebabkan agen menggantung.<br />**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.<br />**Pemberitahuan penghentian**: CodeDeploy agen 1.5.0 adalah rilis terakhir untuk mendukung Windows Server 2016 dan Windows Server 2012 R2.<br />**Dihapus:** Support 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.<br />**Peningkatan: Peningkatan** logging saat polling untuk perintah host. | 
| 1.4.0 | 31 Agustus 2022 | **Ditambahkan**: Support untuk Red Hat Enterprise Linux 8. <br />**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”](troubleshooting-deployments.md#troubleshooting-long-file-paths).<br />**Tetap**: Masalah dengan operasi unzip saat disk penuh. CodeDeploy Agen sekarang mendeteksi [kode keluar unzip 50](https://linux.die.net/man/1/unzip) 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.<br />**Tetap**: Masalah yang akan menyebabkan agen gagal.<br />**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. <br />**Berubah**: `update` Skrip dari `bin` direktori CodeDeploy agen telah dihapus karena tidak lagi digunakan.<br />**Berubah**: CodeDeploy Agen untuk Windows Server sekarang bundel Ruby 2.7.<br />**Berubah**: Variabel lingkungan baru ditambahkan, untuk digunakan oleh skrip hook tergantung pada sumber bundel penerapan (Amazon GitHub S3 atau). <br />Untuk informasi selengkapnya, lihat [Ketersediaan variabel lingkungan untuk kait](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Pemberitahuan penghentian**: CodeDeploy agent 1.4.0 adalah rilis terakhir yang akan menyertakan installer untuk Windows Server 32-bit. <br />**Pemberitahuan penghentian**: CodeDeploy agen 1.4.0 adalah rilis terakhir yang akan mendukung Windows Server 2008 R2. <br />**Dihapus**: Support untuk CodeDeploy agen di Amazon EC2 berikut: AMIs Amazon Linux 2014.09, 2016.03, 2016.09, dan 2017.03.  | 
| 1.3.2 | 6 Mei 2021 |  CodeDeploy agen 1.3.2 alamat [CVE-2018-1000201](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) yang memengaruhi 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 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html). <br />**Tetap**: Masalah saat menginstal CodeDeploy agen di Ubuntu 20.04 dan yang lebih baru.<br />**Tetap**: Masalah intermiten yang terjadi saat mengekstrak file terkompresi karena jalur relatif tidak ditangani dengan benar.<br />**Ditambahkan**: Support untuk [AWS PrivateLink dan titik akhir VPC untuk instance Windows](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html).<br />**Ditambahkan**: perbaikan AppSpec file, seperti dijelaskan di bawah ini.[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/codedeploy-agent.html)<br />**Upgrade**: CodeDeploy sekarang menggunakan AWS SDK for Ruby 3.0. | 
| 1.3.1 | 22 Desember 2020 | **Diperbaiki**: Masalah 1.3.0 yang mencegah instance lokal dimulai. | 
| 1.3.0 | 10 November 2020 |  Versi ini sudah usang. **Tetap**: Menghapus sertifikat kedaluwarsa yang tidak lagi digunakan.<br />**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 untuk Ruby Ketergantungan yang ditingkatkan dari v2 ke v3.<br />**Ditambahkan**: Support untuk IMDSv2. Termasuk fallback senyap ke IMDSv1 jika permintaan IMDSv2 http gagal.<br />**Berubah**: Diperbarui dependensi Rake dan Rubyzip untuk patch keamanan.<br />**Tetap**: Pastikan bahwa file PID kosong akan mengembalikan status `No CodeDeploy Agent Running` dan membersihkan file PID pada agen mulai. | 
| 1.1.2 | 4 Agustus 2020 | **Ditambahkan**: Support untuk Ubuntu Server 19.10 dan 20.04.<br />**Catatan**:: Versi 19.10 mencapai end-of-life tanggalnya dan tidak lagi didukung oleh Ubuntu atau CodeDeploy.<br />**Ditambahkan**: Peningkatan efisiensi memori untuk Linux dan Ubuntu untuk merilis memori cadangan lebih tepat waktu.<br />**Ditambahkan**: Kompatibilitas dengan Windows Server “silent-cleanup” yang menyebabkan agen menjadi tidak responsif dalam beberapa kasus.<br />**Ditambahkan**: Abaikan direktori yang tidak kosong selama pembersihan untuk menghindari kegagalan pada penerapan.<br />**Ditambahkan**: Support untuk Zona AWS Lokal di Los Angeles (LA).<br />**Ditambahkan**: Ekstrak AZ dari metadata instance untuk menyediakan kompatibilitas untuk AWS Local Zones.<br />**Ditambahkan**: Pengguna sekarang dapat menyediakan arsip mereka di subdirektori dan tidak diharuskan untuk menyimpannya di direktori root.<br />**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.<br />**Ditambahkan**: `:enable_auth_policy:` sebagai pengaturan konfigurasi agen.<br />**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.<br />**Ditambahkan**: Parameter baru untuk menginstal dan memperbarui perintah untuk memungkinkan instalasi versi agen tertentu dari baris perintah.<br />**Dihapus**: Menghapus CodeDeploy agen Auto Updater untuk Linux dan Ubuntu. Untuk mengonfigurasi pembaruan otomatis CodeDeploy agen, lihat [Menginstal CodeDeploy agen menggunakan AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). | 
| 1.0.1.1597 | 15 November 2018 | **Peningkatan**: CodeDeploy mendukung Ubuntu 18.04.<br />**Peningkatan**: CodeDeploy mendukung Ruby 2.5.<br />**Peningkatan**: CodeDeploy mendukung titik akhir FIPS. Untuk informasi selengkapnya tentang titik akhir FIPS, lihat ikhtisar [FIPS](https://aws.amazon.com/compliance/fips/) 140-2. Untuk titik akhir yang dapat digunakan CodeBuild, lihat [CodeDeploywilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region). | 
| 1.0.1.1518 | 12 Juni 2018 | **Peningkatan**: Memperbaiki masalah yang menyebabkan kesalahan saat CodeDeploy agen ditutup saat menerima permintaan jajak pendapat.<br />**Peningkatan**: Menambahkan fitur pelacakan penerapan yang mencegah CodeDeploy agen ditutup saat penerapan sedang berlangsung.<br />**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.<br />**Peningkatan: Peningkatan** validasi sertifikat untuk mendukung otoritas yang lebih tepercaya.<br />**Peningkatan**: Memperbaiki masalah yang menyebabkan CLI lokal gagal selama penerapan yang menyertakan BeforeInstall peristiwa siklus hidup.<br />**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.<br />**Fitur**: Memperkenalkan fitur baru untuk menguji dan men-debug penerapan 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.<br />**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. <br />**Peningkatan**: Membuat CodeDeploy agen kompatibel dengan versi 2.9.2 dari AWS SDK untuk 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.<br />**Peningkatan**: Memperkenalkan dukungan untuk CodeDeploy agen di Wilayah China (Beijing).<br />**Peningkatan**: Boneka yang diaktifkan untuk berjalan di instance Windows Server saat dipanggil oleh hook peristiwa siklus hidup.<br />**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.<br />**Peningkatan**: Merevisi banyak pesan kesalahan untuk menyertakan penyebab yang lebih spesifik untuk kegagalan penerapan.<br />**Peningkatan**: Memperbaiki masalah yang mencegah CodeDeploy agen mengidentifikasi revisi aplikasi yang benar untuk diterapkan selama beberapa penerapan.<br />**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.<br />**Peningkatan**: Membuat CodeDeploy agen kompatibel dengan versi 2.6.11 dari AWS SDK untuk 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.<br /> CodeDeploy Agen untuk instans Amazon Linux, RHEL, dan Ubuntu Server telah diperbarui dengan perubahan berikut. Untuk instance Windows Server, versi terbaru tetap 1.0.1.998.<br />**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.<br />**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.<br /> CodeDeploy Agen untuk instans Amazon Linux, RHEL, dan Ubuntu Server telah diperbarui dengan perubahan berikut. Untuk instance Windows Server, versi terbaru tetap 1.0.1.998.<br />**Fitur**: Menambahkan dukungan untuk memanggil CodeDeploy agen menggunakan shell bash 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 | 11 Juli 2016 | **Catatan**: Versi ini tidak lagi didukung. Jika Anda menggunakan versi ini, penerapan Anda mungkin gagal.<br />**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.<br />**Fitur**: Memperkenalkan dukungan untuk menjalankan CodeDeploy agen dengan profil pengguna selain *root*.<br />**Peningkatan**: Dukungan tetap untuk menentukan jumlah revisi aplikasi yang Anda ingin CodeDeploy agen arsipkan untuk grup penyebaran.<br />**Peningkatan**: Membuat CodeDeploy agen kompatibel dengan versi 2.3 dari AWS SDK untuk Ruby (aws-sdk-core 2.3). <br />**Peningkatan**: Memperbaiki masalah dengan pengkodean UTF-8 selama penerapan.<br />**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.<br />**Fitur**: Menambahkan dukungan proxy instalasi.<br />**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.<br />**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.<br />**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.<br />**Fitur**: Memperkenalkan dukungan untuk algoritma hash SHA-256. <br />**Fitur**: Memperkenalkan dukungan pelacakan versi dalam `.version` file.<br />**Fitur**: Membuat ID grup penyebaran tersedia melalui penggunaan variabel lingkungan.<br />**Peningkatan**: Menambahkan dukungan untuk memantau log CodeDeploy agen menggunakan [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). | 

Untuk informasi terkait, lihat yang berikut ini:
+ [Tentukan versi CodeDeploy agen](codedeploy-agent-operations-version.md)
+ [Instal CodeDeploy agen](codedeploy-agent-operations-install.md)

Untuk riwayat versi CodeDeploy agen, lihat [repositori Rilis](https://github.com/aws/aws-codedeploy-agent/releases) aktif. GitHub

## Mengelola CodeDeploy proses
<a name="codedeploy-agent-processes"></a>

Semua distribusi Linux dari CodeDeploy agen (rpm dan deb) menggunakan [systemd secara](https://systemd.io/) 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 seperti`sudo 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
<a name="codedeploy-agent-revisions-logs-cleanup"></a>

 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 adalah`codedeploy-agent.{{YYYYMMDD}}.log`.

## File yang diinstal oleh CodeDeploy agen
<a name="codedeploy-agent-install-files"></a>

 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 instans RHEL.

`'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](reference-agent-configuration.md).

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-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html)perintah 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](https://console.aws.amazon.com/codedeploy) atau AWS CLI untuk menemukannya. Untuk informasi selengkapnya, lihat [Lihat CodeDeploy detail penerapan](deployments-view-details.md). 

   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](reference-agent-configuration.md). 
**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 adalah`acde1916-9099-7caf-fd21-012345abcdef-cleanup`. 
  + **[ID Grup Penerapan] -install.json, file JSON** yang dibuat selama penerapan terbaru. Ini berisi perintah yang dijalankan selama penerapan. Contoh nama file adalah`acde1916-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 adalah`acde1916-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 adalah`acde1916-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 bernama`codedeploy-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 namanya`codedeploy-agent.20180103.log`. 
  +  **codedeploy-agent-deployments.log** mengkompilasi isi `scripts.log` file untuk setiap penyebaran. `scripts.log`File-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.