Menggunakan EB CLI dengan AWS CodeCommit

Anda dapat menggunakan EB CLI untuk men-deploy aplikasi Anda langsung dari repositori AWS CodeCommit Anda. DenganCodeCommit, Anda hanya dapat mengunggah perubahan Anda ke repositori saat Anda men-deploy, alih-alih mengunggah seluruh proyek Anda. Hal ini dapat menghemat waktu dan bandwidth jika Anda memiliki proyek besar atau konektivitas Internet terbatas. EB CLI mendorong komitmen lokal Anda dan menggunakannya untuk membuat versi aplikasi ketika Anda menggunakan eb appversion, eb create atau eb deploy.

Untuk men-deploy perubahan Anda,CodeCommitintegrasi mengharuskan Anda melakukan perubahan terlebih dahulu. Namun, saat Anda mengembangkan atau debug, Anda mungkin tidak ingin mendorong perubahan yang Anda belum dikonfirmasi berfungsi. Anda dapat menghindari melakukan perubahan dengan mementaskannya dan menggunakan eb deploy --staged (yang melakukan deployment standar). Atau lakukan perubahan Anda ke cabang pengembangan atau pengujian terlebih dahulu, dan gabungkan ke cabang utama Anda hanya ketika kode Anda siap. Dengan eb use, Anda dapat mengonfigurasi EB CLI untuk men-deploy ke satu lingkungan dari cabang pengembangan Anda, dan untuk lingkungan yang berbeda dari cabang utama Anda.

catatan

Beberapa wilayah tidak menawarkanCodeCommit. Integrasi antara Elastic Beanstalk danCodeCommittidak bekerja di wilayah ini.

Untuk informasi tentang layanan AWS yang ditawarkan di setiap wilayah, lihat Tabel Wilayah.

Prasyarat

Untuk menggunakanCodeCommitbersamaAWS Elastic Beanstalk, Anda memerlukan repositori Git lokal (salah satu dari yang sudah Anda miliki atau yang baru Anda buat) dengan setidaknya satu komitmen,izin untuk menggunakanCodeCommit, dan lingkungan Elastic Beanstalk di wilayah yangCodeCommitmendukung. Lingkungan dan repositori Anda harus berada di wilayah yang sama.

Untuk menginisialisasi repositori Git

1. Jalankan git init di folder proyek Anda.

   ~/my-app$ git init

2. Siapkan file proyek Anda dengan git add.

   ~/my-app$ git add .

3. Melakukan perubahan dengan git commit.

   ~/my-app$ git commit -m "Elastic Beanstalk application"

MembuatCodeCommitrepositori dengan EB CLI

Untuk memulaiCodeCommit, jalankaneb init. Selama konfigurasi repositori, EB CLI meminta Anda untuk menggunakanCodeCommituntuk menyimpan kode Anda dan mempercepat deployment. Bahkan jika Anda sebelumnya mengkonfigurasi proyek Anda denganeb init, Anda dapat menjalankannya lagi untuk mengkonfigurasiCodeCommit.

Untuk membuatCodeCommitrepositori dengan EB CLI

1. Jalankan eb init di folder proyek Anda. Selama konfigurasi, EB CLI meminta Anda untuk menggunakanCodeCommituntuk menyimpan kode Anda dan mempercepat deployment. Jika sebelumnya Anda mengkonfigurasi proyek Anda denganeb init, Anda masih dapat menjalankannya lagi untuk mengkonfigurasiCodeCommit. Jenisydi prompt untuk mengaturCodeCommit.

   ~/my-app$ eb init
   Note: Elastic Beanstalk now supports AWS CodeCommit; a fully-managed source control service. To learn more, see Docs: https://aws.amazon.com/codecommit/
   Do you wish to continue with CodeCommit? (y/n)(default is n): y

2. Pilih Buat Repositori baru.

   Select a repository
   1) my-repo
   2) [ Create new Repository ]
   (default is 2): 2

3. Ketik nama repositori atau tekan Enter untuk menerima nama default.

   Enter Repository Name
   (default is "codecommit-origin"): my-app
   Successfully created repository: my-app

4. Pilih cabang yang ada untuk komitmen Anda, atau gunakan EB CLI untuk membuat cabang baru.

   Enter Branch Name
   ***** Must have at least one commit to create a new branch with CodeCommit *****
   (default is "mainline"): ENTER
   Successfully created branch: mainline

Menerapkan dariCodeCommitrepositori

Ketika Anda mengkonfigurasiCodeCommitdengan repositori EB CLI Anda, EB CLI menggunakan isi repositori untuk membuat paket sumber. Ketika Anda menjalankan eb deploy atau eb create, EB CLI mendorong komitmen baru dan menggunakan revisi HEAD cabang Anda untuk membuat arsip yang di-deploy ke instans EC2 di lingkungan Anda.

