Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.