Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Walkthrough: Daftarkan Instance dari Workstation Anda
**penting**
AWS OpsWorks Stacks Layanan ini mencapai akhir masa pakai pada 26 Mei 2024 dan telah dinonaktifkan untuk pelanggan baru dan yang sudah ada. Kami sangat menyarankan pelanggan untuk memindahkan beban kerja mereka ke solusi lain sesegera mungkin. Jika Anda memiliki pertanyaan tentang migrasi, hubungi AWS Dukungan Tim di [AWS re:Post](https://repost.aws/) atau melalui [AWS Dukungan](https://aws.amazon.com/support) Premium.
**catatan**
Fitur ini hanya didukung untuk tumpukan Linux.
Proses pendaftaran mendukung beberapa skenario. Bagian ini memandu Anda melalui end-to-end contoh satu skenario: cara menggunakan workstation Anda untuk mendaftarkan EC2 instans Amazon. Skenario pendaftaran lainnya menggunakan prosedur serupa. Untuk informasi selengkapnya, lihat [Mendaftarkan Amazon EC2 dan Instans Lokal](registered-instances-register-registering.md).
**catatan**
Anda biasanya ingin mendaftarkan EC2 instans Amazon yang ada. Namun, Anda bisa membuat instance baru dan tumpukan baru untuk panduan dan menghapusnya setelah selesai.
**Topics**
+ [Langkah 1: Buat Stack dan Instance](#registered-instances-register-walkthrough-prepare)
+ [Langkah 2: Instal dan Konfigurasikan AWS CLI](#registered-instances-register-walkthrough-cli)
+ [Langkah 3: Daftarkan Instance dengan EC2 Register Stack](#registered-instances-register-walkthrough-register)
## Langkah 1: Buat Stack dan Instance
Untuk memulai, Anda memerlukan tumpukan dan EC2 instance Amazon untuk didaftarkan dengan tumpukan itu.
**Untuk membuat tumpukan dan instance**
1. Gunakan [konsol OpsWorks Stacks](https://console.aws.amazon.com/opsworks/) untuk [membuat tumpukan baru](workingstacks-creating.md) bernama**EC2Register**. Anda dapat menerima nilai default untuk pengaturan tumpukan lainnya.
1. Luncurkan instance baru dari [ EC2 konsol Amazon](https://console.aws.amazon.com/ec2/). Perhatikan hal berikut.
+ Instance harus berada di wilayah dan VPC yang sama dengan tumpukan.
Jika Anda menggunakan VPC, pilih subnet publik untuk panduan ini.
+ Jika Anda perlu membuat kunci SSH, simpan file kunci pribadi ke workstation Anda dan catat nama dan lokasi file.
Jika Anda menggunakan kunci yang ada, catat nama dan lokasi file kunci pribadi. Anda membutuhkan nilai-nilai itu nanti.
+ Instans harus didasarkan pada salah satu [sistem operasi Linux yang didukung](workinginstances-os-linux.md). Misalnya, jika tumpukan Anda berada di US West (Oregon), Anda dapat menggunakan `ami-35501205` untuk meluncurkan instance Ubuntu 14.04 LTS di wilayah itu.
Jika tidak, terima nilai default.
Saat instance booting, Anda dapat melanjutkan ke bagian berikutnya.
## Langkah 2: Instal dan Konfigurasikan AWS CLI
Pendaftaran dilakukan dengan menggunakan AWS CLI **aws opsworks register** perintah. Sebelum Anda mendaftarkan instans pertama Anda, Anda harus menjalankan versi 1.16.180 AWS CLI atau yang lebih baru. Detail instalasi tergantung pada sistem operasi workstation Anda. Untuk informasi selengkapnya tentang menginstal AWS CLI, lihat [Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html). Untuk memeriksa versi AWS CLI yang Anda jalankan, masukkan `aws --version` dalam sesi shell.
**catatan**
Untuk mencegah pengguna atau peran mendaftarkan instance, perbarui profil instans untuk menolak akses ke **register** perintah.
Kami sangat menyarankan agar Anda tidak melewatkan langkah ini, bahkan jika Anda sudah menjalankan AWS CLI di workstation Anda. Menggunakan rilis terbaru dari ini AWS CLI adalah praktik terbaik keamanan.
Anda harus `register` menyediakan satu set kredensi AWS yang memiliki izin yang sesuai. Cara yang disarankan untuk melakukan ini—sehingga Anda menghindari menginstal kredensyal secara langsung pada sebuah instance—adalah dengan mendaftarkan instance yang diluncurkan dengan profil instans, dan kemudian menambahkan sakelar ke perintah Anda. `--use-instance-profile` `register` Jika Anda mendapatkan kredensi dari profil instance, lewati ke topik [Langkah 3: Daftarkan Instance dengan EC2 Register Stack](#registered-instances-register-walkthrough-register) ini. Namun, jika instans Anda tidak diluncurkan dengan profil instans, Anda dapat membuat pengguna IAM. Prosedur berikut membuat pengguna baru dengan izin yang sesuai, menginstal kredensi pengguna di workstation, dan kemudian meneruskan kredensialnya ke. `register`
**Awas**
Pengguna IAM memiliki kredensi jangka panjang, yang menghadirkan risiko keamanan. Untuk membantu mengurangi risiko ini, kami menyarankan agar Anda memberikan pengguna ini hanya izin yang mereka perlukan untuk melakukan tugas dan menghapus pengguna ini ketika mereka tidak lagi diperlukan.
**Untuk membuat pengguna**
1. Di [konsol IAM](https://console.aws.amazon.com/iam/), pilih **Pengguna** di panel navigasi, lalu pilih **Tambah** pengguna.
1. Tambahkan pengguna bernama**EC2Register**.
1. Pilih **Berikutnya**.
1. Pada halaman **Setel izin**, pilih **Lampirkan kebijakan secara langsung**.
1. Masukkan **OpsWorks** kotak Filter **kebijakan izin** untuk menampilkan OpsWorks kebijakan, pilih salah satu kebijakan berikut, lalu pilih **Berikutnya: tinjau**. Kebijakan ini memberi pengguna izin yang diperlukan untuk menjalankannya. `register`
+ Pilih `AWSOpsWorksRegisterCLI_EC2` untuk mengizinkan izin pengguna untuk mendaftarkan EC2 instance yang menggunakan profil instance.
+ Pilih `AWSOpsWorksRegisterCLI_OnPremises` untuk mengizinkan izin pengguna untuk mendaftarkan instance lokal.
1. Pilih **Berikutnya**.
1. Pada halaman **Tinjauan**, pilih **Buat pengguna**.
1. Sekarang buat kunci akses untuk pengguna Anda. Dari panel navigasi, pilih **Pengguna**, lalu pilih pengguna yang ingin Anda buat kunci aksesnya.
1. Pilih tab **Security credentials**, lalu pilih **Create access key**.
1. Pilih **praktik & alternatif terbaik kunci Akses** yang paling sesuai dengan tugas Anda.
1. Pilih **Berikutnya**.
1. (Opsional) masukkan tag untuk mengidentifikasi kunci akses.
1. Pilih **Berikutnya**.
1. **Pilih **Unduh file.csv, simpan file** kredensyal ke lokasi yang nyaman di sistem Anda, dan pilih Selesai.**
Anda perlu memberikan kredensi pengguna IAM ke. `register` Panduan ini menangani tugas dengan menginstal kredenal EC2 Register di file workstation Anda. `credentials` Untuk informasi tentang cara lain mengelola kredensialnya AWS CLI, lihat File [Konfigurasi dan Kredenal](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files).
**Untuk menginstal kredensi pengguna**
1. Buat atau buka `credentials` file workstation Anda. File ini terletak di `~/.aws/credentials` (Linux, Unix, dan OS X) atau `C:\Users\User_Name\.aws\credentials` (sistem Windows).
1. Tambahkan profil untuk pengguna EC2 Register ke `credentials` file, menggunakan format berikut.
```
[ec2register]
aws_access_key_id = access_key_id
aws_secret_access_key = secret_access_key
```
Ganti *access\$1key\$1id* dan *secret\$1access\$1key* dengan tombol EC2 Daftar untuk yang Anda unduh sebelumnya.
## Langkah 3: Daftarkan Instance dengan EC2 Register Stack
Anda sekarang siap untuk mendaftarkan instance.
**Untuk mendaftarkan instance**
1. Di OpsWorks Tumpukan, kembali ke tumpukan EC2 Register, pilih **Instans** di panel navigasi, lalu pilih **Daftar** instance.
1. Pilih **EC2 Instans**, pilih **Berikutnya: Pilih Instans**, dan pilih instans Anda dari daftar.
1. Pilih **Berikutnya: Instal AWS CLI**, dan **Berikutnya: Daftarkan** Instans. OpsWorks Stacks secara otomatis menggunakan informasi yang tersedia, seperti ID tumpukan dan ID instance untuk membuat template `register` perintah, yang ditampilkan di halaman **Daftar Instans**. **Untuk contoh ini, Anda gunakan `register` untuk masuk ke instance dengan kunci SSH dan secara eksplisit menentukan file kunci, jadi atur **saya menggunakan kunci SSH untuk terhubung ke instance saya ke Ya**.** Template perintah menyerupai berikut ini.
```
aws opsworks register --infrastructure-class ec2 --region region endpoint ID
--stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username [username]
--ssh-private-key [key-file] i-f1245d10
```
**catatan**
Anda harus menyetel Wilayah ke Wilayah titik akhir layanan OpsWorks Stacks, bukan Wilayah tumpukan, jika tumpukan berada dalam Wilayah klasik yang terkait dengan titik akhir `us-east-1` regional. OpsWorks Tumpukan menentukan Wilayah tumpukan dari ID tumpukan.
1. Template perintah berisi beberapa nilai argumen khusus pengguna, yang ditunjukkan oleh tanda kurung dan harus diganti dengan nilai yang sesuai. Salin template perintah ke editor teks dan edit sebagai berikut.
**penting**
Pengguna IAM yang dibuat selama proses pendaftaran diperlukan sepanjang masa pakai instance terdaftar. Menghapus pengguna menyebabkan agen OpsWorks Stacks tidak dapat berkomunikasi dengan layanan. Untuk membantu mencegah masalah dalam mengelola instance terdaftar jika pengguna terhapus secara tidak sengaja, tambahkan `--use-instance-profile` parameter ke `register` perintah Anda untuk menggunakan profil instans bawaan instans sebagai gantinya. Menambahkan `--use-instance-profile` parameter juga mencegah kesalahan terjadi ketika Anda memutar kunci akses AWS akun setiap 90 hari (praktik terbaik yang disarankan), karena mencegah ketidakcocokan antara kunci akses yang tersedia untuk OpsWorks agen dan pengguna IAM yang diperlukan.
+ Ganti *key file* dengan path yang sepenuhnya memenuhi syarat dari file kunci pribadi untuk EC2 key pair Amazon yang disimpan saat membuat instance.
Anda dapat menggunakan jalur relatif, jika Anda mau.
+ Ganti *username* dengan nama pengguna instance.
Untuk contoh ini, nama pengguna adalah`ubuntu`, untuk instance Ubuntu, atau`ec2-user`, untuk Red Hat Enterprise Linux (RHEL) atau instance Amazon Linux.
+ Add`--use-instance-profile`, yang berjalan `register` dengan profil instance untuk mencegah kesalahan selama rotasi kunci atau jika pengguna IAM utama terhapus secara tidak sengaja.
Perintah Anda harus menyerupai yang berikut ini.
```
aws opsworks register --use-instance-profile --infrastructure-class ec2 \
--region us-west-2 --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username ubuntu \
--ssh-private-key "./keys/mykeys.pem" i-f1245d10
```
1. Buka jendela terminal di workstation Anda, tempel `register` perintah dari editor Anda, dan jalankan perintah.
Pendaftaran biasanya memakan waktu sekitar lima menit. Setelah selesai, kembali ke konsol OpsWorks Stacks dan pilih **Selesai**. Kemudian pilih **Instans** di panel navigasi. Instance Anda harus terdaftar di bawah **Instans yang Tidak Ditugaskan**. Anda kemudian dapat [menetapkan instance ke lapisan](registered-instances-assign.md) atau membiarkannya di tempatnya, tergantung pada bagaimana Anda bermaksud mengelola instance.
1. Setelah selesai, [hentikan instance](workinginstances-starting.md#workinginstances-starting-stop) dan [hapus](workinginstances-starting.md#workinginstances-starting-stop) dengan menggunakan konsol OpsWorks Stacks atau perintah. Ini mengakhiri EC2 instans Amazon, sehingga Anda tidak dikenakan biaya lebih lanjut.