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

# Buat sampel lencana dengan CodeBuild
<a name="sample-build-badges"></a>

AWS CodeBuild sekarang mendukung penggunaan lencana build, yang menyediakan gambar (*lencana*) yang dapat disematkan dan dihasilkan secara dinamis yang menampilkan status build terbaru untuk sebuah proyek. Gambar ini dapat diakses melalui URL yang tersedia untuk umum yang dihasilkan untuk CodeBuild proyek Anda. Ini memungkinkan siapa saja untuk melihat status CodeBuild proyek. Build badge tidak mengandung informasi keamanan apa pun, sehingga tidak memerlukan otentikasi.

**Topics**
+ [Buat proyek build dengan lencana build](#sample-build-badges-request-running)
+ [Akses lencana AWS CodeBuild build](access-badges.md)
+ [Publikasikan lencana CodeBuild build](publish-badges.md)
+ [CodeBuild status lencana](badge-statuses.md)

## Buat proyek build dengan lencana build
<a name="sample-build-badges-request-running"></a>

Gunakan salah satu prosedur berikut ini untuk membuat proyek build dengan lencana build diaktifkan. Anda dapat menggunakan AWS CLI atau Konsol Manajemen AWS.

**Untuk membuat proyek build dengan badge build enabled ()AWS CLI**
+ Untuk informasi tentang membuat proyek build, lihat[Buat proyek build (AWS CLI)](create-project.md#create-project-cli). Untuk menyertakan lencana build dengan AWS CodeBuild proyek Anda, Anda harus menentukan *badgeEnabled* dengan nilai. `true`

**Untuk membuat proyek build dengan lencana build diaktifkan (konsol)**

1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Jika halaman CodeBuild informasi ditampilkan, pilih **Buat proyek build**. Jika tidak, pada panel navigasi, perluas **Build**, pilih **Build projects**, lalu pilih **Create build project**. 

1. Di **Nama proyek**, masukkan nama untuk proyek pembangunan ini. Membangun nama proyek harus unik di setiap AWS akun. Anda juga dapat menyertakan deskripsi opsional proyek build untuk membantu pengguna lain memahami tujuan proyek ini.

1. Di **Sumber**, untuk **penyedia Sumber**, pilih jenis penyedia kode sumber, lalu lakukan salah satu hal berikut:
**catatan**  
 CodeBuild tidak mendukung lencana build dengan penyedia sumber Amazon S3. Karena AWS CodePipeline menggunakan Amazon S3 untuk transfer artefak, lencana build tidak didukung untuk proyek build yang merupakan bagian dari pipeline yang dibuat. CodePipeline 
   + Jika Anda memilih **CodeCommit**, maka untuk **Repositori**, pilih nama repositori. Pilih **Aktifkan lencana build** untuk membuat status build project Anda terlihat dan dapat disematkan.
   + Jika Anda memilih **GitHub**, ikuti petunjuk untuk menghubungkan (atau menyambung kembali) dengan GitHub. Pada halaman GitHub **Otorisasi aplikasi**, untuk **akses Organisasi**, pilih **Minta akses** di sebelah setiap repositori yang AWS CodeBuild ingin Anda akses. Setelah Anda memilih **Otorisasi aplikasi**, kembali ke AWS CodeBuild konsol, untuk **Repositori**, pilih nama repositori yang berisi kode sumber. Pilih **Aktifkan lencana build** untuk membuat status build project Anda terlihat dan dapat disematkan.
   + Jika Anda memilih **Bitbucket**, ikuti petunjuk untuk menghubungkan (atau menyambung kembali) dengan Bitbucket. Pada Bitbucket **Konfirmasi akses ke halaman akun Anda**, untuk **akses Organisasi**, pilih **Berikan akses**. Setelah Anda memilih **Grant access**, kembali ke AWS CodeBuild konsol, untuk **Repository**, pilih nama repositori yang berisi kode sumber. Pilih **Aktifkan lencana build** untuk membuat status build project Anda terlihat dan dapat disematkan.
**penting**  
Memperbarui sumber proyek Anda dapat memengaruhi keakuratan lencana pembuatan proyek.

1. Di **Lingkungan**:

   Untuk **citra Lingkungan**, lakukan salah satu hal berikut:
   + **Untuk menggunakan image Docker yang dikelola oleh AWS CodeBuild, pilih **Managed image**, lalu buat pilihan dari **Sistem operasi**, **Runtime, **Image, dan versi Image****.** Buat pilihan dari **jenis Lingkungan** jika tersedia.
   + Untuk menggunakan gambar Docker lain, pilih **Custom image**. Untuk **jenis Lingkungan**, pilih **ARM**, **Linux**, **GPU Linux**, atau **Windows**. Jika Anda memilih **Registri lain**, untuk **URL registri eksternal**, masukkan nama dan tag gambar Docker di Docker Hub, menggunakan format. `docker repository/docker image name` Jika Anda memilih **Amazon ECR**, gunakan **repositori Amazon ECR** dan gambar **Amazon ECR** untuk memilih gambar Docker di akun Anda. AWS 
   + Untuk menggunakan image Docker pribadi, pilih **Custom image**. Untuk **jenis Lingkungan**, pilih **ARM**, **Linux**, **GPU Linux**, atau **Windows**. Untuk **registri Gambar**, pilih **Registri lain**, lalu masukkan ARN kredensi untuk gambar Docker pribadi Anda. Kredensialnya harus dibuat oleh Secrets Manager. Untuk informasi lebih lanjut, lihat [Apa itu AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/) di *Panduan Pengguna AWS Secrets Manager *.

1. Dalam **peran Layanan**, lakukan salah satu hal berikut:
   + Jika Anda tidak memiliki peran CodeBuild layanan, pilih **Peran layanan baru**. Di **Nama peran**, masukkan nama untuk peran baru.
   + Jika Anda memiliki peran CodeBuild layanan, pilih **Peran layanan yang ada**. Di **Peran ARN**, pilih peran layanan.
**catatan**  
Saat menggunakan konsol untuk membuat atau memperbarui proyek build, Anda dapat membuat peran CodeBuild layanan secara bersamaan. Secara default, peran hanya berfungsi dengan proyek build tersebut. Jika Anda menggunakan konsol untuk mengaitkan peran layanan ini dengan proyek build lain, peran akan diperbarui agar berfungsi dengan proyek build lainnya. Peran layanan dapat bekerja dengan hingga 10 proyek pembangunan.

1. Di **Buildspec**, lakukan salah satu hal berikut:
   + Pilih **Gunakan file buildspec untuk menggunakan file** buildspec.ymldi direktori root kode sumber.
   + Pilih **Sisipkan perintah build** untuk menggunakan konsol untuk menyisipkan perintah build.

   Untuk informasi selengkapnya, lihat [Referensi Buildspec](build-spec-ref.md).

1. Di **Artefak**, untuk **Jenis**, lakukan salah satu hal berikut:
   + Jika Anda tidak ingin membuat artefak keluaran build, pilih **Tidak ada artefak**.
   + Untuk menyimpan output build dalam bucket S3, pilih **Amazon** S3, lalu lakukan hal berikut:
     + Jika Anda ingin menggunakan nama proyek Anda untuk file atau folder ZIP keluaran build, biarkan **Nama** kosong. Jika tidak, masukkan nama. Secara default, nama artefak adalah nama proyek. Jika Anda ingin menggunakan nama yang berbeda, masukkan di kotak nama artefak. Jika Anda ingin mengeluarkan file ZIP, sertakan ekstensi zip.
     + Untuk **nama Bucket**, pilih nama bucket keluaran.
     + Jika Anda memilih **Sisipkan perintah build** sebelumnya dalam prosedur ini, untuk **file Output**, masukkan lokasi file dari build yang ingin Anda masukkan ke dalam file atau folder ZIP keluaran build. Untuk beberapa lokasi, pisahkan setiap lokasi dengan koma (misalnya,`appspec.yml, target/my-app.jar`). Untuk informasi lebih lanjut, lihat deskripsi `files` di[Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax).

1. Perluas **Konfigurasi tambahan** dan pilih opsi yang sesuai.

1. Pilih **Buat proyek build**. Pada halaman **Review**, pilih **Start build** untuk menjalankan build.

# Akses lencana AWS CodeBuild build
<a name="access-badges"></a>

Anda dapat menggunakan AWS CodeBuild konsol atau AWS CLI untuk mengakses lencana build.
+ Di CodeBuild konsol, dalam daftar proyek build, di kolom **Name**, pilih tautan yang sesuai dengan proyek build. Pada *project-name* halaman **Build project:**, di **Configuration**, pilih **Salin URL lencana**. Untuk informasi selengkapnya, lihat [Melihat detail proyek build (konsol)](view-project-details.md#view-project-details-console).
+ Di AWS CLI, jalankan `batch-get-projects` perintah. URL lencana build disertakan dalam bagian detail lingkungan proyek pada output. Untuk informasi selengkapnya, lihat [Lihat detail proyek build (AWS CLI)](view-project-details.md#view-project-details-cli).

URL permintaan lencana build dibuat dengan cabang default umum, tetapi Anda dapat menentukan cabang apa pun di repositori sumber yang telah Anda gunakan untuk menjalankan build. Contoh:

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&branch=<branch>
```

Anda juga dapat menentukan tag dari repositori sumber Anda dengan mengganti `branch` parameter dengan `tag` parameter di URL lencana. Contoh: 

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&tag=<tag>
```

# Publikasikan lencana CodeBuild build
<a name="publish-badges"></a>

Anda dapat menampilkan status build terbaru dalam file penurunan harga menggunakan URL lencana build Anda dalam gambar penurunan harga. Ini berguna untuk menampilkan status build terbaru di file readme.md di repositori sumber Anda (misalnya, atau). GitHub CodeCommit Contoh:

```
![](<build badge URL>)
```

# CodeBuild status lencana
<a name="badge-statuses"></a>

Lencana CodeBuild build dapat memiliki salah satu status berikut.
+ **PASSING** Build terbaru di cabang yang diberikan lulus. 
+ **GAGAL** Build terbaru di cabang tertentu kehabisan waktu, gagal, salah, atau dihentikan.
+ **IN\$1PROGRESS** Build terbaru di cabang yang diberikan sedang berlangsung.
+ **TIDAK DIKETAHUI** Proyek belum menjalankan build untuk cabang yang diberikan atau sama sekali. Selain itu, fitur lencana build mungkin telah dinonaktifkan.