Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal CodeDeploy agen
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
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
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
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
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
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
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
**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
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
**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
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
Ikuti instruksi [Instal CodeDeploy agen menggunakan AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) untuk menginstal CodeDeploy agen.
## Gunakan Windows PowerShell
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
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
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
```