Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bekerja dengan instance untuk CodeDeploy
CodeDeploy mendukung penerapan ke instance yang menjalankan Amazon Linux, Ubuntu Server, Red Hat Enterprise Linux (RHEL), dan Windows Server.
Anda dapat menggunakannya CodeDeploy untuk menerapkan instans Amazon EC2 dan instans lokal. Instans lokal adalah perangkat fisik apa pun yang bukan instans Amazon EC2 yang dapat menjalankan CodeDeploy agen dan terhubung ke titik akhir layanan AWS publik. Anda dapat menggunakan CodeDeploy untuk secara bersamaan menyebarkan aplikasi ke instans Amazon EC2 di cloud dan ke PCs desktop di kantor atau server Anda di pusat data Anda sendiri.
## Membandingkan instans Amazon EC2 dengan instans lokal
Tabel berikut membandingkan instans Amazon EC2 dan instans lokal:
| **Subjek** | **Instans Amazon EC2** | **Instans lokal** |
| --- | --- | --- |
| Mengharuskan Anda untuk menginstal dan menjalankan versi CodeDeploy agen yang kompatibel dengan sistem operasi yang berjalan pada instance. | Ya | Ya |
| Membutuhkan instance untuk dapat terhubung ke CodeDeploy. | Ya | Ya |
| Memerlukan profil instans IAM untuk dilampirkan ke instance. Profil instans IAM harus memiliki izin untuk berpartisipasi dalam CodeDeploy penerapan. Untuk informasi, lihat [Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md). | Ya | Tidak |
| Mengharuskan Anda melakukan salah satu hal berikut untuk mengautentikasi dan mendaftarkan instance: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/instances.html) | Tidak | Ya |
| Mengharuskan Anda untuk mendaftarkan setiap instance CodeDeploy sebelum Anda dapat menerapkannya. | Tidak | Ya |
| Mengharuskan Anda untuk menandai setiap instance sebelum CodeDeploy dapat menyebarkan ke sana. | Ya | Ya |
| Dapat berpartisipasi dalam skenario Amazon EC2 Auto Scaling dan Elastic Load Balancing sebagai bagian dari penerapan. CodeDeploy | Ya | Tidak |
| Dapat digunakan dari bucket GitHub dan repositori Amazon S3. | Ya | Ya |
| Dapat mendukung pemicu yang meminta pengiriman pemberitahuan SMS atau email ketika peristiwa tertentu terjadi dalam penerapan atau instance. | Ya | Ya |
| Dapat ditagih untuk penerapan terkait. | Tidak | Ya |
## Tugas instans untuk CodeDeploy
Untuk meluncurkan atau mengonfigurasi instance untuk digunakan dalam penerapan, pilih dari petunjuk berikut:
| | |
| --- |--- |
| Saya ingin meluncurkan instans Amazon Linux atau Windows Server Amazon EC2 baru. | Untuk meluncurkan instans Amazon EC2 dengan upaya paling sedikit, lihat. [Buat instans Amazon EC2 untuk CodeDeploy (template)CloudFormation](instances-ec2-create-cloudformation-template.md) Untuk meluncurkan instans Amazon EC2 sebagian besar sendiri, lihat. [Membuat instans Amazon EC2 untuk CodeDeploy (AWS CLI atau konsol Amazon EC2)](instances-ec2-create.md) |
| Saya ingin meluncurkan Server Ubuntu baru atau instance Amazon EC2 RHEL. | Lihat [Membuat instans Amazon EC2 untuk CodeDeploy (AWS CLI atau konsol Amazon EC2)](instances-ec2-create.md). |
| Saya ingin mengonfigurasi instance Amazon Linux, Windows Server, Ubuntu Server, atau RHEL Amazon EC2. | Lihat [Konfigurasikan instans Amazon EC2 agar berfungsi CodeDeploy](instances-ec2-configure.md). |
| Saya ingin mengonfigurasi instance lokal Windows Server, Ubuntu Server, atau RHEL (perangkat fisik yang bukan instance Amazon EC2). | Lihat [Bekerja dengan instans lokal untuk CodeDeploy](instances-on-premises.md). |
| Saya CodeDeploy ingin menyediakan armada instance pengganti selama blue/green penerapan. | Lihat [Bekerja dengan penerapan di CodeDeploy](deployments.md). |
Untuk menyiapkan instans Amazon EC2 di grup Penskalaan Otomatis Amazon EC2, Anda harus mengikuti beberapa langkah tambahan. Untuk informasi selengkapnya, lihat [Mengintegrasikan CodeDeploy dengan Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
**Topik**
+ [Tagging Instances for Deployments](instances-tagging.md)
+ [Working with Amazon EC2 Instances](instances-ec2.md)
+ [Working with On-Premises Instances](instances-on-premises.md)
+ [View Instance Details](instances-view-details.md)
+ [Instance Health](instances-health.md)
# Menandai instance untuk grup penerapan di CodeDeploy
Untuk membantu mengelola instans Amazon EC2 dan instans lokal, Anda dapat menggunakan tag untuk menetapkan metadata Anda sendiri ke setiap sumber daya. Tag memungkinkan Anda untuk mengkategorikan instans Anda dengan cara yang berbeda (misalnya, berdasarkan tujuan, pemilik, atau lingkungan). Ini berguna ketika Anda memiliki banyak contoh. Anda dapat dengan cepat mengidentifikasi instance atau grup instance berdasarkan tag yang telah Anda tetapkan padanya. Setiap tag terdiri atas sebuah kunci dan sebuah nilai opsional, dan Anda menentukan sendiri keduanya. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon EC2 Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html).
Untuk menentukan instance mana yang disertakan dalam grup CodeDeploy penyebaran, Anda menentukan tag dalam satu atau beberapa grup *tag*. Instans yang memenuhi kriteria tag Anda adalah instans tempat revisi aplikasi terbaru diinstal saat penerapan ke grup penerapan tersebut dibuat.
**catatan**
Anda juga dapat menyertakan grup Amazon EC2 Auto Scaling dalam grup penerapan, tetapi grup tersebut diidentifikasi berdasarkan namanya, bukan oleh tag yang diterapkan pada instance. Untuk informasi, lihat [Mengintegrasikan CodeDeploy dengan Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
Kriteria untuk instance dalam grup penyebaran dapat sesederhana satu tag dalam satu grup tag. Ini bisa serumit 10 tag masing-masing dalam maksimal tiga grup tag.
Jika Anda menggunakan satu grup tag, instance apa pun yang diidentifikasi oleh setidaknya satu tag dalam grup akan disertakan dalam grup penyebaran. Jika Anda menggunakan beberapa grup tag, hanya instance yang diidentifikasi oleh setidaknya satu tag di *setiap* grup tag yang disertakan.
Contoh berikut menggambarkan bagaimana tag dan grup tag dapat digunakan untuk memilih instance untuk grup penyebaran.
**Topics**
+ [Contoh 1: Grup tag tunggal, tag tunggal](#instances-tagging-example-1)
+ [Contoh 2: Grup tag tunggal, beberapa tag](#instances-tagging-example-2)
+ [Contoh 3: Beberapa grup tag, tag tunggal](#instances-tagging-example-3)
+ [Contoh 4: Beberapa grup tag, beberapa tag](#instances-tagging-example-4)
## Contoh 1: Grup tag tunggal, tag tunggal
Anda dapat menentukan satu tag dalam satu grup tag:
**Tag grup 1**
| Key | Nilai |
| --- | --- |
| Nama | AppVersion-ABC |
Setiap instance yang diberi tag `Name=AppVersion-ABC` adalah bagian dari grup penyebaran, meskipun tag lain diterapkan.
CodeDeploy tampilan pengaturan konsol:
![\[CodeDeploy Konsol menampilkan satu grup tag dengan satu tag.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/TaggingExample1-polaris.png)
Struktur JSON:
```
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Key": "Name",
"Value": "AppVersion-ABC"
}
]
]
},
```
## Contoh 2: Grup tag tunggal, beberapa tag
Anda juga dapat menentukan beberapa tag dalam satu grup tag:
**Tag grup 1**
| Key | Nilai |
| --- | --- |
| Region | Utara |
| Region | Selatan |
| Region | Timur |
Instance yang ditandai dengan salah satu dari ketiga tag ini adalah bagian dari grup penyebaran, bahkan jika tag lain diterapkan. Jika, misalnya, Anda memiliki instance lain yang ditandai`Region=West`, instance tersebut tidak akan disertakan dalam grup penerapan.
CodeDeploy tampilan pengaturan konsol:
![\[CodeDeploy Konsol menampilkan satu grup tag dengan tiga tag.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/TaggingExample2-polaris.png)
Struktur JSON:
```
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "North"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "South"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "East"
}
]
]
},
```
## Contoh 3: Beberapa grup tag, tag tunggal
Anda juga dapat menggunakan beberapa set grup tag dengan satu pasangan kunci-nilai di masing-masing untuk menentukan kriteria instance dalam grup penerapan. Bila Anda menggunakan beberapa grup tag dalam grup penyebaran, hanya instance yang diidentifikasi oleh semua grup tag yang disertakan dalam grup penyebaran.
**Tag grup 1**
| Key | Nilai |
| --- | --- |
| Nama | AppVersion-ABC |
**Tag grup 2**
| Key | Nilai |
| --- | --- |
| Region | Utara |
**Tag grup 3**
| Key | Nilai |
| --- | --- |
| Tipe | t2.medium |
Anda mungkin memiliki instance di banyak wilayah dan berbagai jenis instance yang ditandai. `Name=AppVersion-ABC` Dalam contoh ini, hanya instance yang juga ditandai dengan `Region=North` dan `Type=t2.medium` merupakan bagian dari grup penerapan.
CodeDeploy tampilan pengaturan konsol:
![\[CodeDeploy Konsol menampilkan tiga grup tag dengan satu tag di masing-masing.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/TaggingExample3-polaris.png)
Struktur JSON:
```
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Key": "Name",
"Value": "AppVersion-ABC"
}
],
[
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "North"
}
],
[
{
"Type": "KEY_AND_VALUE",
"Key": "Type",
"Value": "t2.medium"
}
],
]
},
```
## Contoh 4: Beberapa grup tag, beberapa tag
Bila Anda menggunakan beberapa grup tag dengan beberapa tag dalam satu atau beberapa grup, instance harus cocok dengan setidaknya satu tag di setiap grup.
**Tag grup 1**
| Key | Nilai |
| --- | --- |
| Lingkungan | Beta |
| Lingkungan | Pementasan |
**Tag grup 2**
| Key | Nilai |
| --- | --- |
| Region | Utara |
| Region | Selatan |
| Region | Timur |
**Tag grup 3**
| Key | Nilai |
| --- | --- |
| Tipe | t2.medium |
| Tipe | t2.large |
Dalam contoh ini, untuk dimasukkan dalam grup penyebaran, sebuah instance harus ditandai dengan (1) `Environment=Beta` atau`Environment=Staging`, dengan (2),, atau `Region=North` `Region=South``Region=East`, dan dengan (3) `Type=t2.medium` atau. `Type=t2.large`
Sebagai ilustrasi, instance dengan grup tag berikut *akan* termasuk di antara yang termasuk dalam grup penerapan:
+ `Environment=Beta`, `Region=North`,`Type=t2.medium`
+ `Environment=Staging`,`Region=East`,`Type=t2.large`
+ `Environment=Staging`,`Region=South`,`Type=t2.large`
Contoh dengan grup tag berikut *tidak* akan disertakan dalam grup penyebaran. Nilai kunci yang **disorot** menyebabkan instance dikecualikan:
+ `Environment=Beta`**, Wilayah = Barat,** `Type=t2.medium`
+ `Environment=Staging`**,`Region=East`, Jenis = t2.micro**
+ Lingkungan = **Produksi**,, `Region=South` `Type=t2.large`
CodeDeploy tampilan pengaturan konsol:
![\[CodeDeploy Konsol menampilkan tiga grup tag dengan beberapa tag di masing-masing.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/TaggingExample4-polaris.png)
Struktur JSON:
```
"ec2TagSet": {
"ec2TagSetList": [
[
{
"Type": "KEY_AND_VALUE",
"Key": "Environment",
"Value": "Beta"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Environment",
"Value": "Staging"
}
],
[
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "North"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "South"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Region",
"Value": "East"
}
],
[
{
"Type": "KEY_AND_VALUE",
"Key": "Type",
"Value": "t2.medium"
},
{
"Type": "KEY_AND_VALUE",
"Key": "Type",
"Value": "t2.large"
}
],
]
},
```
# Bekerja dengan instans Amazon EC2 untuk CodeDeploy
Instans Amazon EC2 adalah lingkungan komputasi virtual yang Anda buat dan konfigurasikan menggunakan Amazon Elastic Compute Cloud. Amazon EC2 menyediakan kapasitas komputasi yang dapat diskalakan di Cloud. AWS Anda dapat menggunakan Amazon EC2 untuk meluncurkan server virtual sebanyak atau sesedikit yang Anda butuhkan untuk penerapan Anda CodeDeploy .
Untuk informasi selengkapnya tentang Amazon EC2, lihat Panduan Memulai [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/).
Petunjuk di bagian ini menunjukkan cara membuat dan mengonfigurasi instans Amazon EC2 untuk digunakan dalam penerapan Anda. CodeDeploy
**Topics**
+ [Buat instans Amazon EC2 untuk CodeDeploy](instances-ec2-create.md)
+ [Buat instans Amazon EC2 (template)CloudFormation](instances-ec2-create-cloudformation-template.md)
+ [Konfigurasikan instans Amazon EC2](instances-ec2-configure.md)
# Membuat instans Amazon EC2 untuk CodeDeploy (AWS CLI atau konsol Amazon EC2)
Petunjuk ini menunjukkan cara meluncurkan instans Amazon EC2 baru yang dikonfigurasi untuk digunakan dalam CodeDeploy penerapan.
Anda dapat menggunakan CloudFormation template kami untuk meluncurkan instans Amazon EC2 yang menjalankan Amazon Linux atau Windows Server yang sudah dikonfigurasi untuk digunakan dalam CodeDeploy penerapan. Kami tidak menyediakan CloudFormation template untuk instans Amazon EC2 yang menjalankan Ubuntu Server atau Red Hat Enterprise Linux (RHEL). Untuk alternatif penggunaan template, lihat[Bekerja dengan instance untuk CodeDeploy](instances.md).
Anda dapat menggunakan konsol Amazon EC2 AWS CLI, atau Amazon EC2 API untuk meluncurkan instans Amazon EC2.
## Luncurkan instans Amazon EC2 (konsol)
### Prasyarat
Jika Anda belum melakukannya, ikuti petunjuk [Memulai dengan CodeDeploy](getting-started-codedeploy.md) untuk mengatur dan mengkonfigurasi AWS CLI dan membuat profil instans IAM.
### Luncurkan instans Amazon EC2
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Di panel navigasi, pilih **Instans**, lalu pilih **Launch** Instance.
1. Pada **Langkah 1: Pilih halaman Amazon Machine Image (AMI)**, dari tab **Mulai Cepat**, cari sistem operasi dan versi yang ingin Anda gunakan, lalu pilih **Pilih**. Anda harus memilih sistem operasi Amazon EC2 AMI yang didukung oleh. CodeDeploy Untuk informasi selengkapnya, lihat [Sistem operasi yang didukung oleh CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
1. Pada **Langkah 2: Pilih halaman Jenis Instance**, pilih jenis instans Amazon EC2 yang tersedia, lalu pilih **Berikutnya: Konfigurasi Detail Instance**.
1. Pada halaman **Langkah 3: Konfigurasikan Detail Instance**, dalam daftar **peran IAM**, pilih peran instans IAM yang Anda buat. [Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md) Jika Anda menggunakan nama peran yang disarankan, pilih**CodeDeployDemo-EC2-Instance-Profile**. Jika Anda membuat nama peran Anda sendiri, pilih itu.
**catatan**
Jika virtual private cloud (VPC) default tidak ditampilkan dalam daftar **Jaringan**, Anda harus memilih atau membuat Amazon VPC dan subnet. Pilih **Buat VPC baru** atau **Buat subnet baru** atau keduanya. Untuk informasi selengkapnya, lihat [VPC dan](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html) subnet Anda.
1. Pilih **Berikutnya: Tambahkan Penyimpanan**.
1. Biarkan **Langkah 4: Tambahkan halaman Penyimpanan** tidak berubah, dan pilih **Berikutnya: Tambahkan Tag**.
1. Pada halaman **Langkah 5: Menambahkan dengan menandai**, memilih **Menambahkan dengan menandai**.
1. Di kotak **Kunci**, ketik**Name**. Dalam tipe kotak **Nilai****CodeDeployDemo**.
**penting**
Isi kotak **Kunci** dan **Nilai** peka huruf besar/kecil.
1. Pilih **Berikutnya: Konfigurasi Grup Keamanan.**.
1. Pada halaman **Langkah 6: Konfigurasikan Grup Keamanan**, biarkan opsi **Buat grup keamanan baru** dipilih.
Peran SSH default dikonfigurasi untuk instans Amazon EC2 yang menjalankan Amazon Linux, Ubuntu Server, atau RHEL. Peran RDP default dikonfigurasi untuk instans Amazon EC2 yang menjalankan Windows Server.
1. Jika Anda ingin membuka port HTTP, pilih tombol **Add Rule**, dan dari daftar drop-down **Type**, pilih**HTTP**. **Terima nilai **Sumber** default **Custom 0.0.0.0/0**, lalu pilih Tinjau dan Luncurkan.**
**catatan**
**Dalam lingkungan produksi, kami merekomendasikan untuk membatasi akses ke port SSH, RDP, dan HTTP, alih-alih menentukan Anywhere 0.0.0.0/0.** CodeDeploy tidak memerlukan akses port yang tidak dibatasi dan tidak memerlukan akses HTTP. Untuk informasi selengkapnya, lihat [Tips untuk mengamankan instans Amazon EC2 Anda](https://aws.amazon.com/articles/1233).
Jika kotak dialog **Boot from General Purpose (SSD)** muncul, ikuti petunjuknya, lalu pilih **Berikutnya**.
1. Biarkan halaman **Langkah 7: Tinjau Peluncuran Instans** tidak berubah, dan pilih **Luncurkan**.
1. Dalam kotak dialog **Select an existing key pair atau create a new key pair**, pilih Pilih **key pair yang ada** atau **Create a new key pair**. Jika Anda sudah mengonfigurasi pasangan kunci instance Amazon EC2, Anda dapat memilihnya di sini.
Jika Anda belum memiliki pasangan kunci instance Amazon EC2, pilih **Buat pasangan kunci baru** dan berikan nama yang dapat dikenali. Pilih **Download Key Pair untuk mengunduh key pair** instans Amazon EC2 ke komputer Anda.
**penting**
Anda harus memiliki key pair jika ingin mengakses instans Amazon EC2 Anda dengan SSH atau RDP.
1. Pilih **Luncurkan Instans**.
1. Pilih ID untuk instans Amazon EC2 Anda. Jangan lanjutkan sampai instance diluncurkan dan lulus semua pemeriksaan.
### Instal CodeDeploy agen
CodeDeploy Agen harus diinstal pada instans Amazon EC2 Anda sebelum menggunakannya dalam CodeDeploy penerapan. Untuk informasi selengkapnya, lihat [Instal CodeDeploy agen](codedeploy-agent-operations-install.md).
**catatan**
Anda dapat mengonfigurasi penginstalan otomatis dan pembaruan CodeDeploy agen saat membuat grup penyebaran di konsol.
## Luncurkan instans Amazon EC2 (CLI)
### Prasyarat
Jika Anda belum melakukannya, ikuti petunjuk [Memulai dengan CodeDeploy](getting-started-codedeploy.md) untuk mengatur dan mengkonfigurasi AWS CLI dan membuat profil instans IAM.
### Luncurkan instans Amazon EC2
1. **Untuk Windows Server saja** Jika Anda membuat instans Amazon EC2 yang menjalankan Windows Server, panggil **create-security-group** dan **authorize-security-group-ingress** perintah untuk membuat grup keamanan yang memungkinkan akses RDP (yang tidak diizinkan secara default) dan, sebagai alternatif, akses HTTP. Misalnya, untuk membuat grup keamanan bernama *CodeDeployDemo-Windows-Security-Group*, jalankan perintah berikut, satu per satu:
```
aws ec2 create-security-group --group-name CodeDeployDemo-Windows-Security-Group --description "For launching Windows Server images for use with CodeDeploy"
```
```
aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 3389 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 3389
```
```
aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 80 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 80
```
**catatan**
Untuk tujuan demonstrasi, perintah ini membuat grup keamanan yang memungkinkan akses tidak terbatas untuk RDP melalui port 3389 dan, sebagai alternatif, HTTP melalui port 80. Sebagai praktik terbaik, kami sarankan untuk membatasi akses ke port RDP dan HTTP. CodeDeploy tidak memerlukan akses port yang tidak dibatasi dan tidak memerlukan akses HTTP. Untuk informasi selengkapnya, lihat [Tips untuk mengamankan instans Amazon EC2 Anda](https://aws.amazon.com/articles/1233).
1. Panggil **run-instances** perintah untuk membuat dan meluncurkan instans Amazon EC2.
Sebelum Anda memanggil perintah ini, Anda perlu mengumpulkan yang berikut:
+ ID Amazon Machine Image (AMI) (*ami-id*) yang Anda gunakan untuk instance. Untuk mendapatkan ID, lihat [Menemukan AMI yang cocok](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html).
+ Nama jenis instans Amazon EC2 (*instance-type*) yang Anda buat, seperti. `t1.micro` Untuk daftar, lihat Jenis [instans Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
+ Nama profil instans IAM dengan izin untuk mengakses bucket Amazon S3 tempat CodeDeploy file instalasi agen untuk wilayah Anda disimpan.
Untuk informasi tentang membuat profil instans IAM, lihat[Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md).
+ Nama key pair (*key-name*) instans Amazon EC2 untuk mengaktifkan akses SSH ke instans Amazon EC2 yang menjalankan Amazon Linux, Ubuntu Server, atau akses RHEL atau RDP ke instans Amazon EC2 yang menjalankan Windows Server.
**penting**
Ketik nama key pair saja, bukan ekstensi file key pair. *Misalnya, *my-keypair, bukan my-keypair.pem*.*
[Untuk menemukan nama key pair, buka konsol Amazon EC2 di https://console.aws.amazon.com /ec2.](https://console.aws.amazon.com/ec2) Di panel navigasi, di bawah **Network & Security**, pilih **Key Pairs**, dan catat nama key pair dalam daftar.
Untuk membuat key pair, lihat [Membuat key pair menggunakan Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). Pastikan Anda membuat key pair di salah satu wilayah yang terdaftar di [Region dan endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*. Jika tidak, Anda tidak akan dapat menggunakan key pair instans Amazon EC2 dengan. CodeDeploy
**Untuk Amazon Linux, RHEL, dan Server Ubuntu**
Untuk memanggil **run-instances** perintah untuk meluncurkan instans Amazon EC2 yang menjalankan Amazon Linux, Ubuntu Server, atau RHEL dan lampirkan profil instans IAM yang Anda buat. [Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md) Contoh:
```
aws ec2 run-instances \
--image-id ami-id \
--key-name key-name \
--count 1 \
--instance-type instance-type \
--iam-instance-profile Name=iam-instance-profile
```
**catatan**
Perintah ini membuat grup keamanan default untuk instans Amazon EC2 yang memungkinkan akses ke beberapa port, termasuk akses tidak terbatas untuk SSH melalui port 22 dan, sebagai alternatif, HTTP melalui port 80. Sebagai praktik terbaik, kami sarankan membatasi akses ke port SSH dan HTTP saja. CodeDeploy tidak memerlukan akses port yang tidak terbatas dan tidak memerlukan akses port HTTP. Untuk informasi selengkapnya, lihat [Tips untuk mengamankan instans Amazon EC2 Anda](https://aws.amazon.com/articles/1233).
**Untuk Windows Server**
Untuk memanggil **run-instances** perintah untuk meluncurkan instans Amazon EC2 yang menjalankan Windows Server dan melampirkan profil instans IAM yang Anda buat[Langkah 4: Buat profil instans IAM untuk instans Amazon EC2 Anda](getting-started-create-iam-instance-profile.md), dan tentukan nama grup keamanan yang Anda buat di Langkah 1. Contoh:
```
aws ec2 run-instances --image-id ami-id --key-name key-name --count 1 --instance-type instance-type --iam-instance-profile Name=iam-instance-profile --security-groups CodeDeploy-Windows-Security-Group
```
Perintah ini meluncurkan instans Amazon EC2 tunggal dengan tipe AMI, key pair, dan instance yang ditentukan, dengan profil instans IAM yang ditentukan, dan menjalankan skrip yang ditentukan selama peluncuran.
1. Perhatikan nilai `InstanceID` dalam output. Jika Anda lupa nilai ini, Anda bisa mendapatkannya nanti dengan memanggil **describe-instances** perintah terhadap key pair instans Amazon EC2.
```
aws ec2 describe-instances --filters "Name=key-name,Values=keyName" --query "Reservations[*].Instances[*].[InstanceId]" --output text
```
Gunakan ID instans untuk memanggil **create-tags** perintah, yang menandai instans Amazon EC2 sehingga CodeDeploy dapat menemukannya nanti selama penerapan. Dalam contoh berikut, tag diberi nama**CodeDeployDemo**, tetapi Anda dapat menentukan tag instans Amazon EC2 yang Anda inginkan.
```
aws ec2 create-tags --resources instance-id --tags Key=Name,Value=CodeDeployDemo
```
Anda dapat menerapkan beberapa tag ke sebuah instance secara bersamaan. Contoh:
```
aws ec2 create-tags --resources instance-id --tags Key=Name,Value=testInstance Key=Region,Value=West Key=Environment,Value=Beta
```
Untuk memverifikasi instans Amazon EC2 telah diluncurkan dan melewati semua pemeriksaan, gunakan ID instans untuk memanggil perintah. **describe-instance-status**
```
aws ec2 describe-instance-status --instance-ids instance-id --query "InstanceStatuses[*].InstanceStatus.[Status]" --output text
```
Jika instance telah diluncurkan dan melewati semua pemeriksaan, `ok` muncul di output.
### Instal CodeDeploy agen
CodeDeploy Agen harus diinstal pada instans Amazon EC2 Anda sebelum menggunakannya dalam CodeDeploy penerapan. Untuk informasi selengkapnya, lihat [Instal CodeDeploy agen](codedeploy-agent-operations-install.md).
**catatan**
Anda dapat mengonfigurasi instalasi otomatis dan pembaruan CodeDeploy agen saat membuat grup penyebaran di konsol.
# Buat instans Amazon EC2 untuk CodeDeploy (template)CloudFormation
Anda dapat menggunakan CloudFormation template kami untuk meluncurkan instans Amazon EC2 dengan cepat yang menjalankan Amazon Linux atau Windows Server. Anda dapat menggunakan AWS CLI, CodeDeploy konsol, atau AWS APIs untuk meluncurkan instance dengan template. Selain meluncurkan instance, template melakukan hal berikut:
+ Menginstruksikan CloudFormation untuk memberikan izin instans untuk berpartisipasi dalam CodeDeploy penerapan.
+ Menandai instance sehingga CodeDeploy dapat menemukannya selama penerapan.
+ Menginstal dan menjalankan CodeDeploy agen pada instance.
Anda tidak harus menggunakan kami CloudFormation untuk menyiapkan instans Amazon EC2. Untuk alternatif, lihat[Bekerja dengan instance untuk CodeDeploy](instances.md).
Kami tidak menyediakan CloudFormation template untuk instans Amazon EC2 yang menjalankan Ubuntu Server atau Red Hat Enterprise Linux (RHEL).
**Topics**
+ [Sebelum Anda mulai](#instances-ec2-create-cloudformation-template-before)
+ [Luncurkan instans Amazon EC2 dengan CloudFormation template (konsol)](#instances-ec2-create-cloudformation-template-console)
+ [Luncurkan instans Amazon EC2 dengan CloudFormation template ()AWS CLI](#instances-ec2-create-cloudformation-template-cli)
## Sebelum Anda mulai
Sebelum Anda dapat menggunakan CloudFormation template untuk meluncurkan instans Amazon EC2, pastikan Anda menyelesaikan langkah-langkah berikut.
1. Pastikan Anda telah membuat pengguna administratif, seperti yang dijelaskan dalam[Langkah 1: Menyiapkan](getting-started-setting-up.md). Periksa kembali apakah pengguna memiliki izin minimum berikut dan tambahkan yang tidak ada:
+ pembentukan awan: \$1
+ penyebaran kode: \$1
+ EC2: \$1
+ saya: AddRoleToInstanceProfile
+ saya: CreateInstanceProfile
+ saya: CreateRole
+ saya: DeleteInstanceProfile
+ saya: DeleteRole
+ saya: DeleteRolePolicy
+ saya: GetRole
+ saya: DeleteRolePolicy
+ saya: PutRolePolicy
+ saya: RemoveRoleFromInstanceProfile
1. Pastikan Anda memiliki instance key pair untuk mengaktifkan akses SSH ke instans Amazon EC2 yang menjalankan Amazon Linux atau akses RDP ke instance yang menjalankan Windows Server.
[Untuk menemukan nama key pair, buka konsol Amazon EC2 di https://console.aws.amazon.com /ec2.](https://console.aws.amazon.com/ec2) Di panel navigasi, di bawah **Network & Security**, pilih **Key Pairs**, dan catat nama key pair dalam daftar.
Untuk membuat key pair baru, lihat [Membuat key pair menggunakan Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). Pastikan key pair dibuat di salah satu wilayah yang terdaftar di [Region dan endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*. Jika tidak, Anda tidak dapat menggunakan instance key pair with CodeDeploy.
## Luncurkan instans Amazon EC2 dengan CloudFormation template (konsol)
1. Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
**penting**
Masuk ke akun Konsol Manajemen AWS dengan akun yang sama dengan yang Anda gunakan[Memulai dengan CodeDeploy](getting-started-codedeploy.md). Pada bilah navigasi, di pemilih wilayah, pilih salah satu wilayah yang tercantum di [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS* CodeDeploy hanya mendukung daerah-daerah ini.
1. Pilih **Buat tumpukan**.
1. Di **Pilih templat**, pilih **Tentukan URL template Amazon S3**. Di kotak, ketik lokasi CloudFormation templat untuk wilayah Anda, lalu pilih **Berikutnya**.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)
1. Di kotak **nama Stack**, ketikkan nama untuk tumpukan (misalnya,**CodeDeployDemoStack**).
1. Di **Parameter**, ketik berikut ini, lalu pilih **Berikutnya**.
+ Untuk **InstanceCount**, ketik jumlah instance yang ingin Anda luncurkan. (Kami sarankan Anda meninggalkan default **1**.)
+ Untuk **InstanceType**, ketik jenis instance yang ingin Anda luncurkan (atau biarkan default **t1.micro**).
+ Untuk **KeyPairName**, ketik nama instance key pair. Ketik nama key pair saja, bukan ekstensi file key pair.
+ Untuk **OperatingSystem**kotak, ketik **Windows** untuk meluncurkan instance yang menjalankan Windows Server (atau biarkan default **Linux**).
+ **Untuk **SSHLocation**, ketik rentang alamat IP yang akan digunakan untuk menghubungkan ke instance dengan SSH atau RDP (atau biarkan default 0.0.0.0/0).**
**penting**
Default **0.0.0.0/0** disediakan untuk tujuan demonstrasi saja. CodeDeploy tidak mengharuskan instans Amazon EC2 memiliki akses tidak terbatas ke port. Sebagai praktik terbaik, kami sarankan untuk membatasi akses ke port SSH (dan HTTP). Untuk informasi selengkapnya, lihat [Tips untuk mengamankan instans Amazon EC2 Anda](https://aws.amazon.com/articles/1233).
+ Untuk **TagKey**, ketik kunci tag instance yang CodeDeploy akan digunakan untuk mengidentifikasi instance selama penerapan (atau biarkan default **Nama**).
+ Untuk **TagValue**, ketik nilai tag instance yang CodeDeploy akan digunakan untuk mengidentifikasi instance selama penerapan (atau biarkan default). **CodeDeployDemo**
1. Pada halaman **Opsi**, biarkan kotak opsi kosong, dan pilih **Berikutnya**.
**penting**
CloudFormation tag berbeda dari CodeDeploy tag. CloudFormation menggunakan tag untuk menyederhanakan administrasi infrastruktur Anda. CodeDeploy menggunakan tag untuk mengidentifikasi instans Amazon EC2. Anda menentukan CodeDeploy tag pada halaman **Tentukan Parameter**.
1. **Pada halaman **Tinjauan**, di **Kemampuan**, pilih kotak **Saya mengakui yang CloudFormation mungkin membuat sumber daya IAM**, lalu pilih Buat.**
**Setelah CloudFormation membuat tumpukan dan meluncurkan instans Amazon EC2, di CloudFormation konsol, **CREATE\$1COMPLETE** akan ditampilkan di kolom Status.** Proses ini dapat memakan waktu beberapa menit.
Untuk memverifikasi CodeDeploy agen berjalan di instans Amazon EC2, lihat[Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md), lalu lanjutkan ke. [Buat aplikasi dengan CodeDeploy](applications-create.md)
## Luncurkan instans Amazon EC2 dengan CloudFormation template ()AWS CLI
1. Gunakan CloudFormation template kami dalam panggilan ke **create-stack** perintah. Tumpukan ini akan meluncurkan instans Amazon EC2 baru dengan CodeDeploy agen diinstal.
Untuk meluncurkan instans Amazon EC2 yang menjalankan Amazon Linux:
```
aws cloudformation create-stack \
--stack-name CodeDeployDemoStack \
--template-url templateURL \
--parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro \
ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Linux \
ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name \
ParameterKey=TagValue,ParameterValue=CodeDeployDemo \
--capabilities CAPABILITY_IAM
```
Untuk meluncurkan instans Amazon EC2 yang menjalankan Windows Server:
```
aws cloudformation create-stack --stack-name CodeDeployDemoStack --template-url template-url --parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Windows ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name ParameterKey=TagValue,ParameterValue=CodeDeployDemo --capabilities CAPABILITY_IAM
```
*keyName*adalah nama instance key pair. Ketik nama key pair saja, bukan ekstensi file key pair.
*template-url*adalah lokasi CloudFormation template untuk wilayah Anda:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)
Perintah ini membuat CloudFormation tumpukan bernama**CodeDeployDemoStack**, menggunakan CloudFormation template di bucket Amazon S3 yang ditentukan. Instans Amazon EC2 didasarkan pada jenis instans t1.micro, tetapi Anda dapat menggunakan jenis apa pun. Ini ditandai dengan nilainya**CodeDeployDemo**, tetapi Anda dapat menandainya dengan nilai apa pun. Ini memiliki instance key pair yang ditentukan diterapkan.
1. Panggil **describe-stacks** perintah untuk memverifikasi CloudFormation tumpukan **CodeDeployDemoStack** bernama berhasil dibuat:
```
aws cloudformation describe-stacks --stack-name CodeDeployDemoStack --query "Stacks[0].StackStatus" --output text
```
Jangan melanjutkan sampai nilai `CREATE_COMPLETE` dikembalikan.
Untuk memverifikasi CodeDeploy agen berjalan di instans Amazon EC2, lihat[Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md), lalu lanjutkan ke. [Buat aplikasi dengan CodeDeploy](applications-create.md)
# Konfigurasikan instans Amazon EC2 agar berfungsi CodeDeploy
Petunjuk ini menunjukkan cara mengonfigurasi instans Amazon EC2 yang menjalankan Amazon Linux, Ubuntu Server, Red Hat Enterprise Linux (RHEL), atau Windows Server untuk digunakan dalam penerapan. CodeDeploy
**catatan**
Jika Anda tidak memiliki instans Amazon EC2, Anda dapat menggunakan CloudFormation template untuk meluncurkan satu yang menjalankan Amazon Linux atau Windows Server. Kami tidak menyediakan template untuk Ubuntu Server atau RHEL.
## Langkah 1: Verifikasi bahwa profil instans IAM dilampirkan ke instans Amazon EC2
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Di panel navigasi, di **Instans**, pilih **Instans**.
1. Jelajahi dan pilih instans Amazon EC2 Anda dalam daftar.
1. Di panel detail, pada tab **Deskripsi**, catat nilai di bidang **peran IAM**, lalu lanjutkan ke bagian berikutnya.
Jika bidang kosong, Anda dapat melampirkan profil instans IAM ke instance. Untuk selengkapnya, lihat [Melampirkan peran IAM ke instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html#attach-iam-role).
## Langkah 2: Verifikasi profil instans IAM terlampir memiliki izin akses yang benar
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi, pilih **Peran**.
1. Jelajahi dan pilih nama peran IAM yang Anda catat di langkah 4 dari bagian sebelumnya.
**catatan**
Jika Anda ingin menggunakan peran layanan yang dihasilkan oleh CloudFormation template, bukan yang Anda buat dengan mengikuti petunjuk[Langkah 2: Buat peran layanan untuk CodeDeploy](getting-started-create-service-role.md), perhatikan hal berikut:
Di beberapa versi CloudFormation template kami, nama tampilan profil instans IAM yang dihasilkan dan dilampirkan ke instans Amazon EC2 tidak sama dengan nama tampilan di konsol IAM. Misalnya, profil instans IAM mungkin memiliki nama tampilan`CodeDeploySampleStack-expnyi6-InstanceRoleInstanceProfile-IK8J8A9123EX`, sedangkan profil instans IAM di konsol IAM mungkin memiliki nama tampilan. `CodeDeploySampleStack-expnyi6-InstanceRole-C5P33V1L64EX`
Untuk membantu Anda mengidentifikasi profil instance di konsol IAM, Anda akan melihat awalan dari `CodeDeploySampleStack-expnyi6-InstanceRole` is sama untuk keduanya. Untuk informasi tentang mengapa nama tampilan ini mungkin berbeda, lihat [Profil instans](https://docs.aws.amazon.com/IAM/latest/UserGuide/instance-profiles.html).
1. Pilih tab **Trust Relationships** (Hubungan Kepercayaan). Jika tidak ada entri di **Entitas Tepercaya** yang membaca **Penyedia identitas ec2.amazonaws.com, Anda tidak dapat menggunakan instans** Amazon EC2 ini. Hentikan dan buat instans Amazon EC2 menggunakan informasi di. [Bekerja dengan instance untuk CodeDeploy](instances.md)
Jika ada entri yang bertuliskan **Penyedia identitas ec2.amazonaws.com**, dan Anda hanya menyimpan aplikasi Anda di GitHub repositori, lalu lanjutkan ke. [Langkah 3: Tandai instans Amazon EC2](#instances-ec2-configure-3-tag-instance)
**Jika ada entri yang bertuliskan **Penyedia identitas ec2.amazonaws.com**, dan Anda menyimpan aplikasi Anda di bucket Amazon S3, pilih tab Izin.**
1. Jika ada kebijakan di area Kebijakan **izin, perluas kebijakan**, lalu pilih **Edit kebijakan**.
1. Pilih tab **JSON**. Jika Anda menyimpan aplikasi Anda di bucket Amazon S3, pastikan `"s3:Get*"` dan `"s3:List*"` berada dalam daftar tindakan yang ditentukan.
Mungkin terlihat seperti ini:
```
{"Statement":[{"Resource":"*","Action":[
... Some actions may already be listed here ...
"s3:Get*","s3:List*"
... Some more actions may already be listed here ...
],"Effect":"Allow"}]}
```
Atau mungkin terlihat seperti ini:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": "*"
}
]
}
```
------
Jika `"s3:Get*"` dan tidak `"s3:List*"` ada dalam daftar tindakan yang ditentukan, pilih **Edit** untuk menambahkannya, lalu pilih **Simpan**. (Jika tidak ada `"s3:Get*"` atau `"s3:List*"` merupakan tindakan terakhir dalam daftar, pastikan untuk menambahkan koma setelah tindakan, sehingga dokumen kebijakan memvalidasi.)
**catatan**
Kami menyarankan Anda membatasi kebijakan ini hanya untuk bucket Amazon S3 yang harus diakses instans Amazon EC2 Anda. Pastikan untuk memberikan akses ke bucket Amazon S3 yang berisi agen. CodeDeploy Jika tidak, kesalahan dapat terjadi ketika CodeDeploy agen diinstal atau diperbarui pada instance. Untuk memberikan akses profil instans IAM hanya ke beberapa bucket kit CodeDeploy sumber daya di Amazon S3, gunakan kebijakan berikut, tetapi hapus baris untuk bucket yang ingin Anda cegah aksesnya:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*",
"arn:aws:s3:::aws-codedeploy-us-east-2/*",
"arn:aws:s3:::aws-codedeploy-us-east-1/*",
"arn:aws:s3:::aws-codedeploy-us-west-1/*",
"arn:aws:s3:::aws-codedeploy-us-west-2/*",
"arn:aws:s3:::aws-codedeploy-ca-central-1/*",
"arn:aws:s3:::aws-codedeploy-eu-west-1/*",
"arn:aws:s3:::aws-codedeploy-eu-west-2/*",
"arn:aws:s3:::aws-codedeploy-eu-west-3/*",
"arn:aws:s3:::aws-codedeploy-eu-central-1/*",
"arn:aws:s3:::aws-codedeploy-eu-central-2/*",
"arn:aws:s3:::aws-codedeploy-eu-north-1/*",
"arn:aws:s3:::aws-codedeploy-eu-south-1/*",
"arn:aws:s3:::aws-codedeploy-eu-south-2/*",
"arn:aws:s3:::aws-codedeploy-il-central-1/*",
"arn:aws:s3:::aws-codedeploy-ap-east-1/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
"arn:aws:s3:::aws-codedeploy-ap-south-1/*",
"arn:aws:s3:::aws-codedeploy-ap-south-2/*",
"arn:aws:s3:::aws-codedeploy-me-central-1/*",
"arn:aws:s3:::aws-codedeploy-me-south-1/*",
"arn:aws:s3:::aws-codedeploy-sa-east-1/*"
]
}
]
}
```
## Langkah 3: Tandai instans Amazon EC2
Untuk petunjuk tentang cara menandai instans Amazon EC2 sehingga CodeDeploy dapat menemukannya selama penerapan, lihat [Bekerja dengan tag di konsol](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_Console), lalu kembali ke halaman ini.
**catatan**
Anda dapat menandai instans Amazon EC2 dengan kunci dan nilai apa pun yang Anda suka. Pastikan untuk menentukan kunci dan nilai ini saat Anda menerapkannya.
## Langkah 4: Instal AWS CodeDeploy agen pada instans Amazon EC2
Untuk petunjuk tentang cara menginstal CodeDeploy agen pada instans Amazon EC2 dan memverifikasinya sedang berjalan, lihat[Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md), lalu lanjutkan ke. [Buat aplikasi dengan CodeDeploy](applications-create.md)
# Bekerja dengan instans lokal untuk CodeDeploy
Instans lokal adalah perangkat fisik apa pun yang bukan instans Amazon EC2 yang dapat menjalankan CodeDeploy agen dan terhubung ke titik akhir layanan AWS publik.
Menerapkan revisi CodeDeploy aplikasi ke instans lokal melibatkan dua langkah utama:
+ **Langkah 1** — Konfigurasikan setiap instans lokal, daftarkan CodeDeploy, lalu beri tag.
+ **Langkah 2** — Menyebarkan revisi aplikasi ke instans lokal.
**catatan**
Untuk bereksperimen dengan membuat dan menerapkan contoh revisi aplikasi ke instans lokal yang dikonfigurasi dan terdaftar dengan benar, lihat. [Tutorial: Menerapkan aplikasi ke instans lokal dengan CodeDeploy (Windows Server, Ubuntu Server, atau Red Hat Enterprise Linux)](tutorials-on-premises-instance.md) Untuk informasi tentang instans lokal dan cara kerjanya CodeDeploy, lihat. [Bekerja dengan instans lokal untuk CodeDeploy](#instances-on-premises)
Jika tidak ingin instance lokal digunakan dalam penerapan lagi, Anda dapat menghapus tag instans lokal dari grup penerapan. Untuk pendekatan yang lebih kuat, hapus tag instance lokal dari instance. Anda juga dapat membatalkan pendaftaran instans lokal secara eksplisit sehingga tidak dapat digunakan lagi dalam penerapan apa pun. Untuk informasi selengkapnya, lihat [Mengelola operasi instans lokal di CodeDeploy](on-premises-instances-operations.md).
Petunjuk di bagian ini menunjukkan cara mengonfigurasi instans lokal, lalu mendaftar dan menandainya CodeDeploy agar dapat digunakan dalam penerapan. Bagian ini juga menjelaskan cara menggunakan CodeDeploy untuk mendapatkan informasi tentang instans lokal dan membatalkan pendaftaran instans lokal setelah Anda tidak lagi berencana untuk menerapkannya.
**Topics**
+ [Prasyarat untuk mengonfigurasi instans lokal](instances-on-premises-prerequisites.md)
+ [Mendaftarkan instans lokal](on-premises-instances-register.md)
+ [Mengelola operasi instans lokal](on-premises-instances-operations.md)
# Prasyarat untuk mengonfigurasi instans lokal
Prasyarat berikut harus dipenuhi sebelum Anda dapat mendaftarkan instans lokal.
**penting**
Jika Anda menggunakan [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah dan kredenal sementara yang diperbarui secara berkala yang dihasilkan dengan AWS Security Token Service (AWS STS), ada prasyarat lain. Untuk informasi, lihat [Prasyarat pendaftaran ARN sesi IAM](register-on-premises-instance-iam-session-arn.md#register-on-premises-instance-iam-session-arn-prerequisites).
**Persyaratan perangkat**
Perangkat yang ingin Anda siapkan, daftarkan, dan beri tag sebagai instans lokal CodeDeploy harus menjalankan sistem operasi yang didukung. Untuk daftarnya, lihat [Sistem operasi yang didukung oleh CodeDeploy agen](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
Jika sistem operasi Anda tidak didukung, CodeDeploy agen tersedia sebagai open source bagi Anda untuk beradaptasi dengan kebutuhan Anda. Untuk informasi lebih lanjut, lihat repositori [CodeDeploy agen](https://github.com/aws/aws-codedeploy-agent) di. GitHub
**Komunikasi keluar**
Instans lokal harus dapat terhubung ke titik akhir AWS layanan publik untuk berkomunikasi. CodeDeploy
CodeDeploy Agen berkomunikasi keluar menggunakan HTTPS melalui port 443.
**Kontrol administratif**
Akun lokal atau jaringan yang digunakan pada instans lokal untuk mengonfigurasi instans lokal harus dapat dijalankan baik sebagai `sudo` atau `root` (untuk Server Ubuntu) atau sebagai administrator (untuk Windows Server).
**Izin IAM**
Identitas IAM yang Anda gunakan untuk mendaftarkan instans lokal harus diberikan izin untuk menyelesaikan pendaftaran (dan untuk membatalkan pendaftaran instans lokal, sesuai kebutuhan).
Selain kebijakan yang dijelaskan dalam[Langkah 3: Batasi izin CodeDeploy pengguna](getting-started-policy.md), pastikan identitas IAM panggilan memiliki kebijakan tambahan berikut yang dilampirkan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:CreateAccessKey",
"iam:CreateUser",
"iam:DeleteAccessKey",
"iam:DeleteUser",
"iam:DeleteUserPolicy",
"iam:ListAccessKeys",
"iam:ListUserPolicies",
"iam:PutUserPolicy",
"iam:GetUser"
],
"Resource": "*"
}
]
}
```
------
Untuk informasi tentang cara melampirkan kebijakan IAM, lihat [Mengelola kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html).
# Daftarkan instans lokal dengan CodeDeploy
Untuk mendaftarkan instans lokal, Anda harus menggunakan identitas IAM untuk mengautentikasi permintaan Anda. Anda dapat memilih dari opsi berikut untuk identitas IAM dan metode pendaftaran yang Anda gunakan:
+ Gunakan peran IAM ARN untuk mengautentikasi permintaan.
+ Gunakan [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah dan kredenal sementara yang diperbarui secara berkala yang dihasilkan dengan AWS Security Token Service (AWS STS) untuk mengonfigurasi sebagian besar opsi pendaftaran secara manual. Opsi ini menawarkan tingkat keamanan tertinggi, karena otentikasi terjadi menggunakan token sementara yang habis waktu dan harus disegarkan secara berkala. Opsi ini direkomendasikan untuk penyebaran produksi dalam berbagai ukuran. Untuk informasi, lihat [Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
+ (Tidak disarankan) Gunakan ARN pengguna IAM untuk mengautentikasi permintaan.
+ Gunakan perintah [register](https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html) untuk proses pendaftaran paling otomatis. Opsi ini hanya boleh digunakan untuk penerapan non-produksi di mana keamanan kurang menjadi perhatian. Opsi ini kurang aman karena menggunakan kredensi statis (permanen) untuk otentikasi. Opsi ini berfungsi dengan baik untuk mendaftarkan satu instance lokal. Untuk informasi, lihat [Gunakan perintah register (ARN pengguna IAM) untuk mendaftarkan instans lokal](instances-on-premises-register-instance.md).
+ Gunakan [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah untuk mengkonfigurasi sebagian besar opsi pendaftaran secara manual. Cocokkan untuk mendaftarkan sejumlah kecil instans lokal. Untuk informasi, lihat [Gunakan register-on-premises-instance perintah (ARN pengguna IAM) untuk mendaftarkan instance lokal](register-on-premises-instance-iam-user-arn.md).
**Topics**
+ [Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md)
+ [Gunakan perintah register (ARN pengguna IAM) untuk mendaftarkan instans lokal](instances-on-premises-register-instance.md)
+ [Gunakan register-on-premises-instance perintah (ARN pengguna IAM) untuk mendaftarkan instance lokal](register-on-premises-instance-iam-user-arn.md)
# Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal
Untuk kontrol maksimum atas otentikasi dan pendaftaran instans lokal, Anda dapat menggunakan [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah dan kredensyal sementara yang diperbarui secara berkala yang dihasilkan dengan (). AWS Security Token Service AWS STS Peran IAM statis untuk instance mengasumsikan peran AWS STS kredenal yang disegarkan ini untuk melakukan operasi penerapan. CodeDeploy
Metode ini paling berguna ketika Anda perlu mendaftarkan sejumlah besar instance. Ini memungkinkan Anda untuk mengotomatiskan proses pendaftaran dengan CodeDeploy. Anda dapat menggunakan sistem identitas dan autentikasi Anda sendiri untuk mengautentikasi instans lokal dan mendistribusikan kredensil sesi IAM dari layanan ke instans untuk digunakan. CodeDeploy
**catatan**
Atau, Anda dapat menggunakan pengguna IAM bersama yang didistribusikan ke semua instans lokal untuk memanggil AWS STS [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)API guna mengambil kredensil sesi untuk instance lokal. Metode ini kurang aman dan tidak direkomendasikan untuk lingkungan produksi atau misi kritis.
Gunakan informasi dalam topik berikut untuk mengonfigurasi instans lokal menggunakan kredensil keamanan sementara yang dihasilkan. AWS STS
**Topics**
+ [Prasyarat pendaftaran ARN sesi IAM](#register-on-premises-instance-iam-session-arn-prerequisites)
+ [Langkah 1: Buat peran IAM yang akan diasumsikan oleh instans lokal](#register-on-premises-instance-iam-session-arn-1)
+ [Langkah 2: Hasilkan kredensil sementara untuk instance individual menggunakan AWS STS](#register-on-premises-instance-iam-session-arn-2)
+ [Langkah 3: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-session-arn-3)
+ [Langkah 4: Siapkan instans lokal untuk penerapan CodeDeploy](#register-on-premises-instance-iam-session-arn-4)
+ [Langkah 5: Daftarkan instans lokal dengan CodeDeploy](#register-on-premises-instance-iam-session-arn-5)
+ [Langkah 6: Tandai instans lokal](#register-on-premises-instance-iam-session-arn-6)
+ [Langkah 7: Menerapkan revisi aplikasi ke instans lokal](#register-on-premises-instance-iam-session-arn-7)
+ [Langkah 8: Lacak penerapan ke instans lokal](#register-on-premises-instance-iam-session-arn-8)
## Prasyarat pendaftaran ARN sesi IAM
Selain prasyarat yang tercantum dalam[Prasyarat untuk mengonfigurasi instans lokal](instances-on-premises-prerequisites.md), persyaratan tambahan berikut harus dipenuhi:
**Izin IAM**
Identitas IAM yang Anda gunakan untuk mendaftarkan instans lokal harus diberikan izin untuk melakukan operasi. CodeDeploy Pastikan kebijakan **AWSCodeDeployFullAccess**terkelola dilampirkan pada identitas IAM. Untuk selengkapnya, lihat [kebijakan AWS terkelola](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) di *Panduan Pengguna IAM*.
**Sistem untuk menyegarkan kredensil sementara**
Jika Anda menggunakan ARN sesi IAM untuk mendaftarkan instans lokal, Anda harus memiliki sistem untuk menyegarkan kredenal sementara secara berkala. Kredensi sementara kedaluwarsa setelah satu jam atau lebih cepat jika periode yang lebih pendek ditentukan saat kredensil dihasilkan. Ada dua metode untuk menyegarkan kredensil:
+ **Metode 1**: Gunakan sistem identitas dan otentikasi yang ada di jaringan perusahaan Anda dengan skrip CRON yang secara berkala melakukan polling identitas dan sistem otentikasi dan menyalin kredensyal sesi terbaru ke instans. Ini memungkinkan Anda untuk mengintegrasikan otentikasi dan struktur identitas Anda AWS tanpa perlu membuat perubahan pada CodeDeploy agen atau layanan untuk mendukung jenis otentikasi yang Anda gunakan di organisasi Anda.
+ **Metode 2**: Jalankan tugas CRON secara berkala pada instance untuk memanggil AWS STS [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)tindakan dan menulis kredensyal sesi ke file yang dapat diakses CodeDeploy agen. Metode ini masih memerlukan penggunaan pengguna IAM dan menyalin kredensil ke instans lokal, tetapi Anda dapat menggunakan kembali pengguna dan kredensil IAM yang sama di seluruh armada instans lokal.
**catatan**
Terlepas dari apakah Anda menggunakan metode 1 atau 2, Anda harus menyiapkan proses untuk memulai ulang CodeDeploy agen setelah kredensyal sesi sementara diperbarui sehingga kredensyal baru berlaku.
Untuk informasi tentang membuat dan bekerja dengan AWS STS kredensyal, lihat [Referensi AWS Security Token Service API](https://docs.aws.amazon.com/STS/latest/APIReference/) dan [Menggunakan kredensyal keamanan sementara untuk meminta akses ke sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html). AWS
## Langkah 1: Buat peran IAM yang akan diasumsikan oleh instans lokal
Anda dapat menggunakan konsol IAM AWS CLI atau IAM untuk membuat peran IAM yang akan digunakan oleh instans lokal untuk mengautentikasi dan berinteraksi. CodeDeploy
Anda hanya perlu membuat peran IAM tunggal. Setiap instans lokal Anda dapat mengambil peran ini untuk mengambil kredenal keamanan sementara yang memberikan izin yang diberikan untuk peran ini.
Peran yang Anda buat akan memerlukan izin berikut untuk mengakses file yang diperlukan untuk menginstal CodeDeploy agen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Sebaiknya batasi kebijakan ini hanya pada bucket Amazon S3 yang perlu diakses instans lokal. Jika Anda membatasi kebijakan ini, pastikan untuk memberikan akses ke bucket Amazon S3 yang berisi agen. CodeDeploy Jika tidak, kesalahan dapat terjadi setiap kali CodeDeploy agen diinstal atau diperbarui pada instans lokal. Untuk informasi tentang mengontrol akses ke bucket Amazon S3, lihat [Mengelola izin akses ke sumber daya Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) Anda.
**Untuk membuat peran IAM**
1. Panggil perintah [create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) menggunakan `--role-name` opsi untuk menentukan nama untuk peran IAM (misalnya,`CodeDeployInstanceRole`) dan `--assume-role-policy-document` opsi untuk memberikan izin.
Saat Anda membuat peran IAM untuk instance ini, Anda mungkin memberinya nama `CodeDeployInstanceRole` dan menyertakan izin yang diperlukan dalam file bernama: `CodeDeployRolePolicy.json`
```
aws iam create-role --role-name CodeDeployInstanceRole --assume-role-policy-document file://CodeDeployRolePolicy.json
```
1. Dalam output panggilan ke **create-role** perintah, perhatikan nilai bidang ARN. Contoh:
```
arn:aws:iam::123456789012:role/CodeDeployInstanceRole
```
Anda akan memerlukan peran ARN saat menggunakan AWS STS [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)API untuk menghasilkan kredensi jangka pendek untuk setiap instance.
Untuk informasi selengkapnya tentang membuat peran IAM, lihat [Membuat peran untuk mendelegasikan izin ke AWS layanan di Panduan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) Pengguna *IAM*.
Untuk informasi tentang menetapkan izin ke peran yang ada, lihat [put-role-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/put-role-policy.html)di Referensi [AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/).
## Langkah 2: Hasilkan kredensil sementara untuk instance individual menggunakan AWS STS
Sebelum Anda membuat kredensyal sementara yang akan digunakan untuk mendaftarkan instans lokal, Anda harus membuat atau memilih identitas IAM (pengguna atau peran) yang akan Anda buat kredensyal sementara. `sts:AssumeRole`Izin harus disertakan dalam pengaturan kebijakan untuk identitas IAM ini.
Untuk informasi tentang pemberian `sts:AssumeRole` izin ke identitas IAM, lihat [Membuat peran untuk mendelegasikan izin ke](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) layanan dan. AWS [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)
Ada dua cara untuk menghasilkan kredensi sementara:
+ Gunakan perintah [assume-role](https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html) dengan. AWS CLI Contoh:
```
aws sts assume-role --role-arn arn:aws:iam::12345ACCOUNT:role/role-arn --role-session-name session-name
```
Di mana:
+ *12345ACCOUNT*adalah nomor akun 12 digit untuk organisasi Anda.
+ *role-arn*adalah ARN dari peran yang akan diasumsikan, yang Anda hasilkan. [Langkah 1: Buat peran IAM yang akan diasumsikan oleh instans lokal](#register-on-premises-instance-iam-session-arn-1)
+ *session-name*adalah nama yang ingin Anda berikan untuk sesi peran yang Anda buat sekarang.
**catatan**
Jika Anda menggunakan skrip CRON yang secara berkala melakukan polling identitas dan sistem otentikasi dan menyalin kredensyal sesi terbaru ke instance (metode 1 untuk menyegarkan kredensyal sementara yang dijelaskan dalam[Prasyarat pendaftaran ARN sesi IAM](#register-on-premises-instance-iam-session-arn-prerequisites)), Anda dapat menggunakan SDK apa pun yang didukung untuk memanggil. AWS [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)
+ Gunakan alat yang disediakan oleh AWS.
aws-codedeploy-session-helperAlat ini menghasilkan AWS STS kredensil dan menuliskannya ke file yang Anda tempatkan pada instance. Alat ini paling cocok untuk metode 2 untuk menyegarkan kredensil sementara yang dijelaskan dalam. [Prasyarat pendaftaran ARN sesi IAM](#register-on-premises-instance-iam-session-arn-prerequisites) Dalam metode ini, aws-codedeploy-session-helper alat ditempatkan pada setiap instance dan menjalankan perintah menggunakan izin pengguna IAM. Setiap instance menggunakan kredensi pengguna IAM yang sama dalam hubungannya dengan alat ini.
Untuk informasi lebih lanjut, lihat [aws-codedeploy-session-helper](https://github.com/awslabs/aws-codedeploy-samples/tree/master/utilities/aws-codedeploy-session-helper) GitHub repositori.
**catatan**
Setelah Anda membuat kredensil sesi IAM, letakkan kredenal sesi IAM di lokasi mana pun di instans lokal. Pada langkah berikutnya, Anda akan mengonfigurasi CodeDeploy agen untuk mengakses kredensil di lokasi ini.
Sebelum melanjutkan, pastikan sistem yang akan Anda gunakan untuk menyegarkan kredenal sementara secara berkala sudah ada. Jika kredenal sementara tidak di-refresh, penerapan ke instans lokal akan gagal. Untuk informasi selengkapnya, lihat “Sistem untuk menyegarkan kredensil sementara” di. [Prasyarat pendaftaran ARN sesi IAM](#register-on-premises-instance-iam-session-arn-prerequisites)
## Langkah 3: Tambahkan file konfigurasi ke instans lokal
Tambahkan file konfigurasi ke instans lokal, menggunakan izin root atau administrator. File konfigurasi ini digunakan untuk mendeklarasikan kredenal IAM dan AWS wilayah target yang akan digunakan. CodeDeploy File harus ditambahkan ke lokasi tertentu pada instance lokal. File harus menyertakan ARN sesi sementara IAM, ID kunci rahasia dan kunci akses rahasia, dan wilayah target. AWS
**Untuk menambahkan file konfigurasi**
1. Membuat file bernama `codedeploy.onpremises.yml` (untuk Server Ubuntu atau instans lokal RHEL) atau `conf.onpremises.yml` (untuk instance lokal Windows Server) di lokasi berikut pada instans lokal:
+ Untuk Server Ubuntu: `/etc/codedeploy-agent/conf`
+ Untuk Windows Server: `C:\ProgramData\Amazon\CodeDeploy`
1. Gunakan editor teks untuk menambahkan informasi berikut ke `codedeploy.onpremises.yml` file yang baru dibuat (Linux) atau `conf.onpremises.yml` file (Windows):
```
---
iam_session_arn: iam-session-arn
aws_credentials_file: credentials-file
region: supported-region
```
Di mana:
+ *iam-session-arn*adalah ARN sesi IAM yang Anda catat. [Langkah 2: Hasilkan kredensil sementara untuk instance individual menggunakan AWS STS](#register-on-premises-instance-iam-session-arn-2)
+ *credentials-file*adalah lokasi file kredensil untuk sesi sementara ARN, seperti yang disebutkan dalam. [Langkah 2: Hasilkan kredensil sementara untuk instance individual menggunakan AWS STS](#register-on-premises-instance-iam-session-arn-2)
+ *supported-region*adalah salah satu daerah yang CodeDeploy mendukung, seperti yang tercantum di [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*.
## Langkah 4: Siapkan instans lokal untuk penerapan CodeDeploy
**Instal dan konfigurasikan AWS CLI **
Instal dan konfigurasikan instans lokal AWS CLI di tempat. (Ini AWS CLI akan digunakan untuk mengunduh dan menginstal CodeDeploy agen pada instance lokal.)
1. Untuk menginstal instans lokal, ikuti petunjuk di [Menyiapkan instans AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
**catatan**
CodeDeploy perintah untuk bekerja dengan instance lokal menjadi tersedia di versi 1.7.19 dari. AWS CLI Jika Anda memiliki versi yang AWS CLI sudah diinstal, Anda dapat memeriksa versinya dengan menelepon**aws --version**.
1. Untuk mengonfigurasi instans lokal, ikuti petunjuk dalam [Mengonfigurasi AWS CLI di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) *Panduan Pengguna*. AWS CLI
**penting**
Saat Anda mengonfigurasi AWS CLI (misalnya, dengan memanggil **aws configure** perintah), pastikan untuk menentukan ID kunci rahasia dan kunci akses rahasia dari pengguna IAM yang memiliki, setidaknya, izin yang dijelaskan dalam. [Prasyarat pendaftaran ARN sesi IAM](#register-on-premises-instance-iam-session-arn-prerequisites)
**Mengatur Variabel AWS\$1REGION Lingkungan (Ubuntu Server dan RHEL Only)**
Jika Anda tidak menjalankan Ubuntu Server atau RHEL pada instans lokal Anda, lewati langkah ini dan langsung ke “Instal CodeDeploy agen.”
Instal CodeDeploy agen di Server Ubuntu atau instans lokal RHEL dan aktifkan instance untuk memperbarui CodeDeploy agen setiap kali versi baru tersedia. Anda melakukan ini dengan menyetel variabel `AWS_REGION` lingkungan pada instance ke pengidentifikasi salah satu wilayah yang didukung oleh CodeDeploy. Kami menyarankan Anda menetapkan nilai ke wilayah tempat CodeDeploy aplikasi, grup penyebaran, dan revisi aplikasi Anda berada (misalnya,`us-west-2`). Untuk daftar wilayah, lihat [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS*
Untuk mengatur variabel lingkungan, panggil yang berikut ini dari terminal:
```
export AWS_REGION=supported-region
```
Di *supported-region* mana pengenal wilayah (misalnya,`us-west-2`).
**Instal CodeDeploy agen**
+ Untuk instance lokal Server Ubuntu, ikuti petunjuknya[Instal CodeDeploy agen untuk Server Ubuntu](codedeploy-agent-operations-install-ubuntu.md), lalu kembali ke halaman ini.
+ Untuk instance lokal RHEL, ikuti petunjuknya[Instal CodeDeploy agen untuk Amazon Linux atau RHEL](codedeploy-agent-operations-install-linux.md), lalu kembali ke halaman ini.
+ Untuk instance lokal Windows Server, ikuti petunjuknya[Instal CodeDeploy agen untuk Windows Server](codedeploy-agent-operations-install-windows.md), lalu kembali ke halaman ini.
## Langkah 5: Daftarkan instans lokal dengan CodeDeploy
Petunjuk dalam langkah ini mengasumsikan Anda mendaftarkan instans lokal dari instans lokal itu sendiri. Anda dapat mendaftarkan instans lokal dari perangkat atau instans terpisah yang telah AWS CLI diinstal dan dikonfigurasi.
Gunakan AWS CLI untuk mendaftarkan instance lokal CodeDeploy sehingga dapat digunakan dalam penerapan.
Sebelum Anda dapat menggunakan AWS CLI, Anda akan memerlukan ARN dari kredenal sesi sementara yang Anda buat. [Langkah 3: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-session-arn-3) Misalnya, untuk contoh yang Anda identifikasi sebagai`AssetTag12010298EX`:
```
arn:sts:iam::123456789012:assumed-role/CodeDeployInstanceRole/AssetTag12010298EX
```
Panggil [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah, tentukan:
+ Nama yang secara unik mengidentifikasi instance lokal (dengan opsi). `--instance-name`
**penting**
Untuk membantu mengidentifikasi instans lokal, terutama untuk tujuan debugging, kami sangat menyarankan Anda menentukan nama yang memetakan ke beberapa karakteristik unik instans lokal (misalnya, nama sesi kredenal STS dan nomor seri atau pengenal aset internal, jika berlaku). Jika Anda menentukan alamat MAC sebagai nama, ketahuilah bahwa alamat MAC berisi karakter yang CodeDeploy tidak mengizinkan, seperti titik dua (:). Untuk daftar karakter yang diizinkan, lihat[CodeDeploy kuota](limits.md).
+ ARN sesi IAM yang Anda atur untuk mengautentikasi beberapa instans lokal. [Langkah 1: Buat peran IAM yang akan diasumsikan oleh instans lokal](#register-on-premises-instance-iam-session-arn-1)
Contoh:
```
aws deploy register-on-premises-instance --instance-name name-of-instance --iam-session-arn arn:aws:sts::account-id:assumed-role/role-to-assume/session-name
```
Di mana:
+ *name-of-instance*adalah nama yang Anda gunakan untuk mengidentifikasi instance lokal, seperti`AssetTag12010298EX`.
+ *account-id*adalah ID akun 12 digit untuk organisasi Anda, seperti`111222333444`.
+ *role-to-assume*adalah nama peran IAM yang Anda buat untuk instance, seperti`CodeDeployInstanceRole`.
+ *session-name*adalah nama peran sesi yang Anda tentukan[Langkah 2: Hasilkan kredensil sementara untuk instance individual menggunakan AWS STS](#register-on-premises-instance-iam-session-arn-2).
## Langkah 6: Tandai instans lokal
Anda dapat menggunakan konsol AWS CLI atau CodeDeploy konsol untuk menandai instans lokal. (CodeDeploymenggunakan tag instans lokal untuk mengidentifikasi target penerapan selama penerapan.)
**Untuk menandai instance lokal (CLI)**
+ Panggil perintah [add-tags-to-on-premises-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/add-tags-to-on-premises-instances.html), dengan menentukan:
+ Nama yang secara unik mengidentifikasi instance lokal (dengan opsi). `--instance-names`
+ Nama kunci tag instans lokal dan nilai tag yang ingin Anda gunakan (dengan `--tags` opsi). Anda harus menentukan nama dan nilai. CodeDeploy tidak mengizinkan tag instance lokal yang hanya memiliki nilai.
Contoh:
```
aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem
```
**Untuk menandai instance lokal (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Di panel navigasi, perluas **Deploy**, dan pilih Instans **lokal**.
1. Dalam daftar instance lokal, pilih nama instans lokal yang ingin Anda tag.
1. Dalam daftar tag, pilih atau masukkan kunci tag dan nilai tag yang diinginkan. Setelah Anda memasukkan kunci tag dan nilai tag, baris lain muncul. Anda dapat mengulangi ini hingga 10 tag. Untuk menghapus sebuah tag, pilih **Hapus**.
1. Setelah Anda menambahkan tag, pilih **Perbarui Tag**.
## Langkah 7: Menerapkan revisi aplikasi ke instans lokal
Anda sekarang siap untuk menerapkan revisi aplikasi ke instans lokal yang terdaftar dan diberi tag.
Anda menerapkan revisi aplikasi ke instans lokal dengan cara yang mirip dengan menerapkan revisi aplikasi ke instans Amazon EC2. Untuk petunjuk, lihat [Buat penerapan dengan CodeDeploy](deployments-create.md). Instruksi ini mencakup tautan ke prasyarat, termasuk membuat aplikasi, membuat grup penyebaran, dan menyiapkan revisi aplikasi. Jika Anda memerlukan contoh revisi aplikasi sederhana untuk diterapkan, Anda dapat membuat yang dijelaskan [Langkah 2: Buat contoh revisi aplikasi](tutorials-on-premises-instance-2-create-sample-revision.md) dalam. [Tutorial: Menerapkan aplikasi ke instans lokal dengan CodeDeploy (Windows Server, Ubuntu Server, atau Red Hat Enterprise Linux)](tutorials-on-premises-instance.md)
**penting**
Jika Anda menggunakan kembali peran CodeDeploy layanan sebagai bagian dari pembuatan grup penerapan yang menargetkan instance lokal, Anda `Tag:get*` harus menyertakan `Action` bagian pernyataan kebijakan peran layanan. Untuk informasi selengkapnya, lihat [Langkah 2: Buat peran layanan untuk CodeDeploy](getting-started-create-service-role.md).
## Langkah 8: Lacak penerapan ke instans lokal
Setelah menerapkan revisi aplikasi ke instans lokal yang terdaftar dan ditandai, Anda dapat melacak kemajuan penerapan.
Anda melacak penerapan ke instans lokal dengan cara yang mirip dengan melacak penerapan ke instans Amazon EC2. Untuk petunjuk, lihat [Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Gunakan perintah register (ARN pengguna IAM) untuk mendaftarkan instans lokal
**penting**
Mendaftarkan instance menggunakan pengguna IAM tidak disarankan karena menggunakan kredensi statis (permanen) untuk otentikasi. Untuk keamanan yang lebih baik, sebaiknya daftarkan instans menggunakan kredensi sementara untuk otentikasi. Untuk informasi selengkapnya, lihat [Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
**penting**
Pastikan Anda memiliki rencana untuk memutar kunci akses pengguna IAM (kredensi permanen). Untuk informasi selengkapnya, lihat [Memutar kunci akses](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey).
Bagian ini menjelaskan cara mengonfigurasi instans lokal dan mendaftar serta menandainya CodeDeploy dengan upaya paling sedikit. **register**Perintah ini paling berguna saat Anda bekerja dengan armada tunggal atau kecil instance lokal. Anda dapat menggunakan **register** perintah hanya ketika Anda menggunakan ARN pengguna IAM untuk mengautentikasi sebuah instance. Anda tidak dapat menggunakan **register** perintah dengan ARN sesi IAM untuk otentikasi.
Bila Anda menggunakan **register** perintah, Anda dapat membiarkan CodeDeploy melakukan hal berikut:
+ Buat pengguna IAM AWS Identity and Access Management untuk instance lokal, jika Anda tidak menentukannya dengan perintah.
+ Simpan kredensi pengguna IAM ke file konfigurasi instans lokal.
+ Daftarkan instance lokal dengan CodeDeploy.
+ Tambahkan tag ke instance lokal, jika Anda menentukannya sebagai bagian dari perintah.
**catatan**
[register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)Perintah adalah alternatif dari perintah [register](https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html). Anda menggunakan **register-on-premises-instance** perintah jika Anda ingin mengonfigurasi instans lokal dan mendaftar dan menandainya dengan CodeDeploy sebagian besar milik Anda sendiri. **register-on-premises-instance**Perintah ini juga memberi Anda opsi untuk menggunakan ARN sesi IAM untuk mendaftarkan instance alih-alih ARN pengguna IAM. Pendekatan ini memberikan keuntungan besar jika Anda memiliki armada besar instance lokal. Secara khusus, Anda dapat menggunakan ARN sesi IAM tunggal untuk mengautentikasi beberapa instance alih-alih harus membuat pengguna IAM untuk setiap instans lokal satu per satu. Untuk informasi selengkapnya, lihat [Gunakan register-on-premises-instance perintah (ARN pengguna IAM) untuk mendaftarkan instance lokal](register-on-premises-instance-iam-user-arn.md) dan [Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
**Topics**
+ [Langkah 1: Instal dan AWS CLI konfigurasikan instans lokal](#instances-on-premises-register-instance-1-install-cli)
+ [Langkah 2: Panggil perintah register](#instances-on-premises-register-instance-2-register-command)
+ [Langkah 3: Panggil perintah instal](#instances-on-premises-register-instance-3-install-command)
+ [Langkah 4: Menerapkan revisi aplikasi ke instans lokal](#instances-on-premises-register-instance-4-deploy-revision)
+ [Langkah 5: Lacak penerapan ke instans lokal](#instances-on-premises-register-instance-5-track-deployment)
## Langkah 1: Instal dan AWS CLI konfigurasikan instans lokal
1. Instal AWS CLI instans lokal di tempat. Ikuti petunjuk di [Menyiapkan dengan AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) *Panduan AWS Command Line Interface Pengguna*.
**catatan**
CodeDeploy perintah untuk bekerja dengan instance lokal tersedia di AWS CLI versi 1.7.19 dan yang lebih baru. Jika Anda AWS CLI sudah menginstal, hubungi **aws --version** untuk memeriksa versinya.
1. Konfigurasikan AWS CLI instans lokal di tempat. Ikuti petunjuk dalam [Mengkonfigurasi](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) *Panduan AWS Command Line Interface Pengguna AWS CLI* di.
**penting**
Saat Anda mengonfigurasi AWS CLI (misalnya, dengan memanggil **aws configure** perintah), pastikan untuk menentukan ID kunci rahasia dan kunci akses rahasia dari pengguna IAM yang memiliki, setidaknya, izin AWS akses berikut selain izin yang ditentukan dalam. [Prasyarat untuk mengonfigurasi instans lokal](instances-on-premises-prerequisites.md) Hal ini memungkinkan untuk mengunduh dan menginstal CodeDeploy agen pada instans lokal. Izin akses mungkin terlihat mirip dengan ini:
****
```
{
"Version":"2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"codedeploy:*",
"iam:CreateAccessKey",
"iam:CreateUser",
"iam:DeleteAccessKey",
"iam:DeleteUser",
"iam:DeleteUserPolicy",
"iam:ListAccessKeys",
"iam:ListUserPolicies",
"iam:PutUserPolicy",
"iam:GetUser",
"tag:getTagKeys",
"tag:getTagValues",
"tag:GetResources"
],
"Resource" : "*"
},
{
"Effect" : "Allow",
"Action" : [
"s3:Get*",
"s3:List*"
],
"Resource" : [
"arn:aws:s3:::amzn-s3-demo-bucket/*",
"arn:aws:s3:::amzn-s3-demo-bucket1/*"
]
}
]
}
```
Jika Anda melihat kesalahan akses ditolak saat mencoba mengakses salah satu bucket Amazon S3 yang ditampilkan sebelumnya, coba hilangkan `/*` bagian ARN sumber daya bucket, misalnya,. `arn:aws:s3:::aws-codedeploy-sa-east-1`
****
```
{
"Version":"2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"codedeploy:*",
"iam:CreateAccessKey",
"iam:CreateUser",
"iam:DeleteAccessKey",
"iam:DeleteUser",
"iam:DeleteUserPolicy",
"iam:ListAccessKeys",
"iam:ListUserPolicies",
"iam:PutUserPolicy",
"iam:GetUser",
"tag:GetResources"
],
"Resource" : "*"
},
{
"Effect" : "Allow",
"Action" : [
"s3:Get*",
"s3:List*"
],
"Resource" : [
"arn:aws:s3:::amzn-s3-demo-bucket/*",
"arn:aws:s3:::amzn-s3-demo-bucket2/*"
]
}
]
}
```
## Langkah 2: Panggil perintah register
Untuk langkah ini, kami berasumsi Anda mendaftarkan instans lokal dari instans lokal itu sendiri. Anda juga dapat mendaftarkan instans lokal dari perangkat atau instans terpisah yang telah AWS CLI diinstal dan dikonfigurasi seperti yang dijelaskan pada langkah sebelumnya.
Gunakan AWS CLI untuk memanggil perintah [register](https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html), dengan menentukan:
+ Nama yang secara unik mengidentifikasi instance lokal CodeDeploy (dengan opsi). `--instance-name`
**penting**
Untuk membantu mengidentifikasi instans lokal nanti, terutama untuk tujuan debugging, kami sangat menyarankan Anda menggunakan nama yang memetakan ke beberapa karakteristik unik instans lokal (misalnya, nomor seri atau beberapa pengenal aset internal unik, jika berlaku). Jika Anda menentukan alamat MAC untuk sebuah nama, ketahuilah bahwa alamat MAC berisi karakter yang CodeDeploy tidak mengizinkan, seperti titik dua (`:`). Untuk daftar karakter yang diizinkan, lihat[CodeDeploy kuota](limits.md).
+ Secara opsional, ARN pengguna IAM yang sudah ada yang ingin Anda kaitkan dengan instance lokal ini (dengan opsi). `--iam-user-arn` **Untuk mendapatkan ARN dari pengguna IAM, panggil perintah [get-user](https://docs.aws.amazon.com/cli/latest/reference/iam/get-user.html), atau pilih nama pengguna IAM di bagian **Pengguna** konsol IAM dan kemudian temukan nilai **ARN** Pengguna di bagian Ringkasan.** Jika opsi ini tidak ditentukan, CodeDeploy akan membuat pengguna IAM atas nama Anda di AWS akun Anda dan mengaitkannya dengan instans lokal.
**penting**
Jika Anda menentukan `--iam-user-arn` opsi, Anda juga harus membuat file konfigurasi instans lokal secara manual, seperti yang dijelaskan dalam[Langkah 4: Tambahkan file konfigurasi ke instans lokal](register-on-premises-instance-iam-user-arn.md#register-on-premises-instance-iam-user-arn-4).
Anda hanya dapat mengaitkan satu pengguna IAM hanya dengan satu instans lokal. Mencoba mengaitkan satu pengguna IAM dengan beberapa instans lokal dapat mengakibatkan kesalahan, penerapan gagal ke instans lokal tersebut, atau penerapan ke instans lokal yang terjebak dalam status tertunda yang terus-menerus.
+ Secara opsional, satu set tag instans lokal (dengan `--tags` opsi) yang CodeDeploy akan digunakan untuk mengidentifikasi kumpulan instans Amazon EC2 yang akan digunakan. Tentukan setiap tag dengan `Key=tag-key,Value=tag-value` (misalnya,`Key=Name,Value=Beta Key=Name,Value=WestRegion`). Jika opsi ini tidak ditentukan, tidak ada tag yang akan didaftarkan. Untuk mendaftarkan tag nanti, panggil perintah [add-tags-to-on-premises-instances.](https://docs.aws.amazon.com/cli/latest/reference/deploy/add-tags-to-on-premises-instances.html)
+ Secara opsional, AWS wilayah tempat instans lokal akan didaftarkan CodeDeploy (dengan `--region` opsi). Ini harus menjadi salah satu wilayah yang didukung yang terdaftar di [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*(misalnya,`us-west-2`). Jika opsi ini tidak ditentukan, AWS wilayah default yang terkait dengan pengguna IAM panggilan akan digunakan.
Contoh:
```
aws deploy register --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem --tags Key=Name,Value=CodeDeployDemo-OnPrem --region us-west-2
```
**register**Perintah melakukan hal berikut:
1. Jika tidak ada pengguna IAM yang ditentukan, buat pengguna IAM, lampirkan izin yang diperlukan padanya, dan buat kunci rahasia dan kunci akses rahasia yang sesuai. Instans lokal akan menggunakan pengguna IAM ini dan izin serta kredensialnya untuk mengautentikasi dan berinteraksi dengannya. CodeDeploy
1. Mendaftarkan instance lokal dengan. CodeDeploy
1. Jika ditentukan, asosiasi CodeDeploy dalam tag yang ditentukan dengan `--tags` opsi dengan nama instans lokal yang terdaftar.
1. Jika pengguna IAM dibuat, juga membuat file konfigurasi yang diperlukan di direktori yang sama dari mana **register** perintah dipanggil.
Jika perintah ini menemukan kesalahan, pesan kesalahan muncul, menjelaskan bagaimana Anda dapat menyelesaikan langkah-langkah yang tersisa secara manual. Jika tidak, pesan sukses muncul, menjelaskan cara memanggil **install** perintah seperti yang tercantum pada langkah berikutnya.
## Langkah 3: Panggil perintah instal
Dari instance lokal, gunakan AWS CLI untuk memanggil perintah [install](https://docs.aws.amazon.com/cli/latest/reference/deploy/install.html), dengan menentukan:
+ Jalur ke file konfigurasi (dengan `--config-file` opsi).
+ Secara opsional, apakah akan mengganti file konfigurasi yang sudah ada pada instance lokal (dengan `--override-config` opsi). Jika tidak ditentukan, file konfigurasi yang ada tidak akan diganti.
+ Secara opsional, AWS wilayah tempat instans lokal akan didaftarkan CodeDeploy (dengan `--region` opsi). Ini harus menjadi salah satu wilayah yang didukung yang terdaftar di [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*(misalnya,`us-west-2`). Jika opsi ini tidak ditentukan, AWS wilayah default yang terkait dengan pengguna IAM panggilan akan digunakan.
+ Secara opsional, lokasi khusus untuk menginstal CodeDeploy agen (dengan `--agent-installer` opsi). Opsi ini berguna untuk menginstal versi khusus CodeDeploy agen yang CodeDeploy tidak mendukung secara resmi (seperti versi khusus berdasarkan repositori [CodeDeployagen](https://github.com/aws/aws-codedeploy-agent) di GitHub). Nilai harus berupa jalur ke bucket Amazon S3 yang berisi:
+ Skrip instalasi CodeDeploy agen (untuk sistem operasi berbasis Linux atau Unix, mirip dengan file instal di repositori [CodeDeployagen](https://github.com/aws/aws-codedeploy-agent/blob/master/bin/install) di). GitHub
+ File paket penginstal CodeDeploy agen (.msi) (untuk sistem operasi berbasis Windows).
Jika opsi ini tidak ditentukan, CodeDeploy akan melakukan upaya terbaik untuk menginstal dari lokasinya sendiri versi CodeDeploy agen yang didukung secara resmi yang kompatibel dengan sistem operasi pada instans lokal.
Contoh:
```
aws deploy install --override-config --config-file /tmp/codedeploy.onpremises.yml --region us-west-2 --agent-installer s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi
```
**install**Perintah melakukan hal berikut:
1. Memeriksa apakah instans lokal adalah instans Amazon EC2. Jika ya, pesan kesalahan muncul.
1. Menyalin file konfigurasi instans lokal dari lokasi yang ditentukan pada instance ke lokasi yang diharapkan CodeDeploy agen untuk menemukannya, asalkan file tersebut belum berada di lokasi tersebut.
Untuk Ubuntu Server dan Red Hat Enterprise Linux (RHEL)), ini adalah`/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`.
Untuk Windows Server, ini adalah`C:\ProgramData\Amazon\CodeDeploy`\$1`conf.onpremises.yml`.
Jika `--override-config` opsi ditentukan, membuat atau menimpa file.
1. Menginstal CodeDeploy agen pada instance lokal dan kemudian memulainya.
## Langkah 4: Menerapkan revisi aplikasi ke instans lokal
Anda sekarang siap untuk menerapkan revisi aplikasi ke instans lokal yang terdaftar dan diberi tag.
Anda menerapkan revisi aplikasi ke instans lokal dengan cara yang mirip dengan menerapkan revisi aplikasi ke instans Amazon EC2. Untuk petunjuk, lihat [Buat penerapan dengan CodeDeploy](deployments-create.md). Instruksi ini menautkan ke prasyarat, termasuk membuat aplikasi, membuat grup penyebaran, dan menyiapkan revisi aplikasi. Jika Anda memerlukan contoh revisi aplikasi sederhana untuk diterapkan, Anda dapat membuat yang dijelaskan [Langkah 2: Buat contoh revisi aplikasi](tutorials-on-premises-instance-2-create-sample-revision.md) dalam. [Tutorial: Menerapkan aplikasi ke instans lokal dengan CodeDeploy (Windows Server, Ubuntu Server, atau Red Hat Enterprise Linux)](tutorials-on-premises-instance.md)
**penting**
Jika Anda menggunakan kembali peran CodeDeploy layanan yang ada sebagai bagian dari pembuatan grup penerapan yang menargetkan instance lokal, Anda `Tag:get*` harus menyertakan `Action` bagian pernyataan kebijakan peran layanan. Untuk informasi selengkapnya, lihat [Langkah 2: Buat peran layanan untuk CodeDeploy](getting-started-create-service-role.md).
## Langkah 5: Lacak penerapan ke instans lokal
Setelah menerapkan revisi aplikasi ke instans lokal yang terdaftar dan ditandai, Anda dapat melacak kemajuan penerapan.
Anda melacak penerapan ke instans lokal dengan cara yang mirip dengan melacak penerapan ke instans Amazon EC2. Untuk petunjuk, lihat [Lihat CodeDeploy detail penerapan](deployments-view-details.md).
Untuk opsi lainnya, lihat[Mengelola operasi instans lokal di CodeDeploy](on-premises-instances-operations.md).
# Gunakan register-on-premises-instance perintah (ARN pengguna IAM) untuk mendaftarkan instance lokal
**penting**
Mendaftarkan instance menggunakan pengguna IAM tidak disarankan karena menggunakan kredensi statis (permanen) untuk otentikasi. Untuk keamanan yang lebih baik, sebaiknya daftarkan instans menggunakan kredensi sementara untuk otentikasi. Untuk informasi selengkapnya, lihat [Gunakan register-on-premises-instance perintah (ARN Sesi IAM) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
**penting**
Pastikan Anda memiliki rencana untuk memutar kunci akses pengguna IAM (kredensi permanen). Untuk informasi selengkapnya, lihat [Memutar kunci akses](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey).
Ikuti petunjuk ini untuk mengonfigurasi instans lokal dan mendaftar dan menandainya dengan CodeDeploy sebagian besar milik Anda sendiri, menggunakan kredensil pengguna IAM statis untuk autentikasi.
**Topics**
+ [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1)
+ [Langkah 2: Tetapkan izin untuk pengguna IAM](#register-on-premises-instance-iam-user-arn-2)
+ [Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3)
+ [Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4)
+ [Langkah 5: Instal dan konfigurasikan AWS CLI](#register-on-premises-instance-iam-user-arn-5)
+ [Langkah 6: Mengatur variabel AWS\$1REGION lingkungan (Ubuntu Server dan RHEL saja)](#register-on-premises-instance-iam-user-arn-6)
+ [Langkah 7: Instal CodeDeploy agen](#register-on-premises-instance-iam-user-arn-7)
+ [Langkah 8: Daftarkan instans lokal dengan CodeDeploy](#register-on-premises-instance-iam-user-arn-8)
+ [Langkah 9: Tandai instance lokal](#register-on-premises-instance-iam-user-arn-9)
+ [Langkah 10: Menerapkan revisi aplikasi ke instans lokal](#register-on-premises-instance-iam-user-arn-10)
+ [Langkah 11: Lacak penerapan ke instans lokal](#register-on-premises-instance-iam-user-arn-11)
## Langkah 1: Buat pengguna IAM untuk instans lokal
Buat pengguna IAM yang akan digunakan instans lokal untuk mengautentikasi dan berinteraksi. CodeDeploy
**penting**
Anda harus membuat pengguna IAM terpisah untuk setiap instans lokal yang berpartisipasi. Jika Anda mencoba menggunakan kembali pengguna IAM individual untuk beberapa instans lokal, Anda mungkin tidak dapat berhasil mendaftarkan atau menandai instans lokal tersebut. CodeDeploy Penerapan ke instans lokal tersebut mungkin macet dalam status tertunda terus-menerus atau gagal sama sekali.
Kami menyarankan Anda menetapkan nama pengguna IAM yang mengidentifikasi tujuannya, seperti -. CodeDeployUser OnPrem
Anda dapat menggunakan AWS CLI atau konsol IAM untuk membuat pengguna IAM. Untuk selengkapnya, lihat [Membuat pengguna IAM di AWS akun Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).
**penting**
Baik Anda menggunakan konsol IAM AWS CLI atau IAM untuk membuat pengguna IAM baru, catat pengguna ARN yang disediakan untuk pengguna. Anda akan membutuhkan informasi ini nanti [Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4) dan[Langkah 8: Daftarkan instans lokal dengan CodeDeploy](#register-on-premises-instance-iam-user-arn-8).
## Langkah 2: Tetapkan izin untuk pengguna IAM
Jika instans lokal Anda akan menerapkan revisi aplikasi dari bucket Amazon S3, Anda harus menetapkan izin kepada pengguna IAM untuk berinteraksi dengan bucket tersebut. Anda dapat menggunakan AWS CLI atau konsol IAM untuk menetapkan izin.
**catatan**
Jika Anda akan menerapkan revisi aplikasi hanya dari GitHub repositori, lewati langkah ini dan langsung ke. [Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3) (Anda masih memerlukan informasi tentang pengguna IAM yang Anda buat. [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) Ini akan digunakan pada langkah-langkah selanjutnya.)
**Untuk menetapkan izin (CLI)**
1. Buat file dengan konten kebijakan berikut di instans Amazon EC2 atau perangkat yang Anda gunakan untuk memanggil file. AWS CLI Beri nama file seperti**CodeDeploy-OnPrem-Permissions.json**, lalu simpan file tersebut.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
**catatan**
Sebaiknya batasi kebijakan ini hanya pada bucket Amazon S3 yang perlu diakses instans lokal. Jika Anda membatasi kebijakan ini, pastikan juga memberikan akses ke bucket Amazon S3 yang berisi agen. AWS CodeDeploy Jika tidak, kesalahan dapat terjadi setiap kali CodeDeploy agen diinstal atau diperbarui pada instans lokal terkait.
Contoh:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*",
"arn:aws:s3:::aws-codedeploy-us-east-2/*",
"arn:aws:s3:::aws-codedeploy-us-east-1/*",
"arn:aws:s3:::aws-codedeploy-us-west-1/*",
"arn:aws:s3:::aws-codedeploy-us-west-2/*",
"arn:aws:s3:::aws-codedeploy-ca-central-1/*",
"arn:aws:s3:::aws-codedeploy-eu-west-1/*",
"arn:aws:s3:::aws-codedeploy-eu-west-2/*",
"arn:aws:s3:::aws-codedeploy-eu-west-3/*",
"arn:aws:s3:::aws-codedeploy-eu-central-1/*",
"arn:aws:s3:::aws-codedeploy-eu-central-2/*",
"arn:aws:s3:::aws-codedeploy-eu-north-1/*",
"arn:aws:s3:::aws-codedeploy-eu-south-1/*",
"arn:aws:s3:::aws-codedeploy-eu-south-2/*",
"arn:aws:s3:::aws-codedeploy-il-central-1/*",
"arn:aws:s3:::aws-codedeploy-ap-east-1/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
"arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
"arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
"arn:aws:s3:::aws-codedeploy-ap-south-1/*",
"arn:aws:s3:::aws-codedeploy-ap-south-2/*",
"arn:aws:s3:::aws-codedeploy-me-central-1/*",
"arn:aws:s3:::aws-codedeploy-me-south-1/*",
"arn:aws:s3:::aws-codedeploy-sa-east-1/*"
]
}
]
}
```
1. Panggil [put-user-policy](https://docs.aws.amazon.com/cli/latest/reference/iam/put-user-policy.html)perintah, tentukan nama pengguna IAM (dengan `--user-name` opsi), nama untuk kebijakan (dengan `--policy-name` opsi), dan jalur ke dokumen kebijakan yang baru dibuat (dengan `--policy-document` opsi). Misalnya, dengan asumsi bahwa **CodeDeploy-OnPrem-Permissions.json** file tersebut berada di direktori (folder) yang sama dari mana Anda memanggil perintah ini:
**penting**
Pastikan untuk menyertakan `file://` sebelum nama file. Diperlukan dalam perintah ini.
```
aws iam put-user-policy --user-name CodeDeployUser-OnPrem --policy-name CodeDeploy-OnPrem-Permissions --policy-document file://CodeDeploy-OnPrem-Permissions.json
```
**Untuk menetapkan izin (konsol)**
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Pada panel navigasi, pilih **Kebijakan**, lalu pilih **Buat kebijakan**. (Jika tombol **Memulai** muncul, pilihlah, lalu pilih **Buat Kebijakan**.)
1. Di sebelah **Buat Kebijakan Anda Sendiri**, pilih **Pilih**.
1. Di kotak **Nama Kebijakan**, ketikkan nama untuk kebijakan ini (misalnya,**CodeDeploy-OnPrem-Permissions**).
1. Di kotak **Dokumen Kebijakan**, ketik atau tempel ekspresi izin berikut, yang memungkinkan AWS CodeDeploy untuk menerapkan revisi aplikasi dari bucket Amazon S3 apa pun yang ditentukan dalam kebijakan ke instans lokal atas nama pengguna IAM:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
1. Pilih **Buat Kebijakan**.
1. Di panel navigasi, pilih **Users** (Pengguna).
1. Dalam daftar pengguna, telusuri dan pilih nama pengguna IAM yang Anda buat. [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1)
1. Pada tab **Izin**, di **Kebijakan Terkelola**, pilih **Lampirkan Kebijakan**.
1. Pilih kebijakan bernama**CodeDeploy-OnPrem-Permissions**, lalu pilih **Lampirkan Kebijakan**.
## Langkah 3: Dapatkan kredensil pengguna IAM
Dapatkan ID kunci rahasia dan kunci akses rahasia untuk pengguna IAM. Anda akan membutuhkannya untuk[Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4). Anda dapat menggunakan AWS CLI atau konsol IAM untuk mendapatkan ID kunci rahasia dan kunci akses rahasia.
**catatan**
Jika Anda sudah memiliki ID kunci rahasia dan kunci akses rahasia, lewati langkah ini dan langsung ke[Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4).
Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS.
Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut.
****
| Pengguna mana yang membutuhkan akses programatis? | Untuk | Oleh |
| --- | --- | --- |
| IAM | (Disarankan) Gunakan kredenal konsol sebagai kredensil sementara untuk menandatangani permintaan terprogram ke,, atau. AWS CLI AWS SDKs AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/register-on-premises-instance-iam-user-arn.html) |
| Identitas tenaga kerja (Pengguna yang dikelola di Pusat Identitas IAM) | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/register-on-premises-instance-iam-user-arn.html) |
| IAM | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk dalam [Menggunakan kredensil sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna IAM. |
| IAM | (Tidak direkomendasikan)Gunakan kredensi jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/register-on-premises-instance-iam-user-arn.html) |
**Untuk mendapatkan kredensialnya (CLI)**
1. Panggil [list-access-keys](https://docs.aws.amazon.com/cli/latest/reference/iam/list-access-keys.html)perintah, tentukan nama pengguna IAM (dengan `--user-name` opsi) dan kueri hanya untuk kunci akses IDs (dengan opsi `--query` dan`--output`). Contoh:
```
aws iam list-access-keys --user-name CodeDeployUser-OnPrem --query "AccessKeyMetadata[*].AccessKeyId" --output text
```
1. Jika tidak ada kunci yang muncul di output atau informasi tentang hanya satu kunci yang muncul di output, panggil [create-access-key](https://docs.aws.amazon.com/cli/latest/reference/iam/create-access-key.html)perintah, tentukan nama pengguna IAM (dengan `--user-name` opsi):
```
aws iam create-access-key --user-name CodeDeployUser-OnPrem
```
Dalam output panggilan ke **create-access-key** perintah, perhatikan nilai `AccessKeyId` dan `SecretAccessKey` bidang. Anda akan membutuhkan informasi ini di[Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4).
**penting**
Ini akan menjadi satu-satunya saat Anda akan memiliki akses ke kunci akses rahasia ini. Jika Anda lupa atau kehilangan akses ke kunci akses rahasia ini, Anda harus membuat yang baru dengan mengikuti langkah-langkahnya[Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3).
1. Jika dua kunci akses sudah terdaftar, Anda harus menghapus salah satunya dengan memanggil [delete-access-key](https://docs.aws.amazon.com/cli/latest/reference/iam/delete-access-key.html)perintah, menentukan nama pengguna IAM (dengan `--user-name` opsi), dan ID kunci akses untuk dihapus (dengan `--access-key-id` opsi). Kemudian panggil **create-access-key** perintah, seperti yang dijelaskan sebelumnya dalam langkah ini. Berikut adalah contoh memanggil **delete-access-key** perintah:
```
aws iam delete-access-key --user-name CodeDeployUser-OnPrem --access-key-id access-key-ID
```
**penting**
Jika Anda memanggil **delete-access-key** perintah untuk menghapus salah satu kunci akses ini, dan instans lokal sudah menggunakan kunci akses ini seperti yang dijelaskan dalam[Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4), Anda harus mengikuti instruksi [Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4) lagi untuk menentukan ID kunci akses yang berbeda dan kunci akses rahasia yang terkait dengan pengguna IAM ini. Jika tidak, penerapan apa pun ke instans lokal tersebut mungkin macet dalam status tertunda terus-menerus atau gagal sama sekali.
**Untuk mendapatkan kredensil (konsol)**
1.
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Jika daftar pengguna tidak ditampilkan, di panel navigasi, pilih **Pengguna**.
1. Dalam daftar pengguna, telusuri dan pilih nama pengguna IAM yang Anda buat. [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1)
1. Pada tab **Security credentials**, jika tidak ada kunci atau hanya satu kunci yang terdaftar, pilih **Buat kunci akses**.
Jika dua kunci akses terdaftar, Anda harus menghapus salah satunya. Pilih **Hapus** di samping salah satu tombol akses, lalu pilih **Buat kunci akses**.
**penting**
Jika Anda memilih **Hapus** di samping salah satu kunci akses ini, dan instans lokal sudah menggunakan kunci akses ini seperti yang dijelaskan dalam[Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4), Anda harus mengikuti instruksi [Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4) lagi untuk menentukan ID kunci akses yang berbeda dan kunci akses rahasia yang terkait dengan pengguna IAM ini. Jika tidak, penerapan ke instans lokal tersebut mungkin macet dalam status tertunda terus-menerus atau gagal sama sekali.
1. Pilih **Tampilkan** dan catat ID kunci akses dan kunci akses rahasia. Anda akan memerlukan informasi ini untuk langkah selanjutnya. Atau, Anda dapat memilih **Unduh file.csv** untuk menyimpan salinan ID kunci akses dan kunci akses rahasia.
**penting**
Kecuali Anda membuat catatan atau mengunduh kredensialnya, ini akan menjadi satu-satunya saat Anda memiliki akses ke kunci akses rahasia ini. Jika Anda lupa atau kehilangan akses ke kunci akses rahasia ini, Anda harus membuat yang baru dengan mengikuti langkah-langkahnya[Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3).
1. Pilih **Tutup** untuk kembali ke *IAM User Name* halaman **Pengguna>**.
## Langkah 4: Tambahkan file konfigurasi ke instans lokal
Tambahkan file konfigurasi ke instans lokal, menggunakan izin root atau administrator. File konfigurasi ini akan digunakan untuk mendeklarasikan kredenal pengguna IAM dan AWS wilayah target yang akan digunakan. CodeDeploy File harus ditambahkan ke lokasi tertentu pada instance lokal. File harus menyertakan ARN pengguna IAM, ID kunci rahasia, kunci akses rahasia, dan wilayah target. AWS File harus mengikuti format tertentu.
1. Membuat file bernama `codedeploy.onpremises.yml` (untuk Server Ubuntu atau instans lokal RHEL) atau `conf.onpremises.yml` (untuk instance lokal Windows Server) di lokasi berikut pada instans lokal:
+ Untuk Server Ubuntu: `/etc/codedeploy-agent/conf`
+ Untuk Windows Server: `C:\ProgramData\Amazon\CodeDeploy`
1. Gunakan editor teks untuk menambahkan informasi berikut ke `conf.onpremises.yml` file `codedeploy.onpremises.yml` atau yang baru dibuat:
```
---
aws_access_key_id: secret-key-id
aws_secret_access_key: secret-access-key
iam_user_arn: iam-user-arn
region: supported-region
```
Di mana:
+ *secret-key-id*adalah ID kunci rahasia pengguna IAM terkait yang Anda catat di [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) atau[Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3).
+ *secret-access-key*adalah kunci akses rahasia pengguna IAM terkait yang Anda catat di [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) atau[Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3).
+ *iam-user-arn*adalah ARN pengguna IAM yang Anda catat sebelumnya. [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1)
+ *supported-region*adalah pengenal wilayah yang didukung oleh CodeDeploy tempat CodeDeploy aplikasi, grup penyebaran, dan revisi aplikasi Anda berada (misalnya,). `us-west-2` Untuk daftar wilayah, lihat [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS*
**penting**
Jika Anda memilih **Hapus** di samping salah satu kunci akses[Langkah 3: Dapatkan kredensil pengguna IAM](#register-on-premises-instance-iam-user-arn-3), dan instans lokal Anda sudah menggunakan ID kunci akses terkait dan kunci akses rahasia, Anda harus mengikuti petunjuk [Langkah 4: Tambahkan file konfigurasi ke instans lokal](#register-on-premises-instance-iam-user-arn-4) untuk menentukan ID kunci akses dan kunci akses rahasia yang terkait dengan pengguna IAM ini. Jika tidak, penerapan apa pun ke instans lokal Anda mungkin macet dalam status tertunda terus-menerus atau gagal sama sekali.
## Langkah 5: Instal dan konfigurasikan AWS CLI
Instal dan konfigurasikan instans lokal AWS CLI di tempat. ( AWS CLI Ini akan digunakan [Langkah 7: Instal CodeDeploy agen](#register-on-premises-instance-iam-user-arn-7) untuk mengunduh dan menginstal CodeDeploy agen pada instance lokal.)
1. Untuk menginstal instans lokal, ikuti petunjuk di [Menyiapkan instans AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) *Panduan AWS Command Line Interface Pengguna*. AWS CLI
**catatan**
CodeDeploy perintah untuk bekerja dengan instance lokal menjadi tersedia di versi 1.7.19 dari. AWS CLI Jika Anda memiliki versi yang AWS CLI sudah diinstal, Anda dapat memeriksa versinya dengan menelepon**aws --version**.
1. Untuk mengonfigurasi instans lokal, ikuti petunjuk dalam [Mengonfigurasi AWS CLI di AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) *Panduan Pengguna*. AWS CLI
**penting**
Saat Anda mengonfigurasi AWS CLI (misalnya, dengan memanggil **aws configure** perintah), pastikan untuk menentukan ID kunci rahasia dan kunci akses rahasia dari pengguna IAM yang memiliki, setidaknya, izin AWS akses berikut selain izin akses yang ditentukan dalam. [Prasyarat untuk mengonfigurasi instans lokal](instances-on-premises-prerequisites.md) Hal ini memungkinkan Anda mengunduh dan menginstal CodeDeploy agen pada instans lokal:
****
```
{
"Version":"2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"codedeploy:*"
],
"Resource" : "*"
},
{
"Effect" : "Allow",
"Action" : [
"s3:Get*",
"s3:List*"
],
"Resource" : [
"arn:aws:s3:::amzn-s3-demo-bucket/*",
"arn:aws:s3:::amzn-s3-demo-bucket1/*"
]
}
]
}
```
****
```
{
"Version":"2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"codedeploy:*"
],
"Resource" : "*"
},
{
"Effect" : "Allow",
"Action" : [
"s3:Get*",
"s3:List*"
],
"Resource" : [
"*"
]
}
]
}
```
Izin akses ini dapat ditetapkan untuk pengguna IAM yang Anda buat [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) atau ke pengguna IAM yang berbeda. Untuk menetapkan izin ini ke pengguna IAM, ikuti instruksi di, menggunakan izin akses ini[Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1), bukan yang ada di langkah itu.
## Langkah 6: Mengatur variabel AWS\$1REGION lingkungan (Ubuntu Server dan RHEL saja)
Jika Anda tidak menjalankan Ubuntu Server atau RHEL pada instans lokal Anda, lewati langkah ini dan langsung ke. [Langkah 7: Instal CodeDeploy agen](#register-on-premises-instance-iam-user-arn-7)
Instal CodeDeploy agen di Server Ubuntu atau instans lokal RHEL dan aktifkan instans untuk memperbarui CodeDeploy agen setiap kali versi baru tersedia. Anda melakukan ini dengan menyetel variabel `AWS_REGION` lingkungan pada instance ke pengidentifikasi salah satu wilayah yang didukung oleh CodeDeploy. Kami menyarankan Anda menetapkan nilai ke wilayah tempat CodeDeploy aplikasi, grup penyebaran, dan revisi aplikasi Anda berada (misalnya,`us-west-2`). Untuk daftar wilayah, lihat [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS*
Untuk mengatur variabel lingkungan, panggil yang berikut dari terminal:
```
export AWS_REGION=supported-region
```
Di *supported-region* mana pengidentifikasi wilayah (misalnya,`us-west-2`).
## Langkah 7: Instal CodeDeploy agen
Instal CodeDeploy agen pada instance lokal:
+ Untuk instance lokal Server Ubuntu, ikuti petunjuknya[Instal CodeDeploy agen untuk Server Ubuntu](codedeploy-agent-operations-install-ubuntu.md), lalu kembali ke halaman ini.
+ Untuk instance lokal RHEL, ikuti petunjuknya[Instal CodeDeploy agen untuk Amazon Linux atau RHEL](codedeploy-agent-operations-install-linux.md), lalu kembali ke halaman ini.
+ Untuk instance lokal Windows Server, ikuti petunjuknya[Instal CodeDeploy agen untuk Windows Server](codedeploy-agent-operations-install-windows.md), lalu kembali ke halaman ini.
## Langkah 8: Daftarkan instans lokal dengan CodeDeploy
Petunjuk dalam langkah ini mengasumsikan Anda mendaftarkan instans lokal dari instans lokal itu sendiri. Anda dapat mendaftarkan instans lokal dari perangkat atau instans terpisah yang telah AWS CLI diinstal dan dikonfigurasi, seperti yang dijelaskan dalam[Langkah 5: Instal dan konfigurasikan AWS CLI](#register-on-premises-instance-iam-user-arn-5).
Gunakan AWS CLI untuk mendaftarkan instance lokal CodeDeploy sehingga dapat digunakan dalam penerapan.
1. Sebelum Anda dapat menggunakan AWS CLI, Anda akan memerlukan ARN pengguna IAM dari pengguna IAM yang Anda buat. [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) Jika Anda belum memiliki ARN pengguna, panggil perintah [get-user](https://docs.aws.amazon.com/cli/latest/reference/iam/get-user.html), tentukan nama pengguna IAM (dengan opsi) dan kueri hanya untuk ARN pengguna (dengan `--user-name` opsi dan): `--query` `--output`
```
aws iam get-user --user-name CodeDeployUser-OnPrem --query "User.Arn" --output text
```
1. Panggil [register-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html)perintah, tentukan:
+ Nama yang secara unik mengidentifikasi instance lokal (dengan opsi). `--instance-name`
**penting**
Untuk membantu mengidentifikasi instans lokal, terutama untuk tujuan debugging, kami sangat menyarankan Anda menentukan nama yang memetakan ke beberapa karakteristik unik instans lokal (misalnya, nomor seri atau pengenal aset internal, jika berlaku). Jika Anda menentukan alamat MAC sebagai nama, ketahuilah bahwa alamat MAC berisi karakter yang CodeDeploy tidak mengizinkan, seperti titik dua (`:`). Untuk daftar karakter yang diizinkan, lihat[CodeDeploy kuota](limits.md).
+ Pengguna ARN dari pengguna IAM yang Anda buat [Langkah 1: Buat pengguna IAM untuk instans lokal](#register-on-premises-instance-iam-user-arn-1) (dengan opsi). `--iam-user-arn`
Contoh:
```
aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem
```
## Langkah 9: Tandai instance lokal
Anda dapat menggunakan konsol AWS CLI atau CodeDeploy konsol untuk menandai instans lokal. (CodeDeploymenggunakan tag instans lokal untuk mengidentifikasi target penerapan selama penerapan.)
**Untuk menandai instance lokal (CLI)**
+ Panggil perintah [add-tags-to-on-premises-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/add-tags-to-on-premises-instances.html), dengan menentukan:
+ Nama yang secara unik mengidentifikasi instance lokal (dengan opsi). `--instance-names`
+ Nama kunci tag instans lokal dan nilai tag yang ingin Anda gunakan (dengan `--tags` opsi). Anda harus menentukan nama dan nilai. CodeDeploy tidak mengizinkan tag instance lokal yang hanya memiliki nilai.
Contoh:
```
aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem
```
**Untuk menandai instance lokal (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Dari CodeDeploy menu, pilih **Instans lokal**.
1. Dalam daftar instance lokal, pilih tanda panah di samping instans lokal yang ingin Anda tag.
1. Dalam daftar tag, pilih atau masukkan kunci tag dan nilai tag yang diinginkan. Setelah Anda memasukkan kunci tag dan nilai tag, baris lain muncul. Anda dapat mengulangi ini hingga 10 tag. Untuk menghapus tag, pilih ikon hapus (![\[The delete icon.\]](http://docs.aws.amazon.com/id_id/codedeploy/latest/userguide/images/delete-triggers-x.png)).
1. Setelah Anda menambahkan tag, pilih **Perbarui Tag**.
## Langkah 10: Menerapkan revisi aplikasi ke instans lokal
Anda sekarang siap untuk menerapkan revisi aplikasi ke instans lokal yang terdaftar dan diberi tag.
Anda menerapkan revisi aplikasi ke instans lokal dengan cara yang mirip dengan menerapkan revisi aplikasi ke instans Amazon EC2. Untuk petunjuk, lihat [Buat penerapan dengan CodeDeploy](deployments-create.md). Instruksi ini mencakup tautan ke prasyarat, termasuk membuat aplikasi, membuat grup penyebaran, dan menyiapkan revisi aplikasi. Jika Anda memerlukan contoh revisi aplikasi sederhana untuk diterapkan, Anda dapat membuat yang dijelaskan [Langkah 2: Buat contoh revisi aplikasi](tutorials-on-premises-instance-2-create-sample-revision.md) dalam. [Tutorial: Menerapkan aplikasi ke instans lokal dengan CodeDeploy (Windows Server, Ubuntu Server, atau Red Hat Enterprise Linux)](tutorials-on-premises-instance.md)
**penting**
Jika Anda menggunakan kembali peran CodeDeploy layanan sebagai bagian dari pembuatan grup penerapan yang menargetkan instance lokal, Anda `Tag:get*` harus menyertakan `Action` bagian pernyataan kebijakan peran layanan. Untuk informasi selengkapnya, lihat [Langkah 2: Buat peran layanan untuk CodeDeploy](getting-started-create-service-role.md).
## Langkah 11: Lacak penerapan ke instans lokal
Setelah menerapkan revisi aplikasi ke instans lokal yang terdaftar dan diberi tag, Anda dapat melacak kemajuan penerapan.
Anda melacak penerapan ke instans lokal dengan cara yang mirip dengan melacak penerapan ke instans Amazon EC2. Untuk petunjuk, lihat [Lihat CodeDeploy detail penerapan](deployments-view-details.md).
# Mengelola operasi instans lokal di CodeDeploy
Ikuti petunjuk di bagian ini untuk mengelola operasi pada instans lokal setelah Anda mendaftarkannya CodeDeploy, seperti mendapatkan informasi selengkapnya, menghapus tag, dan menghapus instans lokal.
**Topics**
+ [Mendapatkan informasi tentang satu instans lokal](on-premises-instances-operations-view-details-single.md)
+ [Mendapatkan informasi tentang beberapa instans lokal](on-premises-instances-operations-view-details-multiple.md)
+ [Hapus tag instans lokal secara manual dari instans lokal](on-premises-instances-operations-remove-tags.md)
+ [Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal](on-premises-instances-operations-uninstall-agent.md)
+ [Secara otomatis membatalkan pendaftaran instans lokal](on-premises-instances-operations-deregister-automatically.md)
+ [Deregister instans lokal secara manual](on-premises-instances-operations-deregister-manually.md)
# Mendapatkan informasi tentang satu instans lokal
Anda bisa mendapatkan informasi tentang satu instans lokal dengan mengikuti petunjuk di[Lihat CodeDeploy detail penerapan](deployments-view-details.md). Anda dapat menggunakan AWS CLI atau CodeDeploy konsol untuk mendapatkan informasi selengkapnya tentang satu instans lokal.
**Untuk mendapatkan informasi tentang satu instans lokal (CLI)**
+ Panggil [get-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-on-premises-instance.html)perintah, tentukan nama yang secara unik mengidentifikasi instance lokal (dengan opsi): `--instance-name`
```
aws deploy get-on-premises-instance --instance-name AssetTag12010298EX
```
**Untuk mendapatkan informasi tentang satu instans lokal (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Di panel navigasi, perluas **Deploy**, dan pilih Instans **lokal**.
1. Dalam daftar instance lokal, pilih nama instans lokal untuk melihat detailnya.
# Mendapatkan informasi tentang beberapa instans lokal
Anda bisa mendapatkan informasi tentang instans lokal dengan mengikuti petunjuk di. [Lihat CodeDeploy detail penerapan](deployments-view-details.md) Anda dapat menggunakan AWS CLI atau CodeDeploy konsol untuk mendapatkan informasi selengkapnya tentang instans lokal.
**Untuk mendapatkan informasi tentang beberapa instans lokal (CLI)**
1. Untuk daftar nama instans lokal, panggil [list-on-premises-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-on-premises-instances.html)perintah, dengan menentukan:
+ Apakah akan mendapatkan informasi tentang semua instans lokal yang terdaftar atau dideregistrasi (dengan `--registration-status` opsi dan `Registered` atau, masing-masing). `Deregistered` Jika Anda menghilangkan ini, maka nama instans lokal yang terdaftar dan dideregistrasi akan dikembalikan.
+ Apakah akan mendapatkan informasi hanya tentang instans lokal yang ditandai dengan tag instans lokal tertentu (dengan opsi). `--tag-filters` Untuk setiap tag instance lokal, tentukan`Key`,`Value`, dan `Type` (yang seharusnya selalu`KEY_AND_VALUE`). Pisahkan beberapa tag instans lokal dengan spasi antara masing-masing `Key``Value`, dan `Type` triplet.
Contoh:
```
aws deploy list-on-premises-instances --registration-status Registered --tag-filters Key=Name,Value=CodeDeployDemo-OnPrem,Type=KEY_AND_VALUE Key=Name,Value=CodeDeployDemo-OnPrem-Beta,Type=KEY_AND_VALUE
```
1. Untuk informasi lebih rinci, panggil perintah [batch-get-on-premises-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-on-premises-instances.html), dengan nama instance lokal (dengan opsi): `--instance-names`
```
aws deploy batch-get-on-premises-instances --instance-names AssetTag12010298EX AssetTag09920444EX
```
**Untuk mendapatkan informasi tentang beberapa instans lokal (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Di panel navigasi, perluas **Deploy**, dan pilih Instans **lokal**.
Informasi tentang instans lokal ditampilkan.
# Hapus tag instans lokal secara manual dari instans lokal
Biasanya, Anda menghapus tag instans lokal dari instans lokal saat tag tersebut tidak lagi digunakan, atau Anda ingin menghapus instans lokal dari grup penerapan apa pun yang bergantung pada tag tersebut. Anda dapat menggunakan AWS CLI atau AWS CodeDeploy konsol untuk menghapus tag instans lokal dari instance lokal.
Anda tidak perlu menghapus tag instans lokal dari instans lokal sebelum membatalkan pendaftarannya.
Menghapus tag instans lokal secara manual dari instans lokal tidak membatalkan pendaftaran instance. Itu tidak menghapus instalan CodeDeploy agen dari instance. Itu tidak menghapus file konfigurasi dari instance. Itu tidak menghapus pengguna IAM yang terkait dengan instance.
Untuk membatalkan pendaftaran instans lokal secara otomatis, lihat. [Secara otomatis membatalkan pendaftaran instans lokal](on-premises-instances-operations-deregister-automatically.md)
Untuk membatalkan pendaftaran instans lokal secara manual, lihat. [Deregister instans lokal secara manual](on-premises-instances-operations-deregister-manually.md)
Untuk menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal, lihat. [Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal](on-premises-instances-operations-uninstall-agent.md)
Untuk menghapus instalan CodeDeploy agen secara manual dari instans lokal, lihat. [Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md)
Untuk menghapus pengguna IAM terkait secara manual, lihat [Menghapus pengguna IAM dari akun](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_DeletingUserFromAccount.html) Anda. AWS
**Untuk menghapus tag instans lokal dari instans lokal (CLI)**
+ Panggil [remove-tags-from-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/remove-tags-from-on-premises-instances.html), dengan menentukan:
+ Nama-nama yang secara unik mengidentifikasi instance lokal (dengan opsi). `--instance-names`
+ Nama dan nilai tag yang ingin Anda hapus (dengan `--tags` opsi).
Contoh:
```
aws deploy remove-tags-from-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem
```
**Untuk menghapus tag instans lokal dari instans lokal (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. Di panel navigasi, perluas **Deploy**, dan pilih Instans **lokal**.
1. Dalam daftar instance lokal, pilih nama instance lokal tempat Anda ingin menghapus tag.
1. Di **Tag**, pilih **Hapus** di samping setiap tag yang ingin Anda hapus.
1. Setelah Anda menghapus tag, pilih **Perbarui tag**.
# Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal
Biasanya, Anda menghapus instalan CodeDeploy agen dan menghapus file konfigurasi dari instance lokal setelah Anda tidak lagi berencana untuk menerapkannya.
**catatan**
Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instans lokal tidak membatalkan pendaftaran instance lokal. Itu tidak memisahkan tag instans lokal yang terkait dengan instans lokal. Itu tidak menghapus pengguna IAM yang terkait dengan instans lokal.
Untuk membatalkan pendaftaran instans lokal secara otomatis, lihat. [Secara otomatis membatalkan pendaftaran instans lokal](on-premises-instances-operations-deregister-automatically.md)
Untuk membatalkan pendaftaran instans lokal secara manual, lihat. [Deregister instans lokal secara manual](on-premises-instances-operations-deregister-manually.md)
Untuk memisahkan tag instans lokal terkait secara manual, lihat. [Hapus tag instans lokal secara manual dari instans lokal](on-premises-instances-operations-remove-tags.md)
Untuk menghapus instalan CodeDeploy agen secara manual dari instans lokal, lihat. [Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md)
Untuk menghapus pengguna IAM terkait secara manual, lihat [Menghapus pengguna IAM dari akun](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_DeletingUserFromAccount.html) Anda. AWS
Dari instance lokal, gunakan AWS CLI untuk memanggil perintah [uninstall](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html).
Contoh:
```
aws deploy uninstall
```
**uninstall**Perintah melakukan hal berikut:
1. Menghentikan CodeDeploy agen yang sedang berjalan pada instance lokal.
1. Menghapus instalan CodeDeploy agen dari instans lokal.
1. Menghapus file konfigurasi dari instance lokal. (Untuk Server Ubuntu dan RHEL, ini adalah`/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`. Untuk Windows Server, ini adalah`C:\ProgramData\Amazon\CodeDeploy`\$1`conf.onpremises.yml`.)
# Secara otomatis membatalkan pendaftaran instans lokal
Biasanya, Anda membatalkan pendaftaran instans lokal setelah Anda tidak lagi berencana untuk menerapkannya. Saat Anda membatalkan pendaftaran instans lokal, meskipun instans lokal mungkin merupakan bagian dari tag instans lokal grup penerapan, instans lokal tidak akan disertakan dalam penerapan apa pun. Anda dapat menggunakan AWS CLI untuk membatalkan pendaftaran instance lokal.
**catatan**
Anda tidak dapat menggunakan CodeDeploy konsol untuk membatalkan pendaftaran instans lokal. Selain itu, membatalkan pendaftaran instans lokal akan menghapus tag instans lokal yang terkait dengan instans lokal. Itu tidak menghapus instalan CodeDeploy agen dari instance lokal. Itu tidak menghapus file konfigurasi instans lokal dari instans lokal.
Untuk menggunakan CodeDeploy konsol untuk melakukan beberapa (tetapi tidak semua) aktivitas di bagian ini, lihat bagian CodeDeploy konsol[Deregister instans lokal secara manual](on-premises-instances-operations-deregister-manually.md).
Untuk memisahkan tag instans lokal terkait secara manual, lihat. [Hapus tag instans lokal secara manual dari instans lokal](on-premises-instances-operations-remove-tags.md)
Untuk menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal, lihat. [Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal](on-premises-instances-operations-uninstall-agent.md)
Untuk menghapus instalan CodeDeploy agen secara manual dari instans lokal, lihat. [Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md)
Gunakan AWS CLI untuk memanggil perintah [deregister](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html), dengan menentukan:
+ Nama yang secara unik mengidentifikasi instance lokal CodeDeploy (dengan opsi). `--instance-name`
+ Secara opsional, apakah akan menghapus pengguna IAM yang terkait dengan instans lokal. Perilaku default adalah menghapus pengguna IAM. Jika Anda tidak ingin menghapus pengguna IAM yang terkait dengan instans lokal, tentukan `--no-delete-iam-user` opsi dalam perintah.
+ Secara opsional, AWS wilayah tempat instans lokal terdaftar CodeDeploy (dengan `--region` opsi). Ini harus menjadi salah satu wilayah yang didukung yang terdaftar di [Wilayah dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di *Referensi Umum AWS*(misalnya,`us-west-2`). Jika opsi ini tidak ditentukan, AWS wilayah default yang terkait dengan pengguna IAM panggilan akan digunakan.
Contoh yang membatalkan pendaftaran instance dan menghapus pengguna:
```
aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2
```
Contoh yang membatalkan pendaftaran instance dan tidak menghapus pengguna:
```
aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2
```
**deregister**Perintah melakukan hal berikut:
1. Menderegister instance lokal dengan. CodeDeploy
1. Jika ditentukan, menghapus pengguna IAM yang terkait dengan instans lokal.
Setelah membatalkan pendaftaran instans lokal:
+ Itu berhenti muncul di konsol segera.
+ Anda dapat membuat instance lain dengan nama yang sama segera.
Jika perintah ini menemukan kesalahan, pesan kesalahan muncul, menjelaskan bagaimana Anda dapat menyelesaikan langkah-langkah yang tersisa secara manual. Jika tidak, pesan sukses muncul, menjelaskan cara memanggil **uninstall** perintah.
# Deregister instans lokal secara manual
Biasanya, Anda membatalkan pendaftaran instans lokal setelah Anda tidak lagi berencana untuk menerapkannya. Anda menggunakan AWS CLI untuk membatalkan pendaftaran instans lokal secara manual.
Membatalkan pendaftaran instans lokal secara manual tidak menghapus instalan agen. CodeDeploy Itu tidak menghapus file konfigurasi dari instance. Itu tidak menghapus pengguna IAM yang terkait dengan instance. Itu tidak menghapus tag apa pun yang terkait dengan instance.
Untuk menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal, lihat. [Menghapus instalan CodeDeploy agen secara otomatis dan menghapus file konfigurasi dari instance lokal](on-premises-instances-operations-uninstall-agent.md)
Untuk menghapus instalan hanya CodeDeploy agen secara manual, lihat[Mengelola operasi CodeDeploy agen](codedeploy-agent-operations.md).
Untuk menghapus pengguna IAM terkait secara manual, lihat [Menghapus pengguna IAM dari akun](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_DeletingUserFromAccount.html) Anda. AWS
Untuk menghapus hanya tag instans lokal terkait secara manual, lihat[Hapus tag instans lokal secara manual dari instans lokal](on-premises-instances-operations-remove-tags.md).
+ Panggil [deregister-on-premises-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister-on-premises-instance.html)perintah, tentukan nama yang secara unik mengidentifikasi instance lokal (dengan opsi): `--instance-name`
```
aws deploy deregister-on-premises-instance --instance-name AssetTag12010298EX
```
Setelah membatalkan pendaftaran instans lokal:
+ Itu berhenti muncul di konsol segera.
+ Anda dapat membuat instance lain dengan nama yang sama segera.
# Lihat detail contoh dengan CodeDeploy
Anda dapat menggunakan CodeDeploy konsol, the AWS CLI, atau CodeDeploy APIs untuk melihat detail tentang instance yang digunakan dalam penerapan.
Untuk informasi tentang penggunaan tindakan CodeDeploy API untuk melihat instance, lihat [GetDeploymentInstance[ListDeploymentInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListDeploymentInstances.html)](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_GetDeploymentInstance.html), dan [ListOnPremisesInstances](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_ListOnPremisesInstances.html).
**Topics**
+ [Lihat detail contoh (konsol)](#instances-view-details-console)
+ [Lihat detail contoh (CLI)](#instances-view-details-cli)
## Lihat detail contoh (konsol)
Untuk melihat detail contoh:
1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy).
**catatan**
Masuk dengan pengguna yang sama dengan yang Anda atur[Memulai dengan CodeDeploy](getting-started-codedeploy.md).
1. **Di panel navigasi, perluas **Deploy, lalu pilih Deployments**.**
**catatan**
Jika tidak ada entri yang ditampilkan, pastikan wilayah yang benar dipilih. Pada bilah navigasi, di pemilih wilayah, pilih salah satu wilayah yang tercantum di [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) di. *Referensi Umum AWS* CodeDeploy hanya didukung di wilayah ini.
1. Untuk menampilkan detail penerapan, pilih ID penerapan untuk instance.
1. Anda dapat melihat semua instance di bagian **Aktivitas instans** pada halaman penerapan.
1. **Untuk melihat informasi tentang peristiwa siklus hidup penerapan individual untuk sebuah instance, pada halaman detail penerapan, di kolom **Peristiwa, pilih Lihat peristiwa**.**
**catatan**
Jika **Gagal** ditampilkan untuk salah satu peristiwa siklus hidup, pada halaman detail instance, pilih **Lihat log, **Lihat masuk EC2****, atau keduanya. Anda dapat menemukan tips pemecahan masalah di. [Memecahkan masalah contoh](troubleshooting-ec2-instances.md)
1. Jika Anda ingin melihat informasi selengkapnya tentang EC2 instans Amazon, pilih ID **instance di kolom ID Instance**.
## Lihat detail contoh (CLI)
Untuk menggunakan detail instance AWS CLI to view, panggil `get-deployment-instance` perintah atau `list-deployment-instances` perintah.
Untuk melihat detail tentang satu instance, panggil [get-deployment-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-instance.html)perintah, dengan menentukan:
+ ID penyebaran unik. Untuk mendapatkan ID penerapan, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
+ ID contoh unik. Untuk mendapatkan ID instance, panggil [list-deployment-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-instances.html)perintah.
Untuk melihat daftar IDs instance yang digunakan dalam penerapan, panggil [list-deployment-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-instances.html)perintah, dengan menentukan:
+ ID penyebaran unik. Untuk mendapatkan ID penerapan, panggil perintah [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
+ Secara opsional, apakah hanya menyertakan instance tertentu IDs berdasarkan status penerapannya. (Jika tidak ditentukan, semua instance yang cocok IDs akan dicantumkan, terlepas dari status penerapannya.)
# CodeDeploy misalnya kesehatan
CodeDeploy memantau status kesehatan instance dalam grup penyebaran. Penerapan gagal jika jumlah instance sehat berada di bawah jumlah minimum instance sehat yang telah ditentukan untuk grup penerapan selama penerapan. Misalnya, jika 85% instance harus tetap sehat selama penerapan, dan grup penerapan berisi 10 instance, penerapan keseluruhan akan gagal jika penerapan bahkan ke satu instance gagal. Ini karena ketika sebuah instance diambil offline sehingga revisi aplikasi terbaru dapat diinstal, jumlah instans sehat yang tersedia sudah turun menjadi 90%. Instance yang gagal ditambah instance offline lainnya berarti bahwa hanya 80% instance yang sehat dan tersedia. CodeDeployakan gagal dalam penerapan keseluruhan.
Penting untuk diingat bahwa agar penerapan keseluruhan berhasil, berikut ini harus benar:
+ CodeDeploy dapat menyebarkan ke setiap instance dalam penerapan.
+ Penerapan ke setidaknya satu instance harus berhasil. Ini berarti bahwa meskipun nilai host sehat minimum adalah 0, penerapan ke setidaknya satu instance harus berhasil (yaitu, setidaknya satu instance harus sehat) agar penerapan keseluruhan berhasil.
**Topics**
+ [Status kondisi](#instances-health-status)
+ [Tentang jumlah minimum contoh sehat](#minimum-healthy-hosts)
+ [Tentang jumlah minimum instans sehat per Availability Zone](#minimum-healthy-hosts-az)
## Status kondisi
CodeDeploy memberikan dua nilai status kesehatan untuk setiap contoh: kesehatan *revisi dan kesehatan* *instans*.
Revisi kesehatan
Kesehatan revisi didasarkan pada revisi aplikasi yang saat ini diinstal pada instance. Ini memiliki nilai status berikut:
+ Saat ini: Revisi yang diinstal pada instance cocok dengan revisi untuk penerapan terakhir grup penerapan yang berhasil.
+ Lama: Revisi yang diinstal pada instance cocok dengan versi aplikasi yang lebih lama.
+ Tidak diketahui: Revisi aplikasi belum berhasil diinstal pada instance.
Kesehatan contoh
Kesehatan instans didasarkan pada apakah penerapan ke suatu instance telah berhasil. Ini memiliki nilai-nilai berikut:
+ Sehat: Penerapan terakhir ke instance berhasil.
+ Tidak sehat: Upaya untuk menerapkan revisi ke instance gagal, atau revisi belum diterapkan ke instance.
CodeDeploy menggunakan kesehatan revisi dan kesehatan instans untuk menjadwalkan penerapan ke instance grup penerapan dalam urutan berikut:
1. Kesehatan contoh yang tidak sehat.
1. Kesehatan revisi tidak diketahui.
1. Kesehatan revisi lama.
1. Kesehatan revisi saat ini.
Jika penerapan keseluruhan berhasil, revisi akan diperbarui dan nilai status kesehatan grup penerapan diperbarui untuk mencerminkan penerapan terbaru.
+ Semua instance saat ini yang memiliki penerapan yang berhasil tetap terkini. Kalau tidak, mereka menjadi tidak dikenal.
+ Semua instance lama atau tidak dikenal yang memiliki penerapan yang berhasil menjadi terkini. Kalau tidak, mereka tetap tua atau tidak dikenal.
+ Semua contoh sehat yang memiliki penyebaran yang berhasil tetap sehat. Kalau tidak, mereka menjadi tidak sehat.
+ Semua contoh tidak sehat yang memiliki penyebaran yang sukses menjadi sehat. Kalau tidak, mereka tetap tidak sehat.
Jika penerapan keseluruhan gagal atau dihentikan:
+ Setiap instance yang CodeDeploy mencoba menerapkan revisi aplikasi memiliki kesehatan instance-nya yang disetel ke sehat atau tidak sehat, tergantung pada apakah upaya penerapan untuk instance itu berhasil atau gagal.
+ Setiap instance yang CodeDeploy tidak mencoba menerapkan revisi aplikasi mempertahankan nilai kesehatan instancenya saat ini.
+ Revisi grup penyebaran tetap sama.
## Tentang jumlah minimum contoh sehat
Jumlah minimum instans sehat yang diperlukan didefinisikan sebagai bagian dari konfigurasi penerapan.
**penting**
Selama blue/green penerapan, konfigurasi penerapan dan nilai host sehat minimum berlaku untuk instance di lingkungan pengganti, bukan yang ada di lingkungan asli. Namun, ketika instance di lingkungan asli dideregistrasi dari penyeimbang beban, penerapan keseluruhan ditandai sebagai Gagal jika bahkan satu instance asli gagal dideregistrasi dengan sukses.
CodeDeploy menyediakan tiga konfigurasi penerapan default yang secara umum menggunakan nilai host sehat minimum:
| Nama konfigurasi penerapan default | Nilai host sehat minimum yang telah ditentukan sebelumnya |
| --- | --- |
| CodeDeployDefault.OneAtATime | 1 |
| CodeDeployDefault.HalfAtATime | 50% |
| CodeDeployDefault.AllAtOnce | 0 |
Anda akan menemukan informasi lebih lanjut tentang konfigurasi penerapan default di. [Bekerja dengan konfigurasi penerapan di CodeDeploy](deployment-configurations.md)
Anda dapat membuat konfigurasi penerapan khusus CodeDeploy untuk menentukan nilai host sehat minimum Anda sendiri. Anda dapat menentukan nilai-nilai ini sebagai bilangan bulat atau persentase saat menggunakan operasi berikut:
+ Seperti `minimum-healthy-hosts` ketika Anda menggunakan [create-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-config.html)perintah di AWS CLI.
+ Seperti `Value` pada tipe [MinimumHealthyHosts](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_MinimumHealthyHosts.html)data di CodeDeploy API.
+ Seperti `MinimumHealthyHosts` ketika Anda menggunakan [AWS::CodeDeploy::DeploymentConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codedeploy-deploymentconfig.html)dalam CloudFormation template.
CodeDeploy memungkinkan Anda menentukan jumlah minimum instance sehat untuk penyebaran untuk dua tujuan utama:
+ Untuk menentukan apakah penerapan keseluruhan berhasil atau gagal. Penerapan berhasil jika revisi aplikasi berhasil diterapkan ke setidaknya jumlah minimum instance sehat.
+ Untuk menentukan jumlah instance yang harus sehat selama penerapan agar penerapan dapat dilanjutkan.
Anda dapat menentukan jumlah minimum instans sehat untuk grup penyebaran Anda sebagai sejumlah instance atau sebagai persentase dari jumlah total instans. Jika Anda menentukan persentase, maka pada awal penerapan, CodeDeploy mengonversi persentase ke jumlah instance yang setara, membulatkan instance fraksional apa pun.
CodeDeploy melacak status kesehatan instans grup penyebaran selama proses penerapan dan menggunakan jumlah minimum instans sehat yang ditentukan penerapan untuk menentukan apakah akan melanjutkan penerapan. Prinsip dasarnya adalah bahwa penerapan tidak boleh menyebabkan jumlah instance sehat turun di bawah jumlah minimum yang telah Anda tentukan. Satu pengecualian untuk aturan ini adalah ketika grup penerapan awalnya memiliki kurang dari jumlah minimum instance sehat yang ditentukan. Dalam hal ini, proses penyebaran tidak mengurangi jumlah instance sehat lebih jauh.
**catatan**
CodeDeploy akan mencoba menerapkan ke semua instance dalam grup penerapan, bahkan yang saat ini dalam status Berhenti. Dalam perhitungan host sehat minimum, instance yang dihentikan memiliki dampak yang sama dengan instance yang gagal. Untuk mengatasi kegagalan penerapan karena terlalu banyak instance yang dihentikan, mulai ulang instance atau ubah tag mereka untuk mengecualikannya dari grup penerapan.
CodeDeploy memulai proses penerapan dengan mencoba menerapkan revisi aplikasi ke instance tidak sehat grup penerapan. Untuk setiap penerapan yang berhasil, CodeDeploy ubah status kesehatan instans menjadi sehat dan menambahkannya ke instans sehat grup penerapan. CodeDeploy kemudian membandingkan jumlah instans sehat saat ini dengan jumlah minimum contoh sehat yang ditentukan.
+ Jika jumlah instans sehat kurang dari atau sama dengan jumlah minimum instans sehat yang ditentukan, CodeDeploy batalkan penerapan untuk memastikan jumlah instans sehat tidak berkurang dengan lebih banyak penerapan.
+ Jika jumlah instans sehat lebih besar dari jumlah minimum instans sehat yang ditentukan oleh setidaknya satu, CodeDeploy menyebarkan revisi aplikasi ke kumpulan asli instans sehat.
Jika penerapan ke instance sehat gagal, CodeDeploy ubah status kesehatan instans tersebut menjadi tidak sehat. Saat penerapan berlangsung, CodeDeploy perbarui jumlah instans sehat saat ini dan membandingkannya dengan jumlah minimum instans sehat yang ditentukan. Jika jumlah instans sehat jatuh ke angka minimum yang ditentukan pada titik mana pun dalam proses penerapan, CodeDeploy hentikan penerapan. Praktik ini mencegah kemungkinan penerapan berikutnya akan gagal, menjatuhkan jumlah instance sehat di bawah angka minimum yang ditentukan.
**catatan**
Pastikan jumlah minimum instans sehat yang Anda tentukan kurang dari jumlah total instance dalam grup penyebaran. Jika Anda menentukan nilai persentase, ingat itu akan dibulatkan ke atas. Jika tidak, saat penerapan dimulai, jumlah instance sehat sudah kurang dari atau sama dengan jumlah minimum instans sehat yang ditentukan, dan CodeDeploy akan segera gagal dalam penerapan keseluruhan.
CodeDeploy juga menggunakan jumlah minimum instans sehat yang ditentukan dan jumlah sebenarnya dari instans sehat untuk menentukan apakah dan bagaimana menerapkan revisi aplikasi ke beberapa instance. Secara default, CodeDeploy menerapkan revisi aplikasi ke sebanyak mungkin instance tanpa risiko jumlah instans sehat berada di bawah jumlah minimum instans sehat yang ditentukan.
Untuk menentukan jumlah instance yang harus digunakan sekaligus, CodeDeploy gunakan perhitungan berikut:
```
[total-hosts] - [minimum-healthy-hosts] =
[number-of-hosts-to-deploy-to-at-once]
```
Contoh:
+ Jika grup penerapan Anda memiliki 10 instans dan Anda menetapkan nomor instans sehat minimum menjadi 9, CodeDeploy deploy ke 1 instans sekaligus.
+ Jika grup penerapan Anda memiliki 10 instans dan Anda menetapkan nomor instans sehat minimum menjadi 3, CodeDeploy deploy ke 7 instans pada saat yang sama di batch pertama, dan kemudian ke 3 sisanya di batch kedua.
+ Jika grup penerapan Anda memiliki 10 instans dan Anda menyetel nomor instans sehat minimum ke 0, CodeDeploy deploy ke 10 instans secara bersamaan.
**Contoh**
Contoh berikut mengasumsikan grup penerapan dengan 10 instance.
Contoh sehat minimum: 95%
CodeDeploy membulatkan jumlah instans sehat minimum hingga 10 kali, yang sama dengan jumlah contoh sehat. Penerapan keseluruhan segera gagal tanpa menerapkan revisi ke instance apa pun.
Contoh sehat minimum: 9
CodeDeploy menyebarkan revisi ke satu instance pada satu waktu. Jika penerapan ke salah satu instance gagal, CodeDeploy segera gagal penerapan keseluruhan karena jumlah instans sehat sama dengan jumlah instans sehat minimum. Pengecualian untuk aturan ini adalah bahwa jika instance terakhir gagal, penerapan masih berhasil.
CodeDeploy melanjutkan penerapan, satu instance pada satu waktu, hingga penerapan apa pun gagal atau penerapan keseluruhan selesai. Jika semua 10 penerapan berhasil, grup penerapan sekarang memiliki 10 instance sehat.
Contoh sehat minimum: 8
CodeDeploy menyebarkan revisi ke dua instance sekaligus. Jika dua penerapan ini gagal, CodeDeploy segera gagal penerapan keseluruhan. Pengecualian untuk aturan ini adalah bahwa jika instance terakhir adalah yang kedua gagal, penerapan masih berhasil.
Contoh sehat minimum: 0
CodeDeploy menyebarkan revisi ke seluruh grup penyebaran sekaligus. Setidaknya satu penerapan ke instans harus berhasil agar penerapan keseluruhan berhasil. Jika 0 instance sehat, maka penerapan gagal. Ini karena persyaratan bahwa untuk menandai penerapan keseluruhan sebagai berhasil, setidaknya satu instance harus sehat ketika penerapan keseluruhan selesai, bahkan jika nilai instans sehat minimum adalah 0.
## Tentang jumlah minimum instans sehat per Availability Zone
**catatan**
Bagian ini menggunakan istilah *instance* dan *host* secara bergantian untuk merujuk ke instans Amazon EC2.
Jika Anda menerapkan ke instance di beberapa [Availability Zone](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones), Anda dapat mengaktifkan [zonal configuration](deployment-configurations-create.md#zonal-config) fitur secara opsional, yang memungkinkan CodeDeploy untuk menerapkan ke satu Availability Zone pada satu waktu.
Ketika fitur ini diaktifkan, CodeDeploy akan memastikan bahwa jumlah host sehat tetap di atas 'host sehat minimum per zona' *dan* nilai 'host sehat minimum'. Jika jumlah host sehat turun di bawah salah satu nilai, CodeDeploy gagal penerapan di semua Availability Zone.
Untuk menghitung jumlah host yang akan digunakan sekaligus, CodeDeploy gunakan nilai 'host sehat minimum per zona' dan 'host sehat minimum'. CodeDeploy akan menggunakan perhitungan yang *lebih rendah* `[A]` dan`[B]`, di mana `[A]` dan di mana`[B]`:
```
[A] = [total-hosts] - [min-healthy-hosts] =
[number-of-hosts-to-deploy-to-at-once]
```
```
[B] = [total-hosts-per-AZ] - [min-healthy-hosts-per-AZ] =
[number-of-hosts-to-deploy-to-at-once-per-AZ]
```
Setelah menentukan jumlah host yang akan diterapkan sekaligus, CodeDeploy menyebarkan ke host dalam batch nomor itu, satu Availability Zone pada satu waktu, dengan jeda opsional (atau 'waktu pemanggangan') di antara zona.
**Contoh**
Jika penerapan Anda dikonfigurasi seperti ini:
+ `[total-hosts]`adalah `200`
+ `[minimum-healthy-hosts]`adalah `160`
+ `[total-hosts-per-AZ]`adalah `100`
+ `[minimum-healthy-hosts-per-AZ]`adalah `50`
Maka...
+ `[A]` = `200 - 160 = 40`
+ `[B]` = `100 - 50 = 50`
+ `40`kurang dari `50`
Oleh karena itu, CodeDeploy akan menyebarkan ke `40` host sekaligus.
Dalam skenario ini, penerapan terungkap sebagai berikut:
1. CodeDeploy menyebarkan ke Availability Zone pertama:
1. CodeDeploy menyebarkan ke `40` host pertama.
1. CodeDeploy menyebarkan ke `40` host berikutnya.
1. CodeDeploy menyebarkan ke `20` host yang tersisa.
Penerapan ke Availability Zone pertama sekarang selesai.
1. (Opsional) CodeDeploy menunggu sementara penerapan ke zona pertama 'bakes', seperti yang ditentukan oleh **durasi Monitor atau Tambahkan durasi** **monitor untuk pengaturan zona pertama**. Jika tidak ada masalah, CodeDeploy lanjutkan.
1. CodeDeploy menyebarkan ke Availability Zone kedua:
1. CodeDeploy menyebarkan ke `40` host pertama.
1. CodeDeploy menyebarkan ke `40` host berikutnya.
1. CodeDeploy menyebarkan ke `20` host yang tersisa.
Penerapan ke Availability Zone kedua dan terakhir sekarang selesai.
Untuk mempelajari tentang fitur konfigurasi zona, dan cara menentukan jumlah minimum instans sehat per Availability Zone, lihat. [zonal configuration](deployment-configurations-create.md#zonal-config)