Mengonfigurasi EB CLI

Setelah memasang EB CLI, Anda siap untuk mengonfigurasi direktori proyek Anda dan EB CLI dengan menjalankan eb init.

Contoh berikut menunjukkan langkah-langkah konfigurasi saat menjalankan eb init untuk pertama kalinya di folder proyek bernama eb.

Untuk menginisialisasi proyek EB CLI

1. Pertama, EB CLI meminta Anda untuk memilih wilayah. Ketik nomor yang sesuai dengan wilayah yang ingin Anda gunakan, dan kemudian tekan Enter.

   ~/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

2. Selanjutnya, berikan access key dan kunci rahasia Anda, sehingga EB CLI dapat mengelola sumber daya untuk Anda. Access key dibuat di konsol AWS Identity and Access Management. Jika Anda tidak memiliki kunci, lihat Bagaimana Cara Mendapatkan Kredenial Keamanan? di Referensi Umum Amazon Web.

   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

3. Sebuah aplikasi di Elastic Beanstalk adalah sumber daya yang berisi satu set versi aplikasi (sumber), lingkungan, dan konfigurasi tersimpan yang terkait dengan aplikasi web tunggal. 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

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

5. 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) Node.js
   2) PHP
   3) Python
   4) Ruby
   5) Tomcat
   6) IIS
   7) Docker
   8) Multi-container Docker
   9) GlassFish
   10) Go
   11) Java
   (default is 1): 1

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

7. 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 pasangan kunci baru dengan Amazon EC2 untuk Anda dan menyimpan kunci privat secara lokal di folder bernama .ssh 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. Lihat Mengelola beberapa lingkungan Elastic Beanstalk sebagai grup dengan EB CLI untuk petunjuk tentang membuat dan bekerja dengan lingkungan Elastic Beanstalk.

Mengabaikan file menggunakan .ebignore

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

Jika Anda menyimpan kredensial Anda sebagai profil bernama di file credentials atau config, Anda dapat menggunakan opsi --profile 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

Jendela

> set AWS_EB_PROFILE=user2

Men-deploy artifact bukan folder proyek

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, dan anda tidak melakukan artifact ke sumber, gunakan opsi --staged untuk men-deploy pembangunan terbaru.

~/eb$ eb deploy --staged

Pengaturan konfigurasi dan prioritas

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

EB CLI mencari kredensial dan pengaturan konfigurasi dalam urutan berikut:

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

2. Variabel lingkungan – AWS_ACCESS_KEY_ID dan AWS_SECRET_ACCESS_KEY.

3. File kredensial AWS – Terletak pada ~/.aws/credentials di sistem Linux dan OS X, atau pada C:\Users\USERNAME\.aws\credentials di sistem Windows. File ini dapat berisi beberapa profil bernama selain profil default.

4. File konfigurasi AWS CLI – 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, dan AWS CLI–parameter konfigurasi spesifik untuk masing-masing.

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

6. Kredensial profil instans – Kredensial ini dapat digunakan di instans Amazon EC2 dengan peran instans yang ditugaskan, dan disampaikan melalui layanan metadata Amazon EC2. Profil instans 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

Untuk menggunakan EB CLI dari instans Amazon EC2, buat peran yang memiliki akses ke sumber daya yang diperlukan dan menetapkan peran tersebut ke instans ketika 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 Pemberian Aplikasi yang Berjalan di akses Instans Amazon EC2 ke Sumber Daya AWS di Panduan Pengguna IAM.