

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. **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). **Ditambahkan**: Support untuk sistem operasi Red Hat Enterprise Linux 9 (RHEL 9). **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` ke`true`. **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.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 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”](troubleshooting-deployments.md#troubleshooting-long-file-paths). **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. **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](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. **Pemberitahuan penghentian**: CodeDeploy agen 1.4.0 adalah rilis terakhir yang akan mendukung Windows Server 2008 R2. **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).   **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 titik akhir VPC untuk instance Windows](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html). **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) **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. **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. **Ditambahkan**: Support untuk IMDSv2. Termasuk fallback senyap ke IMDSv1 jika permintaan IMDSv2 http gagal. **Berubah**: Diperbarui dependensi Rake dan Rubyzip untuk patch keamanan. **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. **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](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. **Peningkatan**: CodeDeploy mendukung Ruby 2.5. **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. **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 CLI lokal gagal selama penerapan yang menyertakan BeforeInstall peristiwa siklus 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 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. **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 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. **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 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.  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. **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 instans Amazon Linux, RHEL, dan Ubuntu Server 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 | 11 Juli 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 untuk 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 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 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](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\$1revisions:** 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\$1dir** 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\$1revisions** 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\$1revisions** 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] \$1last\$1successfull\$1install**, 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] \$1most\$1recent\$1install**, file teks yang mencantumkan nama direktori arsip dari penerapan terbaru. File ini dibuat ketika file dalam penyebaran berhasil diunduh. File [deployment group ID] \$1last\$1successfull\$1install 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. 

# Mengelola operasi CodeDeploy agen
<a name="codedeploy-agent-operations"></a>

Petunjuk di bagian ini menunjukkan kepada Anda cara menginstal, menghapus, menginstal ulang, atau memperbarui CodeDeploy agen dan cara memverifikasi CodeDeploy agen sedang berjalan.

**Topics**
+ [

# Verifikasi CodeDeploy agen sedang berjalan
](codedeploy-agent-operations-verify.md)
+ [

# Tentukan versi CodeDeploy agen
](codedeploy-agent-operations-version.md)
+ [

# Instal CodeDeploy agen
](codedeploy-agent-operations-install.md)
+ [

# Perbarui CodeDeploy agen
](codedeploy-agent-operations-update.md)
+ [

# Copot instalan agen CodeDeploy
](codedeploy-agent-operations-uninstall.md)
+ [

# Kirim log CodeDeploy agen ke CloudWatch
](codedeploy-agent-operations-cloudwatch-agent.md)

# Verifikasi CodeDeploy agen sedang berjalan
<a name="codedeploy-agent-operations-verify"></a>

Bagian ini menjelaskan perintah untuk dijalankan jika Anda mencurigai CodeDeploy agen telah berhenti berjalan pada sebuah instance.

**Topics**
+ [

## Verifikasi CodeDeploy agen untuk Amazon Linux atau RHEL sedang berjalan
](#codedeploy-agent-operations-verify-linux)
+ [

## Verifikasi CodeDeploy agen untuk Ubuntu Server sedang berjalan
](#codedeploy-agent-operations-verify-ubuntu)
+ [

## Verifikasi CodeDeploy agen untuk Windows Server sedang berjalan
](#codedeploy-agent-operations-verify-windows)

## Verifikasi CodeDeploy agen untuk Amazon Linux atau RHEL sedang berjalan
<a name="codedeploy-agent-operations-verify-linux"></a>

Untuk melihat apakah CodeDeploy agen diinstal dan dijalankan, masuk ke instance, dan jalankan perintah berikut:

```
systemctl status codedeploy-agent
```

Jika perintah mengembalikan kesalahan, CodeDeploy agen tidak diinstal. Instal seperti yang dijelaskan dalam[Instal CodeDeploy agen untuk Amazon Linux atau RHEL](codedeploy-agent-operations-install-linux.md).

Jika CodeDeploy agen diinstal dan berjalan, Anda akan melihat pesan seperti`The AWS CodeDeploy agent is running`.

Jika Anda melihat pesan seperti`error: No AWS CodeDeploy agent running`, mulai layanan dan jalankan dua perintah berikut, satu per satu:

```
systemctl start codedeploy-agent
```

```
systemctl status codedeploy-agent
```

## Verifikasi CodeDeploy agen untuk Ubuntu Server sedang berjalan
<a name="codedeploy-agent-operations-verify-ubuntu"></a>

Untuk melihat apakah CodeDeploy agen diinstal dan dijalankan, masuk ke instance, dan jalankan perintah berikut:

```
systemctl status codedeploy-agent
```

Jika perintah mengembalikan kesalahan, CodeDeploy agen tidak diinstal. Instal seperti yang dijelaskan dalam[Instal CodeDeploy agen untuk Server Ubuntu](codedeploy-agent-operations-install-ubuntu.md).

Jika CodeDeploy agen diinstal dan berjalan, Anda akan melihat pesan seperti`The AWS CodeDeploy agent is running`.

Jika Anda melihat pesan seperti`error: No AWS CodeDeploy agent running`, mulai layanan dan jalankan dua perintah berikut, satu per satu:

```
systemctl start codedeploy-agent
```

```
systemctl status codedeploy-agent
```

## Verifikasi CodeDeploy agen untuk Windows Server sedang berjalan
<a name="codedeploy-agent-operations-verify-windows"></a>

Untuk melihat apakah CodeDeploy agen diinstal dan dijalankan, masuk ke instance, dan jalankan perintah berikut:

```
powershell.exe -Command Get-Service -Name codedeployagent
```

Anda akan melihat output yang serupa dengan yang berikut:

```
Status   Name               DisplayName
------   ----               -----------
Running codedeployagent    CodeDeploy Host Agent Service
```

Jika perintah mengembalikan kesalahan, CodeDeploy agen tidak diinstal. Instal seperti yang dijelaskan dalam[Instal CodeDeploy agen untuk Windows Server](codedeploy-agent-operations-install-windows.md).

Jika `Status` menunjukkan sesuatu selain`Running`, mulai layanan dengan perintah berikut:

```
powershell.exe -Command Start-Service -Name codedeployagent
```

Anda dapat memulai ulang layanan dengan perintah berikut:

```
powershell.exe -Command Restart-Service -Name codedeployagent
```

Anda dapat menghentikan layanan dengan perintah berikut:

```
powershell.exe -Command Stop-Service -Name codedeployagent
```

# Tentukan versi CodeDeploy agen
<a name="codedeploy-agent-operations-version"></a>

Anda dapat menentukan versi CodeDeploy agen yang berjalan pada instance Anda dengan dua cara.

Pertama, dimulai dengan versi 1.0.1.854 CodeDeploy agen, Anda dapat melihat nomor versi dalam `.version` file pada instance. Tabel berikut menunjukkan lokasi dan string versi sampel untuk masing-masing sistem operasi yang didukung.


| Sistem operasi | Lokasi berkas | Contoh string agent\$1version | 
| --- | --- | --- | 
| Amazon Linux dan Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | Offical\$11.0.1.854\$1rpm | 
| Ubuntu Server | /opt/codedeploy-agent/.version | Official\$11.0.1.854\$1deb | 
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | Official\$11.0.1.854\$1MSI | 

Kedua, Anda dapat menjalankan perintah pada sebuah instance untuk menentukan versi CodeDeploy agen.

**Topics**
+ [

## Tentukan versi di Amazon Linux atau RHEL
](#codedeploy-agent-operations-version-linux)
+ [

## Tentukan versi di Server Ubuntu
](#codedeploy-agent-operations-version-ubuntu)
+ [

## Tentukan versi di Windows Server
](#codedeploy-agent-operations-version-windows)

## Tentukan versi di Amazon Linux atau RHEL
<a name="codedeploy-agent-operations-version-linux"></a>

Masuk ke instance dan jalankan perintah berikut:

```
sudo yum info codedeploy-agent
```

## Tentukan versi di Server Ubuntu
<a name="codedeploy-agent-operations-version-ubuntu"></a>

Masuk ke instance dan jalankan perintah berikut:

```
sudo dpkg -s codedeploy-agent
```

## Tentukan versi di Windows Server
<a name="codedeploy-agent-operations-version-windows"></a>

Masuk ke instance dan jalankan perintah berikut:

```
sc qdescription codedeployagent
```

# Instal CodeDeploy agen
<a name="codedeploy-agent-operations-install"></a>

Untuk digunakan CodeDeploy pada instans EC2 atau server lokal, CodeDeploy agen harus diinstal terlebih dahulu. Kami merekomendasikan menginstal dan memperbarui CodeDeploy agen dengan AWS Systems Manager. Untuk informasi selengkapnya tentang Systems Manager, lihat [Apa itu AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Anda dapat mengatur penginstalan dan pembaruan terjadwal CodeDeploy agen dengan Systems Manager di konsol saat membuat grup penerapan.

Anda juga dapat menginstal CodeDeploy agen langsung dari ember S3 dengan baris perintah.

Untuk versi yang disarankan untuk diinstal, lihat[Riwayat versi CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-version-history).

**Topics**
+ [

# Instal CodeDeploy agen menggunakan AWS Systems Manager
](codedeploy-agent-operations-install-ssm.md)
+ [

# Instal CodeDeploy agen menggunakan baris perintah
](codedeploy-agent-operations-install-cli.md)

# Instal CodeDeploy agen menggunakan AWS Systems Manager
<a name="codedeploy-agent-operations-install-ssm"></a>

Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk menginstal CodeDeploy agen ke Amazon EC2 atau instans lokal dengan menggunakan. AWS Systems Manager Anda dapat memilih untuk menginstal versi tertentu atau memilih untuk selalu menginstal versi terbaru dari agen. Untuk informasi lebih lanjut tentang AWS Systems Manager, lihat [Apa itu AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). 

 Menggunakan AWS Systems Manager adalah metode yang disarankan untuk menginstal dan memperbarui CodeDeploy agen. Anda juga dapat menginstal CodeDeploy agen dari ember Amazon S3. Untuk informasi tentang penggunaan tautan unduhan Amazon S3, silakan lihat [Instal CodeDeploy agen menggunakan baris perintah](codedeploy-agent-operations-install-cli.md). 

**Topics**
+ [

## Prasyarat
](#install-codedeploy-agent-prereqs)
+ [

## Instal CodeDeploy agen
](#download-codedeploy-agent-on-EC2-Instance)

## Prasyarat
<a name="install-codedeploy-agent-prereqs"></a>

Ikuti langkah-langkah [Memulai dengan CodeDeploy](getting-started-codedeploy.md) untuk mengatur izin IAM dan. AWS CLI

Jika menginstal CodeDeploy agen di server lokal dengan Systems Manager, Anda harus mendaftarkan server lokal Anda dengan Amazon EC2 Systems Manager. Untuk informasi selengkapnya, lihat [Menyiapkan Systems Manager di lingkungan hybrid](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) di *Panduan AWS Systems Manager Pengguna*.

## Instal CodeDeploy agen
<a name="download-codedeploy-agent-on-EC2-Instance"></a>

Sebelum Anda dapat menggunakan Systems Manager untuk menginstal CodeDeploy agen, Anda harus memastikan bahwa instance dikonfigurasi dengan benar untuk Systems Manager.

### Menginstal atau memperbarui agen SSM
<a name="update-SSM-Agent-EC2instance"></a>

Pada instans Amazon EC2, CodeDeploy agen mengharuskan instans menjalankan versi 2.3.274.0 atau yang lebih baru. Sebelum Anda menginstal CodeDeploy agen, perbarui atau instal agen SSM pada instance jika Anda belum melakukannya. 

Agen SSM sudah diinstal sebelumnya di beberapa Amazon AMIs EC2 yang disediakan oleh. AWS Untuk informasi selengkapnya, lihat [Amazon Machine Images (AMIs) dengan agen SSM yang sudah diinstal sebelumnya](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).

**catatan**  
Pastikan bahwa sistem operasi instans juga didukung oleh CodeDeploy agen. Untuk informasi selengkapnya, lihat [Sistem operasi yang didukung oleh CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).

*Untuk informasi tentang menginstal atau memperbarui agen SSM pada instans yang menjalankan Linux, lihat [Menginstal dan mengonfigurasi agen SSM di instance Linux di](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) Panduan Pengguna.AWS Systems Manager *

*Untuk informasi tentang menginstal atau memperbarui agen SSM pada instans yang menjalankan Windows Server, lihat [Menginstal dan mengonfigurasi agen SSM pada instans Windows di](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) Panduan Pengguna.AWS Systems Manager *

### (Opsional) Verifikasikan Prasyarat Manajer Sistem
<a name="install-codedeploy-agent-minimum-requirements"></a>

Sebelum Anda menggunakan Systems Manager Run Command untuk menginstal CodeDeploy agen, verifikasi bahwa instans Anda memenuhi persyaratan minimum Systems Manager. Untuk informasi selengkapnya, lihat [Menyiapkan AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) di *Panduan AWS Systems Manager Pengguna*.

### Instal CodeDeploy agen
<a name="install-codedeploy-agent-EC2"></a>

Dengan SSM, Anda dapat menginstal CodeDeploy sekali atau mengatur jadwal untuk menginstal versi baru.

 Untuk menginstal CodeDeploy agen, pilih `AWSCodeDeployAgent` paket saat Anda mengikuti langkah-langkah di [Instal atau perbarui paket dengan AWS Systems Manager distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html). 

# Instal CodeDeploy agen menggunakan baris perintah
<a name="codedeploy-agent-operations-install-cli"></a>

**catatan**  
Kami merekomendasikan untuk menginstal CodeDeploy agen AWS Systems Manager untuk dapat mengonfigurasi pembaruan agen yang dijadwalkan. Untuk informasi selengkapnya, lihat [Instal CodeDeploy agen menggunakan AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

Gunakan topik berikut untuk menginstal dan menjalankan CodeDeploy agen menggunakan baris perintah.

**Topics**
+ [

# Instal CodeDeploy agen untuk Amazon Linux atau RHEL
](codedeploy-agent-operations-install-linux.md)
+ [

# Instal CodeDeploy agen untuk Server Ubuntu
](codedeploy-agent-operations-install-ubuntu.md)
+ [

# Instal CodeDeploy agen untuk Windows Server
](codedeploy-agent-operations-install-windows.md)

# Instal CodeDeploy agen untuk Amazon Linux atau RHEL
<a name="codedeploy-agent-operations-install-linux"></a>

Masuk ke instance, dan jalankan perintah berikut, satu per satu. Menjalankan perintah `sudo yum update` terlebih dahulu dianggap sebagai praktik terbaik saat menggunakan `yum` untuk menginstal paket, tetapi Anda dapat melewatinya jika Anda tidak ingin memperbarui semua paket Anda.

```
sudo yum update
```

```
sudo yum install ruby
```

```
sudo yum install wget
```

(Opsional) Untuk membersihkan AMI dari informasi caching agen sebelumnya, jalankan skrip berikut:

```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```

Ubah ke direktori home Anda:

```
cd /home/ec2-user
```

**catatan**  
Pada perintah sebelumnya, `/home/ec2-user` mewakili nama pengguna default untuk instans Amazon Linux atau RHEL Amazon EC2. Jika instans Anda dibuat menggunakan AMI kustom, pemilik AMI mungkin telah menetapkan nama pengguna default yang berbeda. 

Unduh penginstal CodeDeploy agen:

```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```

*bucket-name*adalah nama bucket Amazon S3 yang berisi file CodeDeploy Resource Kit untuk wilayah Anda, dan *region-identifier* merupakan pengenal untuk wilayah Anda.

Contoh:

`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

