

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan `register` Perintah
<a name="registered-instances-register-registering-command"></a>

**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.

Untuk mendaftarkan instance, pastikan Anda menjalankan setidaknya versi 1.16.180 dari. AWS CLI Berikut ini menunjukkan sintaks umum untuk `register` perintah.

```
aws opsworks register \
  [--profile profile_name] \
  [--region region_name] \
  --infrastructure-class instance_type \
  --stack-id stack ID \
  [--local] | [--ssh-private-key key_file --ssh-username username] | [--override-ssh command_string] \
  [--override-hostname hostname] \
  [--debug] \
  [--override-public-ip public IP] \
  [--override-private-ip private IP] \
..[--use-instance-profile] \
  [ [IP address] | [hostname] | [instance ID]
```

Argumen berikut umum untuk semua AWS CLI perintah.

**`--profile`**  
(Opsional) Nama profil kredensialnya. Jika Anda menghilangkan argumen ini, perintah berjalan dengan kredenal default Anda. Untuk informasi selengkapnya tentang cara AWS CLI menentukan kredensyal default, lihat [Mengonfigurasi Antarmuka Baris Perintah AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

**`--region`**  
 (Opsional) OpsWorks Wilayah titik akhir layanan Stacks. Jangan disetel `--region` ke Wilayah tumpukan. OpsWorks Tumpukan secara otomatis menentukan Wilayah tumpukan dari ID tumpukan.  
Jika Region default Anda sudah disetel, Anda dapat menghilangkan argumen ini. Untuk informasi selengkapnya tentang cara menentukan Region default, lihat [Mengonfigurasi Antarmuka Baris Perintah AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

Gunakan argumen berikut untuk instans Amazon EC2 dan lokal.

**`--infrastructure-class`**  
(Wajib) Parameter ini harus disetel ke salah satu `ec2` atau`on-premises`, untuk menunjukkan apakah Anda mendaftarkan instans Amazon EC2 atau lokal.

**`--stack-id`**  
(Wajib) ID tumpukan tempat instance akan didaftarkan.  
Untuk menemukan ID tumpukan, pada halaman **Stack**, pilih **Pengaturan**. ID tumpukan diberi label **OpsWorks ID**, dan merupakan GUID yang terlihat seperti. `ad21bce6-7623-47f1-bf9d-af2affad8907`

**Argumen Login SSH**  
Gunakan argumen berikut untuk menentukan bagaimana `register` harus masuk ke instance.    
**`--local`**  
(Opsional) Gunakan argumen ini untuk mendaftarkan instance tempat Anda menjalankan perintah.   
Dalam hal ini, `register` tidak perlu masuk ke instance.  
**`--ssh-private-key` dan `--ssh-username`**  
 (Opsional) Gunakan argumen ini jika Anda mendaftarkan instance dari workstation terpisah dan ingin secara eksplisit menentukan nama pengguna atau file kunci pribadi.  
+ `--ssh-username`— Gunakan argumen ini untuk menentukan nama pengguna SSH.

  Jika Anda menghilangkan`--ssh-username`, `ssh` gunakan nama pengguna default.
+ `--ssh-private-key`— Gunakan argumen ini untuk secara eksplisit menentukan file kunci pribadi.

  Jika Anda menghilangkan`--ssh-private-key`, `ssh` mencoba masuk menggunakan teknik otentikasi yang tidak memerlukan kata sandi, termasuk menggunakan kunci pribadi default. Jika tidak ada teknik yang didukung, `ssh` kueri untuk kata sandi Anda. Untuk informasi selengkapnya tentang cara `ssh` menangani otentikasi, lihat Protokol [Otentikasi Secure Shell (SSH)](https://www.ietf.org/rfc/rfc4252.txt).  
**`--override-ssh`**  
 (Opsional) Gunakan argumen ini jika Anda mendaftarkan instance dari workstation terpisah dan ingin menentukan string [http://linux.about.com/od/commands/l/blcmdl1_ssh.htm](http://linux.about.com/od/commands/l/blcmdl1_ssh.htm)perintah kustom. `register`Perintah menggunakan string perintah ini untuk masuk ke instance terdaftar.
Untuk informasi selengkapnya`ssh`, lihat [SSH](http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man1/slogin.1).

**`--override-hostname`**  
 (Opsional) Menentukan nama host untuk contoh, yang hanya digunakan oleh OpsWorks Stacks. Nilai default adalah nama host instance.

**`--debug`**  
(Opsional) Menyediakan informasi debugging jika proses pendaftaran gagal. Untuk informasi pemecahan masalah, lihat [Pemecahan Masalah Pendaftaran Instans](common-issues.md#common-issues-instance-registration).

**`--use-instance-profile`**  
(Opsional, tetapi sangat disarankan untuk EC2 instance Amazon) Memungkinkan `register` perintah menggunakan profil instance terlampir, alih-alih membuat pengguna IAM. Menambahkan parameter ini dapat membantu mencegah kesalahan yang terjadi jika Anda mencoba mengelola instance terdaftar ketika pengguna IAM secara tidak sengaja dihapus.  
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 yang diperlukan.

**Target**  
(Bersyarat) Jika Anda menjalankan perintah ini dari workstation, nilai akhir dalam string perintah menentukan target pendaftaran dengan salah satu cara berikut.  
+ Alamat IP publik instans.
+ Nama host instance.
+ Untuk EC2 instans Amazon, ID instans.

  OpsWorks Stacks menggunakan ID instance untuk mendapatkan konfigurasi instance, termasuk alamat IP publik instans. Secara default, OpsWorks Stacks menggunakan alamat ini untuk membangun string `ssh` perintah yang digunakannya untuk masuk ke instance. Jika Anda perlu terhubung ke alamat IP pribadi, Anda harus menggunakan `--override-ssh` untuk memberikan string perintah khusus. Sebagai contoh, lihat [Mendaftarkan Instance Lokal dari Workstation](registered-instances-register-registering-examples.md#registered-instances-register-registering-examples-workstation-onprem).
Jika Anda menentukan nama host, `ssh` tergantung pada server DNS untuk menyelesaikan nama ke instance tertentu. Jika Anda tidak yakin bahwa nama host unik, gunakan `ssh` untuk memverifikasi bahwa nama host diselesaikan ke instance yang benar.
Jika Anda menjalankan perintah ini dari instance yang akan didaftarkan, hilangkan pengenal instance dan gunakan argumennya`--local`.

Argumen berikut hanya untuk instance lokal.

**`--override-public-ip`**  
(Opsional) OpsWorks Stacks menampilkan alamat yang ditentukan sebagai alamat IP publik instans. Itu tidak mengubah alamat IP publik instance. Namun, jika pengguna menggunakan konsol untuk terhubung ke instance, seperti dengan memilih alamat di halaman **Instans**, OpsWorks Stacks menggunakan alamat yang ditentukan. OpsWorks Tumpukan secara otomatis menentukan nilai default argumen.

**`--override-private-ip`**  
(Opsional) OpsWorks Stacks menampilkan alamat yang ditentukan sebagai alamat IP pribadi instans. Itu tidak mengubah alamat IP pribadi instance. OpsWorks Tumpukan secara otomatis menentukan nilai default argumen. 