Untuk menggunakanCodeCommitintegrasi dengan EB CLI

1. Buat lingkungan baru dengan eb create.

   ~/my-app$ eb create my-app-env
   Starting environment deployment via CodeCommit
   --- Waiting for application versions to be pre-processed ---
   Finished processing application version app-ac1ea-161010_201918
   Setting up default branch
   Environment details for: my-app-env
     Application name: my-app
     Region: us-east-2
     Deployed Version: app-ac1ea-161010_201918
     Environment ID: e-pm5mvvkfnd
     Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8
     Tier: WebServer-Standard
     CNAME: UNKNOWN
     Updated: 2016-10-10 20:20:29.725000+00:00
   Printing Status:
   INFO: createEnvironment is starting.
   ...

   EB CLI menggunakan komitmen terbaru di cabang yang dilacak untuk membuat versi aplikasi yang di-deploy ke lingkungan.

2. Ketika Anda memiliki komitmen lokal baru, gunakan eb deploy untuk mendorong komitmen dan men-deploy ke lingkungan Anda.

   ~/my-app$ eb deploy
   Starting environment deployment via CodeCommit
   INFO: Environment update is starting.
   INFO: Deploying new version to instance(s).
   INFO: New application version was deployed to running EC2 instances.
   INFO: Environment update completed successfully.

3. Untuk menguji perubahan sebelum Anda melakukannya, gunakan opsi --staged untuk men-deploy perubahan yang Anda tambahkan ke area persiapan dengan git add.

   ~/my-app$ git add new-file
   ~/my-app$ eb deploy --staged

   Menerapkan dengan--stagedopsi melakukan deployment standar, melewatiCodeCommit.

Mengonfigurasi cabang dan lingkungan tambahan

CodeCommitkonfigurasi berlaku untuk satu cabang. Anda dapat menggunakan eb use dan eb codesource untuk mengonfigurasi cabang tambahan atau memodifikasi konfigurasi cabang saat ini.

Untuk mengonfigurasiCodeCommitintegrasi dengan EB CLI

1. Untuk mengubah cabang jarak jauh, gunakan opsi --source perintah eb use.

   ~/my-app$ eb use test-env --source my-app/test

2. Untuk membuat cabang dan lingkungan baru, periksa cabang baru, dorong keCodeCommit, menciptakan lingkungan, dan kemudian menggunakaneb useuntuk menghubungkan cabang lokal, cabang jarak jauh, dan lingkungan.

   ~/my-app$ git checkout -b production
   ~/my-app$ git push --set-upstream production
   ~/my-app$ eb create production-env
   ~/my-app$ eb use --source my-app/production production-env

3. Untuk mengonfigurasiCodeCommitsecara interaktif, gunakaneb codesource codecommit.

   ~/my-app$ eb codesource codecommit
   Current CodeCommit setup:
     Repository: my-app
     Branch: test
   Do you wish to continue (y/n): y
   
   Select a repository
   1) my-repo
   2) my-app
   3) [ Create new Repository ]
   (default is 2): 2
   
   Select a branch
   1) mainline
   2) test
   3) [ Create new Branch with local HEAD ]
   (default is 1): 1

4. Untuk menonaktifkanCodeCommitintegrasi, gunakaneb codesource local.

   ~/my-app$ eb codesource local
   Current CodeCommit setup:
     Repository: my-app
     Branch: mainline
   Default set to use local sources

MenggunakanCodeCommitrepositori

Jika Anda sudah memilikiCodeCommitrepositori dan ingin menggunakannya dengan Elastic Beanstalk, jalankaneb initdi root repositori lokal Anda.

Untuk menggunakanCodeCommitrepositori dengan EB CLI

1. Mengkloning AndaCodeCommitrepositori.

   ~$ git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/my-app

2. Periksa dan dorong cabang untuk digunakan lingkungan Elastic Beanstalk Anda.

   ~/my-app$ git checkout -b dev-env
   ~/my-app$ git push --set-upstream origin dev-env

3. Jalankan eb init. Pilih wilayah, repositori, dan nama cabang yang sama yang saat ini Anda gunakan.

   ~/my-app$ 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): 1
   ...
   Note: Elastic Beanstalk now supports AWS CodeCommit; a fully-managed source control service. To learn more, see Docs: https://aws.amazon.com/codecommit/
   Do you wish to continue with CodeCommit? (y/n)(default is n): y
   
   Select a repository
   1) my-app
   2) [ Create new Repository ]
   (default is 1): 1
   
   Select a branch
   1) mainline
   2) dev-env
   3) [ Create new Branch with local HEAD ]
   (default is 2): 2

Untuk informasi selengkapnya tentang penggunaan eb init, lihat Mengonfigurasi EB CLI.