Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Jalankan sampel 'Bitbucket pull request dan webhook filter' untuk CodeBuild
AWS CodeBuild mendukung webhooks ketika repositori sumber adalah Bitbucket. Ini berarti bahwa untuk proyek CodeBuild build yang memiliki kode sumbernya disimpan dalam repositori Bitbucket, webhook dapat digunakan untuk membangun kembali kode sumber setiap kali perubahan kode didorong ke repositori. Untuk informasi selengkapnya, lihat [Acara webhook Bitbucket](bitbucket-webhook.md).
Contoh ini menunjukkan cara membuat permintaan tarik menggunakan repositori Bitbucket. Ini juga menunjukkan kepada Anda cara menggunakan webhook Bitbucket CodeBuild untuk memicu pembuatan proyek.
**catatan**
Saat menggunakan webhook, pengguna dapat memicu build yang tidak terduga. Untuk mengurangi risiko ini, lihat. [Praktik terbaik untuk menggunakan webhooks](webhooks.md#webhook-best-practices)
**Topics**
+ [Prasyarat](#sample-bitbucket-pull-request-prerequisites)
+ [Langkah 1: Buat proyek build dengan Bitbucket dan aktifkan webhooks](#sample-bitbucket-pull-request-create)
+ [Langkah 2: Memicu build dengan webhook Bitbucket](#sample-bitbucket-pull-request-trigger)
## Prasyarat
Untuk menjalankan sampel ini, Anda harus menghubungkan AWS CodeBuild proyek Anda dengan akun Bitbucket Anda.
**catatan**
CodeBuild telah memperbarui izinnya dengan Bitbucket. Jika sebelumnya Anda menghubungkan proyek Anda ke Bitbucket dan sekarang menerima kesalahan koneksi Bitbucket, Anda harus menyambung kembali untuk memberikan CodeBuild izin untuk mengelola webhook Anda.
## Langkah 1: Buat proyek build dengan Bitbucket dan aktifkan webhooks
Langkah-langkah berikut menjelaskan cara membuat AWS CodeBuild proyek dengan Bitbucket sebagai repositori sumber dan mengaktifkan webhooks.
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. Pilih **Buat proyek build**.
1. Dalam **konfigurasi Proyek**:
**Nama proyek**
Masukkan nama untuk proyek build 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. Dalam **Sumber**:
**Penyedia sumber**
Pilih **Bitbucket**. **Ikuti petunjuk untuk menghubungkan (atau menyambung kembali) dengan Bitbucket dan kemudian pilih Otorisasi.**
**Repositori**
Pilih **Repositori di akun Bitbucket saya**.
Jika sebelumnya Anda belum terhubung ke akun Bitbucket Anda, masukkan nama pengguna dan kata sandi aplikasi Bitbucket Anda, lalu pilih **Simpan kredensi Bitbucket**.
**Repositori Bitbucket**
Masukkan URL untuk repositori Bitbucket Anda.
1. Di **Acara webhook sumber utama**, pilih yang berikut ini.
**catatan**
Bagian **peristiwa webhook sumber utama** hanya terlihat jika Anda memilih **Repositori di akun Bitbucket saya di** langkah sebelumnya.
1. Pilih **Bangun ulang setiap kali perubahan kode didorong ke repositori ini** saat Anda membuat proyek Anda.
1. Dari **jenis Acara**, pilih satu atau beberapa acara.
1. Untuk memfilter saat peristiwa memicu build, di bawah **Memulai build dalam kondisi ini**, tambahkan satu atau beberapa filter opsional.
1. Untuk memfilter saat peristiwa tidak dipicu, di bawah **Jangan memulai build dalam kondisi ini**, tambahkan satu atau beberapa filter opsional.
1. Pilih **Tambahkan grup filter** untuk menambahkan grup filter lain, jika diperlukan.
Untuk informasi selengkapnya tentang jenis dan filter acara webhook Bitbucket, lihat. [Acara webhook Bitbucket](bitbucket-webhook.md)
1. Di **Lingkungan**:
**Citra lingkungan**
Pilih salah satu cara berikut:
Untuk menggunakan image Docker yang dikelola oleh AWS CodeBuild:
Pilih **Gambar terkelola**, lalu buat pilihan dari **Sistem operasi**, **Runtime**, **Gambar**, dan versi **Gambar**. Buat pilihan dari **jenis Lingkungan** jika tersedia.
Untuk menggunakan gambar Docker lain:
Pilih **gambar Kustom**. 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 **gambar Kustom**. 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/) dalam *AWS Secrets Manager User Guide*.
**Peran layanan**
Pilih salah satu cara 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.
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. Dalam **Artefak**:
**Jenis**
Pilih salah satu cara 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).
**Konfigurasi tambahan**
Perluas **Konfigurasi tambahan** dan atur opsi yang sesuai.
1. Pilih **Buat proyek build**. Pada halaman **Review**, pilih **Start build** untuk menjalankan build.
## Langkah 2: Memicu build dengan webhook Bitbucket
Untuk proyek yang menggunakan webhook Bitbucket, AWS CodeBuild buat build saat repositori Bitbucket mendeteksi perubahan dalam kode sumber Anda.
1. Buka AWS CodeBuild konsol di [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Pada panel navigasi, pilih **Build projects**, lalu pilih project yang terkait dengan repositori Bitbucket dengan webhook. Untuk informasi tentang membuat proyek webhook Bitbucket, lihat. [Langkah 1: Buat proyek build dengan Bitbucket dan aktifkan webhooks](#sample-bitbucket-pull-request-create)
1. Buat beberapa perubahan dalam kode di repositori Bitbucket proyek Anda.
1. Buat permintaan tarik pada repositori Bitbucket Anda. Untuk informasi selengkapnya, lihat [Membuat permintaan tarik](https://www.atlassian.com/git/tutorials/making-a-pull-request).
1. Pada halaman webhooks Bitbucket, pilih **Lihat permintaan** untuk melihat daftar peristiwa terbaru.
1. Pilih **Lihat detail** untuk melihat detail tentang respons yang dikembalikan oleh CodeBuild. Mungkin terlihat seperti ini:
```
"response":"Webhook received and build started: https://us-east-1.console.aws.amazon.com/codebuild/home..."
"statusCode":200
```
1. Arahkan ke halaman permintaan tarik Bitbucket untuk melihat status build.