Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan perintah register (pengguna IAM ARN) untuk mendaftarkan instance lokal
**penting**
Mendaftarkan instance menggunakan pengguna IAM tidak disarankan karena menggunakan kredenSIAL statis (permanen) untuk otentikasi. Untuk keamanan yang lebih baik, sebaiknya daftarkan instance menggunakan kredentif sementara untuk otentikasi. Untuk informasi selengkapnya, lihat [Gunakan perintah register-on-premises-instance (IAM Session ARN) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
**penting**
Pastikan Anda memiliki rencana untuk memutar kunci akses pengguna IAM (kredenSIAL permanen). Untuk informasi selengkapnya, lihat [ Memutar tombol akses](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey).
Bagian ini menjelaskan cara mengonfigurasi instans lokal dan mendaftarkan serta men CodeDeploy andainya dengan sedikit usaha. Per **register** intah ini paling berguna saat Anda bekerja dengan armada instans lokal tunggal atau kecil. Anda dapat menggunakan **register** perintah hanya ketika Anda menggunakan ARN pengguna IAM untuk mengotentikasi sebuah instance. Anda tidak dapat menggunakan **register** perintah dengan sesi IAM ARN untuk otentikasi.
Ketika Anda menggunakan **register** perintah, Anda dapat CodeDeploy melakukan hal berikut:
+ Buat pengguna IAM AWS Identity and Access Management untuk instance lokal, jika Anda tidak menentukannya dengan perintah.
+ Simpan kredentif 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**
Per [ intah register-on-premises-instance adalah alternatif dari ](https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html) perintah register. [https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html](https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html) Anda menggunakan **register-on-premises-instance** perintah jika ingin mengonfigurasi instans lokal dan mendaftarkan serta menandainya dengan CodeDeploy sebagian besar sendiri. Per **register-on-premises-instance** intah ini juga memberi Anda pilihan untuk menggunakan ARN sesi IAM untuk mendaftarkan instance alih-alih ARN pengguna IAM. Pendekatan ini memberikan keuntungan besar jika Anda memiliki armada instans lokal yang besar. Secara khusus, Anda dapat menggunakan ARN sesi IAM tunggal untuk mengotentikasi beberapa instance alih-alih harus membuat pengguna IAM untuk setiap instans lokal satu per satu. Untuk informasi selengkapnya, lihat [Gunakan perintah register-on-premises-instance (ARN pengguna IAM) untuk mendaftarkan instance lokal](register-on-premises-instance-iam-user-arn.md) dan [Gunakan perintah register-on-premises-instance (IAM Session ARN) untuk mendaftarkan instans lokal](register-on-premises-instance-iam-session-arn.md).
**Topics**
+ [Langkah 1: Instal dan konfigurasikan AWS CLI pada 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 install](#instances-on-premises-register-instance-3-install-command)
+ [Langkah 4: Menyebarkan revisi aplikasi ke instans lokal](#instances-on-premises-register-instance-4-deploy-revision)
+ [Langkah 5: Melacak penerapan ke instans lokal](#instances-on-premises-register-instance-5-track-deployment)
## Langkah 1: Instal dan konfigurasikan AWS CLI pada instans lokal
1. Instal instans AWS CLI di lokasi. Ikuti petunjuk dalam [ Menyiapkan dengan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) di Panduan *AWS Command Line Interface Pengguna*.
**catatan**
CodeDeploy perintah untuk bekerja dengan instans 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 instans AWS CLI di lokasi. Ikuti petunjuk dalam Meng [ onfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) dalam Panduan *AWS Command Line Interface Pengguna*.
**penting**
Saat Anda mengonfigurasi AWS CLI (misalnya, dengan memanggil **aws configure** perintah), pastikan untuk menentukan ID kunci rahasia dan kunci akses rahasia pengguna IAM yang memiliki, minimal, 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 menganggap Anda mendaftarkan instance lokal dari instans lokal itu sendiri. Anda juga dapat mendaftarkan instance 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 ](https://docs.aws.amazon.com/cli/latest/reference/deploy/register.html) register, menentukan:
+ Nama yang secara unik mengidentifikasi instance lokal ke CodeDeploy (dengan `--instance-name` opsi).
**penting**
Untuk membantu mengidentifikasi instance lokal nanti, terutama untuk tujuan debugging, kami sangat menyarankan Anda menggunakan nama yang dipetakan ke beberapa karakteristik unik dari instance lokal (misalnya, nomor seri atau beberapa pengenal aset internal yang unik, jika berlaku). Jika Anda menentukan alamat MAC untuk nama, ketahuilah bahwa alamat MAC berisi karakter yang CodeDeploy tidak memungkinkan, seperti titik dua (`:`). Untuk daftar karakter yang diizinkan, lihat[CodeDeploy kuota](limits.md).
+ Secara opsional, ARN dari pengguna IAM yang ada yang ingin Anda kaitkan dengan instance lokal ini (dengan `--iam-user-arn` opsi). Untuk mendapatkan ARN pengguna IAM, panggil [ perintah ](https://docs.aws.amazon.com/cli/latest/reference/iam/get-user.html) get-user, atau pilih nama pengguna IAM di ** bagian U ** sers pada 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 menghubungkannya dengan instance 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: Menambahkan file konfigurasi ke instance lokal](register-on-premises-instance-iam-user-arn.md#register-on-premises-instance-iam-user-arn-4).
Anda hanya dapat mengaitkan satu pengguna IAM dengan satu instans lokal saja. Mencoba mengaitkan satu pengguna IAM dengan beberapa instans lokal dapat mengakibatkan kesalahan, penerapan yang gagal ke instans lokal tersebut, atau penerapan ke instans lokal yang macet dalam status tertunda abadi.
+ Secara opsional, kumpulan tag instans lokal (dengan `--tags` opsi) yang CodeDeploy akan digunakan untuk mengidentifikasi kumpulan instans Amazon EC2 yang akan digunakan untuk menerapkan. 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 terdaftar. Untuk mendaftarkan tag nanti, panggil perintah [ add-tags- ](https://docs.aws.amazon.com/cli/latest/reference/deploy/add-tags-to-on-premises-instances.html) to-on-premises-instance.
+ Secara opsional, Wil AWS ayah tempat instance lokal akan didaftarkan CodeDeploy (dengan `--region` opsi). Ini harus menjadi salah satu Wilayah yang didukung yang terdaftar di [ Wilayah dan titik ](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) akhir di *Referensi Umum AWS* (misalnya,`us-west-2`). Jika opsi ini tidak ditentukan, Wil AWS ayah default yang terkait dengan pengguna IAM yang memanggil 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
```
Per **register** intah melakukan hal berikut:
1. Jika tidak ada pengguna IAM yang ada yang ditentukan, membuat pengguna IAM, melampirkan izin yang diperlukan untuk itu, dan menghasilkan kunci rahasia dan kunci akses rahasia yang sesuai. Instans lokal akan menggunakan pengguna IAM ini beserta izin serta kredensialnya untuk mengotentikasi dan berinteraksi dengannya. CodeDeploy
1. Mendaftarkan instance lokal dengan CodeDeploy.
1. Jika ditentukan, ka CodeDeploy itkan dalam tag yang ditentukan dengan `--tags` opsi dengan nama instans lokal 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 install
Dari instance lokal, gunakan AWS CLI untuk memanggil [ perintah ](https://docs.aws.amazon.com/cli/latest/reference/deploy/install.html) install, tentukan:
+ Jalur ke file konfigurasi (dengan `--config-file` opsi).
+ Secara opsional, apakah akan mengganti file konfigurasi yang sudah ada di instance lokal (dengan `--override-config` opsi). Jika tidak ditentukan, file konfigurasi yang ada tidak akan diganti.
+ Secara opsional, Wil AWS ayah tempat instance lokal akan didaftarkan CodeDeploy (dengan `--region` opsi). Ini harus menjadi salah satu Wilayah yang didukung yang terdaftar di [ Wilayah dan titik ](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) akhir di *Referensi Umum AWS* (misalnya,`us-west-2`). Jika opsi ini tidak ditentukan, Wil AWS ayah default yang terkait dengan pengguna IAM yang memanggil akan digunakan.
+ Secara opsional, lokasi khusus untuk menginstal CodeDeploy agen (dengan `--agent-installer` opsi). Opsi ini berguna untuk menginstal versi kustom CodeDeploy agen yang CodeDeploy tidak mendukung secara resmi (seperti versi kustom berdasarkan [ repositori ](https://github.com/aws/aws-codedeploy-agent) CodeDeploy agen di GitHub). Nilai harus berupa jalur ke bucket Amazon S3 yang berisi salah satu:
+ Skrip instalasi CodeDeploy agen (untuk Linux- atau sistem Unix-based operasi, mirip dengan file instal di [ repositori ](https://github.com/aws/aws-codedeploy-agent/blob/master/bin/install) CodeDeploy agen di GitHub).
+ File paket penginstal CodeDeploy agen (.msi) (untuk sistem Windows-based operasi).
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
```
Per **install** intah 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 instans ke lokasi tempat CodeDeploy agen mengharapkan 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`\\`conf.onpremises.yml`.
Jika `--override-config` opsi ditentukan, membuat atau mengganti file.
1. Menginstal CodeDeploy agen pada instans lokal dan kemudian memulainya.
## Langkah 4: Menyebarkan revisi aplikasi ke instans lokal
Anda sekarang siap untuk menerapkan revisi aplikasi ke instans lokal yang terdaftar dan diberi tag.
Anda menyebarkan 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 penerapan, dan menyiapkan revisi aplikasi. Jika Anda memerlukan revisi aplikasi sampel sederhana untuk diterapkan, Anda dapat membuat yang dijelaskan [Langkah 2: Buat contoh revisi aplikasi](tutorials-on-premises-instance-2-create-sample-revision.md) di[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 instans lokal, Anda `Tag:get*` harus menyer `Action` takan bagian pernyataan kebijakan peran layanan tersebut. Untuk informasi selengkapnya, lihat [Langkah 2: Buat peran layanan untuk CodeDeploy](getting-started-create-service-role.md).
## Langkah 5: Melacak 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).
Untuk opsi lainnya, lihat[Mengelola operasi instans lokal di CodeDeploy](on-premises-instances-operations.md).