

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

# Mengonfigurasi EB CLI
<a name="eb-cli3-configuration"></a>

Setelah [menginstal CLI EB](eb-cli3.md#eb-cli3-install), Anda siap untuk mengkonfigurasi direktori proyek Anda dan CLI EB dengan **eb init** menjalankan.Contoh berikut menunjukkan langkah-langkah konfigurasi saat **eb init** berjalan untuk pertama kalinya dalam folder proyek bernama. `eb`

**Untuk menginisialisasi proyek EB CLI**

1. Pertama, EB CLI meminta Anda untuk memilih wilayah. Pilih wilayah pilihan Anda.

   ```
   ~/eb $ eb init
   Select a default region
   1) us-east-1 : US East (N. Virginia)
   2) us-west-1 : US West (N. California)
   3) us-west-2 : US West (Oregon)
   4) eu-west-1 : Europe (Ireland)
   5) eu-central-1 : Europe (Frankfurt)
   6) ap-south-1 : Asia Pacific (Mumbai)
   7) ap-southeast-1 : Asia Pacific (Singapore)
   ...
   (default is 3): 3
   ```

1. Jika diminta, berikan kunci akses dan kunci rahasia Anda sehingga CLI EB dapat mengelola sumber daya untuk Anda. Kunci akses dibuat di AWS Identity and Access Management konsol. Jika Anda tidak memiliki kunci, lihat [Bagaimana Saya Mendapatkan Kredensi Keamanan](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html)? di *Referensi Umum Amazon Web Services*.

   ```
   You have not yet set up your credentials or your credentials are incorrect.
   You must provide your credentials.
   (aws-access-id): {{AKIAJOUAASEXAMPLE}}
   (aws-secret-key): {{5ZRIrtTM4ciIAvd4EXAMPLEDtm+PiPSzpoK}}
   ```

1. Aplikasi Elastic Beanstalk adalah sumber daya yang berisi serangkaian versi aplikasi (sumber), lingkungan, dan konfigurasi tersimpan yang terkait dengan satu aplikasi web. Setiap kali Anda men-deploy kode sumber Anda ke Elastic Beanstalk menggunakan EB CLI, versi aplikasi baru dibuat dan ditambahkan ke daftar.

   ```
   Select an application to use
   1) [ Create new Application ]
   (default is 1): 1
   ```

1. Nama aplikasi default adalah nama folder tempat Anda menjalankan **eb init**. Masukkan nama yang menggambarkan proyek Anda.

   ```
   Enter Application Name
   (default is "eb"): eb
   Application eb has been created.
   ```

1. Pilih platform yang cocok dengan bahasa atau kerangka kerja tempat aplikasi web Anda dikembangkan. Jika Anda belum mulai mengembangkan aplikasi, pilih platform yang Anda minati. Anda akan segera melihat cara meluncurkan aplikasi sampel, dan Anda selalu dapat mengubah pengaturan ini nanti.

   ```
   Select a platform.
   1) .NET Core on Linux
   2) .NET on Windows Server
   3) Docker
   4) Go
   5) Java
   6) Node.js
   7) PHP         <== select platform by number
   8) Packer
   9) Python
   10) Ruby
   11) Tomcat
   (make a selection):7
   ```

1. Pilih cabang platform tertentu.

   ```
   Select a platform branch.
   1) PHP 8.4 running on 64bit Amazon Linux 2023
   2) PHP 8.3 running on 64bit Amazon Linux 2023
   3) PHP 8.2 running on 64bit Amazon Linux 2023
   4) PHP 8.1 running on 64bit Amazon Linux 2023
   5) PHP 8.1 running on 64bit Amazon Linux 2
   (default is 1):1
   ```

1. Pilih **ya** untuk menetapkan pasangan kunci SSH untuk instans di lingkungan Elastic Beanstalk Anda. Ini mengizinkan Anda terhubung langsung ke mereka untuk pemecahan masalah.

   ```
   Do you want to set up SSH for your instances?
   (y/n): y
   ```

1. Anda dapat memilih pasangan kunci yang sudah ada atau membuat yang baru. Untuk menggunakan **eb init** untuk membuat pasangan kunci baru, Anda harus memasang **ssh-keygen** di komputer lokal Anda dan tersedia dari baris perintah. EB CLI mendaftarkan key pair baru dengan EC2 Amazon untuk Anda dan menyimpan kunci pribadi secara lokal dalam folder `.ssh` bernama di direktori pengguna Anda.

   ```
   Select a keypair.
   1) [ Create new KeyPair ]
   (default is 1): 1
   ```

Pemasangan EB CLI Anda sekarang sudah dikonfigurasi dan siap digunakan.

**Topics**
+ [Mengabaikan file menggunakan .ebignore](#eb-cli3-ebignore)
+ [Menggunakan profil bernama](#eb-cli3-profile)
+ [Men-deploy artifact bukan folder proyek](#eb-cli3-artifact)
+ [Pengaturan konfigurasi dan prioritas](#eb-cli3-credentials)
+ [Metadata instans](#eb-cli3-metadata)

## Mengabaikan file menggunakan .ebignore
<a name="eb-cli3-ebignore"></a>

Anda dapat memberitahu EB CLI untuk mengabaikan file tertentu di direktori proyek Anda dengan menambahkan file `.ebignore` ke direktori. File ini bekerja seperti file `.gitignore`. Ketika Anda men-deploy direktori proyek Anda ke Elastic Beanstalk dan membuat versi aplikasi baru, EB CLI tidak menyertakan file yang ditentukan oleh `.ebignore` di paket sumber yang dibuatnya.

Jika `.ebignore` tidak ada, tetapi ada `.gitignore`, EB CLI mengabaikan file yang ditentukan di `.gitignore`. Jika `.ebignore` ada, EB CLI tidak membaca `.gitignore`.

Saat `.ebignore` ada, EB CLI tidak menggunakan perintah git untuk membuat paket sumber Anda. Ini berarti bahwa EB CLI mengabaikan file yang ditentukan di `.ebignore`, dan menyertakan semua file lainnya. Khususnya, ia termasuk file sumber yang tidak terikat.

**catatan**  
Di Windows, menambahkan `.ebignore` menyebabkan EB CLI mengikuti tautan simbolik dan menyertakan file bertautan saat membuat paket sumber. Ini adalah masalah yang diketahui dan akan diperbaiki di pembaruan masa mendatang.

## Menggunakan profil bernama
<a name="eb-cli3-profile"></a>

Jika Anda menyimpan kredensial Anda sebagai profil bernama di file `credentials` atau `config`, Anda dapat menggunakan opsi [`--profile`](eb3-cmd-options.md) untuk secara eksplisit menentukan profil. Sebagai contoh, perintah berikut membuat aplikasi baru menggunakan profil `user2`.

```
$ eb init --profile {{user2}}
```

Anda juga dapat mengubah profil default dengan menetapkan variabel lingkungan `AWS_EB_PROFILE`. Ketika variabel ini diatur, EB CLI membaca kredensial dari profil yang ditentukan, bukan dari `default` atau **eb-cli**.

**Linux, macOS, atau Unix**

```
$ export AWS_EB_PROFILE={{user2}}
```

**Windows**

```
> set AWS_EB_PROFILE={{user2}}
```

## Men-deploy artifact bukan folder proyek
<a name="eb-cli3-artifact"></a>

Anda dapat memberitahu EB CLI untuk men-deploy file ZIP atau file WAR yang Anda hasilkan sebagai bagian dari proses pembangunan terpisah dengan menambahkan baris berikut ke `.elasticbeanstalk/config.yml` di folder proyek Anda.

```
deploy:
  artifact: {{path/to/buildartifact.zip}}
```

Jika Anda mengonfigurasi EB CLI di [repositori git](eb3-cli-git.md), dan anda tidak melakukan artifact ke sumber, gunakan opsi `--staged` untuk men-deploy pembangunan terbaru.

```
~/eb$ eb deploy --staged
```

## Pengaturan konfigurasi dan prioritas
<a name="eb-cli3-credentials"></a>

EB CLI menggunakan rantai *penyedia* AWS untuk mencari kredensi di sejumlah tempat berbeda, termasuk variabel sistem atau lingkungan pengguna dan file konfigurasi lokal. AWS 

EB CLI mencari kredensial dan pengaturan konfigurasi dalam urutan berikut:

1. **Opsi baris perintah** – Tentukan profil bernama dengan menggunakan `--profile` untuk mengganti pengaturan default.

1. **Variabel lingkungan** – `AWS_ACCESS_KEY_ID` dan `AWS_SECRET_ACCESS_KEY`.

1. **File AWS kredensial** — Terletak `~/.aws/credentials` di sistem Linux dan OS X, atau `C:\Users\{{USERNAME}}\.aws\credentials` di sistem Windows. File ini dapat berisi beberapa profil bernama selain profil default.

1. **File konfigurasi [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)** – Terletak pada `~/.aws/config` di sistem Linux dan OS X atau pada `C:\Users\{{USERNAME}}\.aws\config` di sistem Windows. File ini dapat berisi profil default, [profil bernama](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-multiple-profiles), dan AWS CLI parameter konfigurasi spesifik untuk masing-masing.

1. **File konfigurasi EB CLI warisan** – Terletak pada `~/.elasticbeanstalk/config` di sistem Linux dan OS X atau pada `C:\Users\{{USERNAME}}\.elasticbeanstalk\config` di sistem Windows.

1. **Kredensial profil instans** — Kredensional ini dapat digunakan di EC2 instans Amazon dengan peran instans yang ditetapkan, dan dikirimkan melalui layanan metadata Amazon. EC2 [Profil instans](concepts-roles-instance.md) harus memiliki izin untuk menggunakan Elastic Beanstalk.

Jika file kredensial berisi profil bernama dengan nama "eb-cli", EB CLI akan lebih memilih profil tersebut daripada profil default. Jika profil tidak ditemukan, atau profil ditemukan tetapi tidak memiliki izin untuk menggunakan Elastic Beanstalk, EB CLI meminta Anda untuk memasukkan kunci.

## Metadata instans
<a name="eb-cli3-metadata"></a>

Untuk menggunakan CLI EB dari instans EC2 Amazon, buat peran yang memiliki akses ke sumber daya yang dibutuhkan dan tetapkan peran tersebut ke instance saat diluncurkan. Peluncuran instans dan memasang EB CLI dengan menggunakan `pip`.

```
~$ sudo pip install awsebcli
```

`pip` muncul dalam kondisi sudah terpasang di Amazon Linux.

EB CLI membaca kredensial dari metadata instans. Untuk informasi selengkapnya, lihat [Memberikan Aplikasi yang Berjalan di EC2 Instans Amazon Akses ke AWS Sumber Daya di Panduan](https://docs.aws.amazon.com/IAM/latest/UserGuide/role-usecase-ec2app.html) Pengguna *IAM*.