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

# Jalankan build secara lokal dengan agen AWS CodeBuild
<a name="use-codebuild-agent"></a>

Anda dapat menggunakan AWS CodeBuild agen untuk menjalankan CodeBuild build di mesin lokal. Ada agen yang tersedia untuk platform x86\$164 dan ARM.

Anda juga dapat berlangganan untuk menerima pemberitahuan ketika versi baru agen diterbitkan. 

## Prasyarat
<a name="use-codebuild-agent.prerequisites"></a>

Sebelum Anda mulai, Anda perlu melakukan hal berikut:
+ Instal Git di mesin lokal Anda.
+ Instal dan atur [Docker](https://www.docker.com/) di mesin lokal Anda.

## Siapkan image build
<a name="use-codebuild-agent.setup-image"></a>

Anda hanya perlu menyiapkan image build saat pertama kali menjalankan agen, atau saat gambar telah berubah.

**Untuk mengatur image build**

1. [Jika Anda ingin menggunakan image Amazon Linux 2 yang dikurasi, Anda dapat menariknya dari repositori Amazon ECR CodeBuild publik di https://gallery.ecr. aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) dengan perintah berikut:

   ```
   $ docker pull public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0
   ```

   Atau, jika Anda ingin menggunakan image Linux lain, lakukan langkah-langkah berikut:

   1. Kloning repo CodeBuild gambar:

      ```
      $ git clone https://github.com/aws/aws-codebuild-docker-images.git
      ```

   1. Ubah ke direktori gambar. Untuk contoh ini, gunakan `aws/codebuild/standard:5.0` gambar:

      ```
      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0
      ```

   1. Bangun gambar. Ini akan memakan waktu beberapa menit. 

      ```
      $ docker build -t aws/codebuild/standard:5.0 .
      ```

1. Unduh CodeBuild agennya.

   Untuk mengunduh agen versi x86\$164, jalankan perintah berikut:

   ```
   $ docker pull public.ecr.aws/codebuild/local-builds:latest
   ```

   Untuk mengunduh versi ARM agen, jalankan perintah berikut:

   ```
   $ docker pull public.ecr.aws/codebuild/local-builds:aarch64
   ```

1. <a name="codebuild-agent-sha"></a> CodeBuild Agen tersedia dari [https://gallery.ecr. aws/codebuild/local-membangun](https://gallery.ecr.aws/codebuild/local-builds). 

   Tanda tangan Secure Hash Algorithm (SHA) untuk agen versi x86\$164 adalah:

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

   Tanda tangan SHA untuk versi ARM agen adalah:

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

   Anda dapat menggunakan SHA untuk mengidentifikasi versi agen. Untuk melihat tanda tangan SHA agen, jalankan perintah berikut dan cari SHA di bawah`RepoDigests`: 

   ```
   $ docker inspect public.ecr.aws/codebuild/local-builds:latest
   ```

## Jalankan CodeBuild agen
<a name="use-codebuild-agent.run-agent"></a>

**Untuk menjalankan CodeBuild agen**

1. Ubah ke direktori yang berisi sumber proyek build Anda.

1. Unduh skrip [codebuild\$1build.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/codebuild_build.sh):

   ```
   $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
   $ chmod +x codebuild_build.sh
   ```

1. Jalankan `codebuild_build.sh` skrip dan tentukan gambar kontainer Anda dan direktori output.

   Untuk menjalankan build x86\$164, jalankan perintah berikut:

   ```
   $ ./codebuild_build.sh -i <container-image> -a <output directory>
   ```

   Untuk menjalankan ARM build, jalankan perintah berikut:

   ```
   $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64
   ```

   Ganti *<container-image>* dengan nama gambar kontainer, seperti `aws/codebuild/standard:5.0` atau`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`.

   Skrip meluncurkan image build dan menjalankan build pada proyek di direktori saat ini. Untuk menentukan lokasi proyek build, tambahkan `-s <build project directory>` opsi ke perintah skrip.

## Menerima pemberitahuan untuk versi CodeBuild agen baru
<a name="receive-codebuild-agent-notifications"></a>

Anda dapat berlangganan notifikasi Amazon SNS sehingga Anda akan diberi tahu saat versi baru AWS CodeBuild agen dirilis. 

**Untuk berlangganan pemberitahuan CodeBuild agen**

1. [Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. Di bilah navigasi, jika belum dipilih, ubah AWS Region ke **US East (Virginia N.)**. Anda harus memilih AWS Wilayah ini karena notifikasi Amazon SNS yang Anda berlangganan dibuat di Wilayah ini. 

1. Di panel navigasi, pilih **Langganan**. 

1. Pilih **Buat langganan**. 

1. Di **Buat langganan**, lakukan hal berikut: 

   1. Untuk **ARN Topik**, salin Amazon Resource Name (ARN) berikut: 

      ```
      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates
      ```

   1. Untuk **Protokol**, pilih **Email** atau **SMS**. 

   1. Untuk **Endpoint**, pilih tempat (email atau SMS) untuk menerima notifikasi. Masukkan email atau alamat atau nomor telepon, termasuk kode area. 

   1. Pilih **Buat langganan**. 

   1. Pilih **Email** untuk menerima email yang meminta Anda mengonfirmasi langganan Anda. Ikuti petunjuk di email untuk menyelesaikan langganan Anda. 

      Jika Anda tidak ingin lagi menerima notifikasi ini, gunakan prosedur berikut untuk berhenti berlangganan. 

**Untuk berhenti berlangganan pemberitahuan CodeBuild agen**

1. [Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home) 

1. Di panel navigasi, pilih **Langganan**. 

1. Pilih langganan dan dari **Tindakan**, pilih **Hapus langganan**. Ketika diminta untuk mengonfirmasi, pilih **Hapus**.