Untuk daftar nama bucket dan pengenal wilayah, lihat[Nama bucket kit sumber daya menurut Wilayah](resource-kit.md#resource-kit-bucket-names).

Mengatur izin eksekusi pada `install` file:

```
chmod +x ./install
```

Untuk menginstal versi terbaru dari CodeDeploy agen:
+ 

  ```
  sudo ./install auto
  ```

Untuk menginstal versi CodeDeploy agen tertentu:
+ Buat daftar versi yang tersedia di wilayah Anda:

  ```
  aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
  ```
+ Instal salah satu versi:

  ```
  sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
  ```
**catatan**  
AWS mendukung versi minor terbaru dari CodeDeploy agen. Saat ini versi minor terbaru adalah 1.7.x.

Untuk memeriksa apakah layanan sedang berjalan, jalankan perintah berikut:

```
systemctl status codedeploy-agent
```

Jika CodeDeploy agen diinstal dan berjalan, Anda akan melihat pesan seperti`The AWS CodeDeploy agent is running`.

Jika Anda melihat pesan seperti`error: No AWS CodeDeploy agent running`, mulai layanan dan jalankan dua perintah berikut, satu per satu:

```
systemctl start codedeploy-agent
```

```
systemctl status codedeploy-agent
```

# Instal CodeDeploy agen untuk Server Ubuntu
<a name="codedeploy-agent-operations-install-ubuntu"></a>

**catatan**  
Kami merekomendasikan untuk menginstal CodeDeploy agen AWS Systems Manager untuk dapat mengonfigurasi pembaruan agen yang dijadwalkan. Untuk informasi selengkapnya, lihat [Instal CodeDeploy agen menggunakan AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

**Untuk menginstal CodeDeploy agen di Server Ubuntu**

1. Masuk ke instance.

1. Masukkan perintah berikut, satu demi satu:

   ```
   sudo apt update
   ```

   ```
   sudo apt install ruby-full
   ```

   ```
   sudo apt install wget
   ```

1. Masukkan perintah berikut:

   ```
   cd /home/ubuntu
   ```

   */home/ubuntu*mewakili nama pengguna default untuk instance Server Ubuntu. Jika instans Anda dibuat menggunakan AMI kustom, pemilik AMI mungkin telah menetapkan nama pengguna default yang berbeda. 

1. Masukkan perintah berikut:

   ```
   wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
   ```

   *bucket-name*adalah nama bucket Amazon S3 yang berisi file CodeDeploy Resource Kit untuk wilayah Anda, dan *region-identifier* merupakan pengenal untuk wilayah Anda.

   Contoh:

   `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

   Untuk daftar nama bucket dan pengenal wilayah, lihat[Nama bucket kit sumber daya menurut Wilayah](resource-kit.md#resource-kit-bucket-names).

1. Masukkan perintah berikut:

   ```
   chmod +x ./install
   ```

1. Lakukan salah satu tindakan berikut:
   + Untuk menginstal versi terbaru CodeDeploy agen pada versi Ubuntu Server yang didukung *kecuali* 20.04:

     ```
     sudo ./install auto
     ```
   + Untuk menginstal versi terbaru dari CodeDeploy agen di Ubuntu Server 20.04:
**catatan**  
Menulis output ke file log sementara adalah solusi yang harus digunakan saat kami mengatasi bug yang diketahui dengan `install` skrip di Ubuntu Server 20.04.

     ```
     sudo ./install auto > /tmp/logfile
     ```
   + Untuk menginstal versi CodeDeploy agen tertentu pada versi Ubuntu Server yang didukung *kecuali* 20.04:
     + Buat daftar versi yang tersedia di wilayah Anda:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Instal salah satu versi:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb
       ```
**catatan**  
AWS mendukung versi minor terbaru dari CodeDeploy agen. Saat ini versi minor terbaru adalah 1.7.x.
   + Untuk menginstal versi CodeDeploy agen tertentu di Ubuntu Server 20.04:
     + Buat daftar versi yang tersedia di wilayah Anda:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Instal salah satu versi:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
       ```
**catatan**  
Menulis output ke file log sementara adalah solusi yang harus digunakan saat kami mengatasi bug yang diketahui dengan `install` skrip di Ubuntu Server 20.04.
**catatan**  
AWS mendukung versi minor terbaru dari CodeDeploy agen. Saat ini versi minor terbaru adalah 1.7.x.

**Untuk memeriksa apakah layanan sedang berjalan**

1. Masukkan perintah berikut:

   ```
   systemctl status codedeploy-agent
   ```

   Jika CodeDeploy agen diinstal dan berjalan, Anda akan melihat pesan seperti`The AWS CodeDeploy agent is running`.

1. Jika Anda melihat pesan seperti`error: No AWS CodeDeploy agent running`, mulai layanan dan jalankan dua perintah berikut, satu per satu:

   ```
   systemctl start codedeploy-agent
   ```

   ```
   systemctl status codedeploy-agent
   ```

# Instal CodeDeploy agen untuk Windows Server
<a name="codedeploy-agent-operations-install-windows"></a>

Pada instance Windows Server, Anda dapat menggunakan salah satu metode ini untuk mengunduh dan menginstal CodeDeploy agen:
+ Gunakan AWS Systems Manager (disarankan)
+ Jalankan serangkaian PowerShell perintah Windows.
+ Pilih tautan unduhan langsung.
+ Jalankan perintah salin Amazon S3.

**catatan**  
Folder tempat CodeDeploy agen diinstal adalah`C:\Program Data\Amazon\CodeDeploy`. Pastikan tidak ada persimpangan direktori atau symlink di jalur ini.

**Topics**
+ [

## Gunakan Systems Manager
](#codedeploy-agent-operations-install-system-manager)
+ [

## Gunakan Windows PowerShell
](#codedeploy-agent-operations-install-windows-powershell)
+ [

## Gunakan tautan langsung
](#codedeploy-agent-operations-install-windows-direct-link)
+ [

## Gunakan perintah salin Amazon S3
](#codedeploy-agent-operations-install-windows-s3-copy)

## Gunakan Systems Manager
<a name="codedeploy-agent-operations-install-system-manager"></a>

Ikuti instruksi [Instal CodeDeploy agen menggunakan AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) untuk menginstal CodeDeploy agen.

## Gunakan Windows PowerShell
<a name="codedeploy-agent-operations-install-windows-powershell"></a>

Masuk ke instance, dan jalankan perintah berikut di Windows PowerShell:

1.  Mengharuskan semua skrip dan file konfigurasi yang diunduh dari Internet ditandatangani oleh penerbit tepercaya. Jika Anda diminta untuk mengubah kebijakan eksekusi, ketik "**Y**.” 

   ```
    Set-ExecutionPolicy RemoteSigned
   ```

1.  Memuat AWS Tools for Windows PowerShell. 

   ```
   Import-Module AWSPowerShell
   ```

1.  Buat direktori ke tempat file instalasi CodeDeploy agen diunduh. 

   ```
   New-Item -Path "c:\temp" -ItemType "directory" -Force
   ```

1. Konfigurasikan AWS kredensil menggunakan perintah `Set-AWSCredential` and`Initialize-AWSDefaultConfiguration`. Untuk informasi selengkapnya, lihat [Menggunakan AWS kredensil](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) di *AWS alat untuk PowerShell Panduan Pengguna*.

1.  Unduh file instalasi CodeDeploy agen. 
**catatan**  
AWS mendukung versi minor terbaru dari CodeDeploy agen. Saat ini versi minor terbaru adalah 1.7.x.

   Untuk menginstal versi terbaru dari CodeDeploy agen:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
     ```

   Untuk menginstal versi CodeDeploy agen tertentu:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
     ```

   *bucket-name*adalah nama bucket Amazon S3 yang berisi file CodeDeploy Resource Kit untuk wilayah Anda. Misalnya, untuk Wilayah Timur AS (Ohio), ganti *bucket-name* dengan`aws-codedeploy-us-east-2`. Untuk daftar nama bucket, lihat[Nama bucket kit sumber daya menurut Wilayah](resource-kit.md#resource-kit-bucket-names).

1.  Jalankan file instalasi CodeDeploy agen. 

   ```
   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
   ```

Untuk memeriksa apakah layanan sedang berjalan, jalankan perintah berikut:

```
powershell.exe -Command Get-Service -Name codedeployagent
```

 Jika CodeDeploy agen baru saja diinstal dan belum dimulai, maka setelah menjalankan **Get-Service** perintah, di bawah **Status**, Anda akan melihat**Start...**:

```
Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service
```

Jika CodeDeploy agen sudah berjalan, setelah menjalankan **Get-Service** perintah, di bawah **Status**, Anda akan melihat**Running**:

```
Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service
```

## Gunakan tautan langsung
<a name="codedeploy-agent-operations-install-windows-direct-link"></a>

Jika pengaturan keamanan browser pada instance Windows Server memberikan izin (misalnya, ke`https://s3.*.amazonaws.com`), Anda dapat menggunakan tautan langsung untuk Wilayah Anda untuk mengunduh CodeDeploy agen dan kemudian menjalankan penginstal secara manual.

Tautannya adalah:

```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```

... di *region* mana AWS Wilayah tempat Anda menerapkan aplikasi Anda.

Contoh:

```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```

**penting**  
Dapatkan `.msi` file dari Wilayah yang sama dengan CodeDeploy aplikasi Anda. Memilih Wilayah yang berbeda dapat menyebabkan `inconsistent region` kegagalan dalam `codedeploy-agent-log` file saat Anda menjalankan `.msi` file.

## Gunakan perintah salin Amazon S3
<a name="codedeploy-agent-operations-install-windows-s3-copy"></a>

Jika diinstal pada instance, Anda dapat menggunakan perintah Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) untuk mengunduh CodeDeploy agen dan kemudian menjalankan penginstal secara manual. AWS CLI Untuk selengkapnya, lihat [Menginstal AWS Command Line Interface di Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). 

Perintah Amazon S3 adalah:

```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```

... di *region* mana AWS Wilayah tempat Anda menerapkan aplikasi Anda.

Contoh:

```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```

# Perbarui CodeDeploy agen
<a name="codedeploy-agent-operations-update"></a>

Anda dapat mengonfigurasi pembaruan CodeDeploy agen otomatis dan terjadwal pada semua sistem operasi yang didukung menggunakan AWS Systems Manager. Anda juga dapat memaksa pembaruan pada semua sistem operasi yang didukung dengan menjalankan perintah pada sebuah instance.

**Topics**
+ [

# Perbarui CodeDeploy agen di Amazon Linux atau RHEL
](codedeploy-agent-operations-update-linux.md)
+ [

# Perbarui CodeDeploy agen di Server Ubuntu
](codedeploy-agent-operations-update-ubuntu.md)
+ [

# Perbarui CodeDeploy agen di Windows Server
](codedeploy-agent-operations-update-windows.md)

# Perbarui CodeDeploy agen di Amazon Linux atau RHEL
<a name="codedeploy-agent-operations-update-linux"></a>

Untuk mengonfigurasi pembaruan otomatis dan terjadwal dari CodeDeploy agen yang menggunakan AWS Systems Manager, ikuti langkah-langkah di [Instal CodeDeploy agen dengan AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).

Jika Anda ingin memaksa pembaruan CodeDeploy agen, masuk ke instance, dan jalankan perintah berikut:

```
sudo /opt/codedeploy-agent/bin/install auto
```

# Perbarui CodeDeploy agen di Server Ubuntu
<a name="codedeploy-agent-operations-update-ubuntu"></a>

Untuk mengonfigurasi pembaruan otomatis dan terjadwal dari CodeDeploy agen yang menggunakan AWS Systems Manager, ikuti langkah-langkah di [Instal CodeDeploy agen dengan AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).

Jika Anda ingin memaksa pembaruan CodeDeploy agen, masuk ke instance, dan jalankan perintah berikut:

```
sudo /opt/codedeploy-agent/bin/install auto
```

# Perbarui CodeDeploy agen di Windows Server
<a name="codedeploy-agent-operations-update-windows"></a>

Anda dapat mengaktifkan pembaruan otomatis CodeDeploy agen dengan AWS Systems Manager. Dengan Systems Manager, Anda dapat mengonfigurasi jadwal pembaruan untuk Amazon EC2 atau instans lokal dengan membuat asosiasi dengan Manajer Negara Systems Manager. Anda juga dapat memperbarui CodeDeploy agen secara manual dengan menghapus versi saat ini dan menginstal yang lebih baru.

**Topics**
+ [

## Siapkan pembaruan CodeDeploy agen otomatis dengan AWS Systems Manager
](#codedeploy-agent-operations-update-windows-ssm)
+ [

## Perbarui CodeDeploy agen secara manual
](#codedeploy-agent-operations-update-windows-manual)
+ [

## (Usang) Perbarui CodeDeploy agen dengan Windows Server Updater
](#codedeploy-agent-operations-update-windows-updater)

## Siapkan pembaruan CodeDeploy agen otomatis dengan AWS Systems Manager
<a name="codedeploy-agent-operations-update-windows-ssm"></a>

Untuk mengkonfigurasi Systems Manager dan mengaktifkan pembaruan otomatis CodeDeploy agen, ikuti petunjuk di [Instal CodeDeploy agen menggunakan AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).

## Perbarui CodeDeploy agen secara manual
<a name="codedeploy-agent-operations-update-windows-manual"></a>

Untuk memperbarui CodeDeploy agen secara manual, Anda dapat menginstal versi terbaru dari CLI atau menggunakan Systems Manager. Ikuti instruksi di [Instal CodeDeploy agen.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Disarankan agar Anda menghapus versi CodeDeploy agen yang lebih lama dengan mengikuti petunjuk di [Copot pemasangan](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html) agen. CodeDeploy

## (Usang) Perbarui CodeDeploy agen dengan Windows Server Updater
<a name="codedeploy-agent-operations-update-windows-updater"></a>

**catatan**  
Pembaru CodeDeploy agen untuk Windows Server tidak digunakan lagi dan tidak akan memperbarui ke versi apa pun setelah 1.0.1.1597.

Untuk mengaktifkan pembaruan otomatis CodeDeploy agen, instal pembaru CodeDeploy agen untuk Windows Server pada instance baru atau yang sudah ada. Updater memeriksa secara berkala untuk versi baru. Ketika versi baru terdeteksi, updater menghapus instalan versi agen saat ini, jika ada yang diinstal, sebelum menginstal versi terbaru.

Jika penerapan sudah berlangsung saat updater mendeteksi versi baru, penerapan akan terus selesai. Jika penerapan mencoba untuk memulai selama proses pembaruan, penerapan gagal.

Jika Anda ingin memaksa pembaruan CodeDeploy agen, ikuti instruksi di[Instal CodeDeploy agen untuk Windows Server](codedeploy-agent-operations-install-windows.md).

Pada instance Windows Server, Anda dapat mengunduh dan menginstal CodeDeploy agen pembaru dengan menjalankan PowerShell perintah Windows, menggunakan tautan unduhan langsung, atau menjalankan perintah salin Amazon S3.

**Topics**
+ [

### Gunakan Windows PowerShell
](#codedeploy-agent-operations-update-windows-powershell)
+ [

### Gunakan tautan langsung
](#codedeploy-agent-operations-update-windows-direct-link)
+ [

### Gunakan perintah salin Amazon S3
](#codedeploy-agent-operations-update-windows-s3-copy)

### Gunakan Windows PowerShell
<a name="codedeploy-agent-operations-update-windows-powershell"></a>

Masuk ke instance, dan jalankan perintah berikut di Windows PowerShell, satu per satu:

```
Set-ExecutionPolicy RemoteSigned
```

 Jika Anda diminta untuk mengubah kebijakan eksekusi, pilih **Y** agar Windows PowerShell memerlukan semua skrip dan file konfigurasi yang diunduh dari internet ditandatangani oleh penerbit tepercaya. 

```
Import-Module AWSPowerShell
```

```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```

```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```

```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```

```
powershell.exe -Command Get-Service -Name codedeployagent
```

*bucket-name*adalah nama bucket Amazon S3 yang berisi file CodeDeploy Resource Kit untuk wilayah Anda. Misalnya, untuk Wilayah Timur AS (Ohio), ganti *bucket-name* dengan`aws-codedeploy-us-east-2`. Untuk daftar nama bucket, lihat[Nama bucket kit sumber daya menurut Wilayah](resource-kit.md#resource-kit-bucket-names).

Jika Anda perlu memecahkan masalah kesalahan proses pembaruan, ketik perintah berikut untuk membuka file log CodeDeploy pembaru agen:

```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```

### Gunakan tautan langsung
<a name="codedeploy-agent-operations-update-windows-direct-link"></a>

Jika pengaturan keamanan browser pada instance Windows Server memberikan izin yang diperlukan (misalnya, ke ` http://s3.*.amazonaws.com `), Anda dapat menggunakan tautan langsung untuk mengunduh pembaru CodeDeploy agen.

Tautannya adalah:

```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```

... di *region* mana AWS Wilayah tempat Anda memperbarui aplikasi Anda.

Contoh:

```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi
```

### Gunakan perintah salin Amazon S3
<a name="codedeploy-agent-operations-update-windows-s3-copy"></a>

Jika diinstal pada instance, Anda dapat menggunakan perintah Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) untuk mengunduh CodeDeploy agen pembaru dan kemudian menjalankan penginstal secara manual. AWS CLI Untuk selengkapnya, lihat [Menginstal AWS Command Line Interface di Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). 

Perintah Amazon S3 adalah:

```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region
```

... di *region* mana AWS Wilayah tempat Anda memperbarui aplikasi Anda.

Contoh:

```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```

# Copot instalan agen CodeDeploy
<a name="codedeploy-agent-operations-uninstall"></a>

Anda dapat menghapus CodeDeploy agen dari contoh ketika tidak lagi diperlukan atau ketika Anda ingin melakukan instalasi baru.

## Copot pemasangan CodeDeploy agen dari Amazon Linux atau RHEL
<a name="codedeploy-agent-operations-uninstall-linux"></a>

Untuk menghapus instalan CodeDeploy agen, masuk ke instance dan jalankan perintah berikut:

```
sudo yum erase codedeploy-agent
```

## Copot instalan CodeDeploy agen dari Server Ubuntu
<a name="codedeploy-agent-operations-uninstall-ubuntu"></a>

Untuk menghapus instalan CodeDeploy agen, masuk ke instance dan jalankan perintah berikut:

```
sudo dpkg --purge codedeploy-agent
```

## Copot pemasangan CodeDeploy agen dari Windows Server
<a name="codedeploy-agent-operations-uninstall-windows"></a>

Untuk menghapus instalan CodeDeploy agen, masuk ke instance dan jalankan tiga perintah berikut, satu per satu:

```
wmic
```

```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```

```
exit
```

Anda juga dapat masuk ke instance, dan di **Control Panel**, buka **Program dan Fitur**, pilih **Agen CodeDeploy Host**, lalu pilih **Uninstall**.

# Kirim log CodeDeploy agen ke CloudWatch
<a name="codedeploy-agent-operations-cloudwatch-agent"></a>

Anda dapat mengirim metrik CodeDeploy agen dan data log untuk CloudWatch menggunakan [ CloudWatch agen terpadu](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html), atau lebih sederhananya, CloudWatch agen.

Gunakan instruksi berikut untuk menginstal CloudWatch agen dan mengkonfigurasinya untuk digunakan dengan CodeDeploy agen.

## Prasyarat
<a name="codedeploy-agent-operations-cloudwatch-prerequisites"></a>

Sebelum memulai, selesaikan tugas berikut:
+ Instal CodeDeploy agen dan pastikan itu berjalan. Untuk informasi selengkapnya, lihat [Instal CodeDeploy agen](codedeploy-agent-operations-install.md) dan [Verifikasi CodeDeploy agen sedang berjalan](codedeploy-agent-operations-verify.md).
+ Instal CloudWatch agen. Untuk informasi selengkapnya, lihat [Menginstal CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Tambahkan izin berikut ke profil instans CodeDeploy IAM:
  + CloudWatchLogsFullAccess
  + CloudWatchAgentServerPolicy

  Untuk informasi selengkapnya tentang profil CodeDeploy instance, lihat [Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md)[Memulai dengan CodeDeploy](getting-started-codedeploy.md).

## Konfigurasikan CloudWatch agen untuk mengumpulkan CodeDeploy log
<a name="codedeploy-agent-operations-cloudwatch-configure"></a>

Anda dapat mengonfigurasi CloudWatch agen dengan melangkah melalui wizard atau dengan membuat atau mengedit file konfigurasi secara manual.

**Untuk mengkonfigurasi CloudWatch agen menggunakan wizard (Linux)**

1. Jalankan wizard, seperti yang dijelaskan dalam [Jalankan wizard konfigurasi CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).

1. Di wizard, ketika ditanya `Do you want to monitor any log files?` masuk**1**.

1. Tentukan file log CodeDeploy agen, sebagai berikut:

   1. Untuk `Log file path` masukkan path untuk file CodeDeploy log, misalnya:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.

   1. Untuk `Log group name` memasukkan nama grup log, misalnya:**codedeploy-agent-log**.

   1. Untuk `Log stream name` memasukkan nama aliran log, misalnya:**\$1instance\$1id\$1-codedeploy-agent-log**.

1. Ketika ditanya`Do you want to specify any additional log files?`, masuk**1**.

1. Tentukan log penyebaran CodeDeploy agen, sebagai berikut:

   1. Untuk `Log file path` masukkan path untuk file log CodeDeploy penyebaran, misalnya:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.

   1. Untuk `Log group name` memasukkan nama grup log, misalnya:**codedeploy-agent-deployment-log**.

   1. Untuk `Log stream name` memasukkan nama aliran log, misalnya:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

1. Ketika ditanya`Do you want to specify any additional log files?`, masuk**1**.

1. Tentukan log CodeDeploy agen updater, sebagai berikut:

   1. Untuk `Log file path` masukkan path untuk file log CodeDeploy updater, misalnya:. **/tmp/codedeploy-agent.update.log**

   1. Untuk `Log group name` memasukkan nama grup log, misalnya:**codedeploy-agent-updater-log**.

   1. Untuk `Log stream name` memasukkan nama aliran log, misalnya:**\$1instance\$1id\$1-codedeploy-agent-updater-log**.

**Untuk mengkonfigurasi CloudWatch agen menggunakan wizard (Windows)**

1. Jalankan wizard, seperti yang dijelaskan dalam [Jalankan wizard konfigurasi CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).

1. Di wizard, ketika ditanya `Do you want to monitor any customized log files?` masuk**1**.

1. Tentukan file CodeDeploy log, sebagai berikut:

   1. Untuk `Log file path` masukkan path r file log CodeDeploy agen, misalnya:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.

   1. Untuk `Log group name` memasukkan nama grup log, misalnya:**codedeploy-agent-log**.

   1. Untuk `Log stream name` memasukkan nama aliran log, misalnya:**\$1instance\$1id\$1-codedeploy-agent-log**.

1. Ketika ditanya`Do you want to specify any additional log files?`, masuk**1**.

1. Tentukan log penyebaran CodeDeploy agen, sebagai berikut:

   1. Untuk `Log file path` masukkan path file log CodeDeploy penyebaran, misalnya:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.

   1. Untuk `Log group name` memasukkan nama grup log, misalnya:**codedeploy-agent-deployment-log**.

   1. Untuk `Log stream name` memasukkan nama aliran log, misalnya:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.

**Untuk mengkonfigurasi CloudWatch agen dengan membuat atau mengedit file konfigurasi secara manual (Linux)**

1. Buat atau edit file konfigurasi CloudWatch agen seperti yang dijelaskan dalam [Membuat atau mengedit file konfigurasi CloudWatch agen secara manual](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).

1. Pastikan file tersebut dipanggil `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` dan berisi kode berikut:

   ```
   ...
   "logs": {
       "logs_collected": {
           "files": {
               "collect_list": [
                   {
                       "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
                       "log_group_name": "codedeploy-agent-log",
                       "log_stream_name": "{instance_id}-agent-log"
                   },
                   {
                       "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
                       "log_group_name": "codedeploy-agent-deployment-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                   },
                   {
                       "file_path": "/tmp/codedeploy-agent.update.log",
                       "log_group_name": "codedeploy-agent-updater-log",
                       "log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
                   }
               ]
           }
       }
   }
   ...
   ```

**Untuk mengkonfigurasi CloudWatch agen dengan membuat atau mengedit file konfigurasi secara manual (Windows)**

1. Buat atau edit file konfigurasi CloudWatch agen seperti yang dijelaskan dalam [Membuat atau mengedit file konfigurasi CloudWatch agen secara manual](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).

1. Pastikan file tersebut dipanggil `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` dan berisi kode berikut:

   ```
   ...
   "logs": {
           "logs_collected": {
               "files": {
                   "collect_list": [
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
                           "log_group_name": "codedeploy-agent-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-log"
                       },
                       {
                           "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
                           "log_group_name": "codedeploy-agent-deployment-log",
                           "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
                       }
                   ]
               },
               ...
           }
       },
   ...
   ```

## Mulai ulang CloudWatch agen
<a name="codedeploy-agent-operations-cloudwatch-restart"></a>

Setelah melakukan perubahan, restart CloudWatch agen seperti yang dijelaskan dalam [Mulai CloudWatch agen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).