Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tutorial: Buat aturan pemeriksaan variabel untuk pipeline sebagai kondisi entri
Dalam tutorial ini, Anda mengonfigurasi pipeline yang terus-menerus mengirimkan file menggunakan GitHub sebagai penyedia tindakan sumber di tahap sumber Anda. Pipeline yang telah selesai mendeteksi perubahan saat Anda membuat perubahan pada file sumber di repositori sumber Anda. Pipeline berjalan dan kemudian memeriksa variabel output terhadap nama repositori sumber dan nama cabang yang disediakan dalam kondisi untuk masuk ke tahap build.
**penting**
Sebagai bagian dari pembuatan pipa, ember artefak S3 yang disediakan oleh pelanggan akan digunakan CodePipeline untuk artefak. (Ini berbeda dari bucket yang digunakan untuk aksi sumber S3.) Jika bucket artefak S3 berada di akun yang berbeda dari akun untuk pipeline Anda, pastikan bucket artefak S3 dimiliki oleh Akun AWS yang aman dan dapat diandalkan.
**penting**
Banyak tindakan yang Anda tambahkan ke pipeline dalam prosedur ini melibatkan AWS sumber daya yang perlu Anda buat sebelum membuat pipeline. AWS sumber daya untuk tindakan sumber Anda harus selalu dibuat di AWS Wilayah yang sama tempat Anda membuat pipeline. Misalnya, jika Anda membuat pipeline di Wilayah AS Timur (Ohio), CodeCommit repositori Anda harus berada di Wilayah AS Timur (Ohio).
Anda dapat menambahkan tindakan lintas wilayah saat membuat pipeline. AWS sumber daya untuk tindakan lintas wilayah harus berada di AWS Wilayah yang sama di mana Anda berencana untuk menjalankan tindakan. Untuk informasi selengkapnya, lihat [Menambahkan tindakan Lintas wilayah di CodePipeline](actions-create-cross-region.md).
Contoh ini menggunakan pipeline contoh dengan aksi sumber GitHub (Version2) dan aksi CodeBuild build di mana kondisi entri untuk tahap build akan memeriksa variabel.
## Prasyarat
Sebelum Anda mulai, Anda harus melakukan hal berikut:
+ Buat GitHub repositori dengan akun Anda GitHub .
+ Siapkan GitHub kredensialmu. Ketika Anda menggunakan Konsol Manajemen AWS untuk mengatur koneksi, Anda diminta untuk masuk dengan GitHub kredensi Anda.
+ Koneksi ke repositori Anda untuk disiapkan GitHub (melalui GitHub Aplikasi) sebagai tindakan sumber untuk pipeline Anda. Untuk membuat koneksi ke GitHub repositori Anda, lihat. [GitHub koneksi](connections-github.md)
## Langkah 1: Buat file sumber sampel dan tambahkan ke GitHub repositori Anda
Di bagian ini, Anda membuat dan menambahkan file sumber contoh Anda ke repositori yang digunakan pipeline untuk tahap sumber Anda. Untuk contoh ini, Anda menghasilkan dan menambahkan yang berikut:
+ File `README.md`.
Setelah Anda membuat GitHub repositori Anda, gunakan langkah-langkah ini untuk menambahkan file README Anda.
1. Masuk ke repositori Anda dan pilih GitHub repositori Anda.
1. Untuk membuat file baru, pilih **Tambah file**, lalu pilih **Buat file baru**. Beri nama file `README.md` dan tambahkan teks berikut.
```
This is a GitHub repository!
```
1. Pilih **Perubahan commit**. Untuk keperluan tutorial ini, tambahkan pesan komit yang berisi kata huruf besar “Update” seperti pada contoh berikut:
```
Update to source files
```
**catatan**
Pemeriksaan aturan untuk string peka huruf besar/kecil.
Pastikan file `README.md` berada di tingkat root repositori Anda..
## Langkah 2: Buat alur Anda
Dalam bagian ini, Anda membuat alur dengan tindakan berikut:
+ Tahap sumber dengan koneksi ke GitHub repositori dan tindakan Anda.
+ Tahap CodeBuild build di mana stage memiliki kondisi On Entry yang dikonfigurasi untuk aturan pemeriksaan variabel.
**Untuk membuat alur dengan wizard**
1. Masuk ke CodePipeline konsol di [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
1. Pada halaman **Selamat Datang**, halaman **Memulai**, atau halaman **Alur**, pilih **Buat alur**.
1. Pada **Langkah 1: Pilih halaman opsi pembuatan**, di bawah **Opsi pembuatan**, pilih opsi **Build custom pipeline**. Pilih **Berikutnya**.
1. Pada **Langkah 2: Pilih pengaturan pipeline**, dalam **nama Pipeline**, masukkan**MyVarCheckPipeline**.
1. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat [jenis pipa](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Untuk informasi tentang harga CodePipeline, lihat [Harga](https://aws.amazon.com/codepipeline/pricing/).
1. Di **Peran layanan**, pilih **Peran layanan baru**.
**catatan**
Jika Anda memilih untuk menggunakan peran CodePipeline layanan yang ada, pastikan Anda telah menambahkan izin `codeconnections:UseConnection` IAM ke kebijakan peran layanan Anda. Untuk petunjuk tentang peran CodePipeline layanan, lihat [Menambahkan izin ke peran CodePipeline layanan](https://docs.aws.amazon.com/codepipeline/latest/userguide/security-iam.html#how-to-update-role-new-services).
1. Di bawah **Pengaturan lanjutan**, biarkan default.
Pilih **Berikutnya**.
1. Pada **Langkah 3: Tambahkan halaman tahap sumber**, tambahkan tahap sumber:
1. Di **penyedia Sumber**, pilih **GitHub(melalui GitHub Aplikasi)**.
1. Di bawah **Koneksi**, pilih koneksi yang ada atau buat yang baru. Untuk membuat atau mengelola koneksi untuk tindakan GitHub sumber Anda, lihat[GitHub koneksi](connections-github.md).
1. Dalam nama **Repositori, pilih nama** repositori Anda GitHub .
1. Dalam **nama Branch**, pilih cabang repositori yang ingin Anda gunakan.
1. Pastikan opsi **Tidak ada pemicu** dipilih.
Pilih **Berikutnya**.
1. Pada **Langkah 4: Tambahkan tahap build**, tambahkan tahap build:
1. Di **Penyedia pembangunan**, pilih **AWS CodeBuild**. Izinkan **Wilayah** ke default ke Wilayah alur.
1. Pilih **Buat proyek**.
1. Di **Nama proyek**, masukkan nama untuk proyek pembangunan ini.
1. Di **Citra lingkungan**, pilih **Citra terkelola**. Untuk **Sistem operasi**, pilih **Ubuntu**.
1. Untuk **Waktu aktif**, pilih **Standar**. **Untuk **Gambar**, pilih:5.0aws/codebuild/standard.**
1. Untuk **Peran layanan**, pilih **Peran layanan baru**.
**catatan**
Perhatikan nama peran CodeBuild layanan Anda. Anda akan membutuhkan nama peran untuk langkah terakhir dalam tutorial ini.
1. Pada **Buildspec**, untuk **Spesifikasi membangun**, pilih **Sisipkan perintah membangun**. Pilih **Beralih ke editor**, dan tempel yang berikut ini di bawah **perintah Build**.
```
version: 0.2
#env:
#variables:
# key: "value"
# key: "value"
#parameter-store:
# key: "value"
# key: "value"
#git-credential-helper: yes
phases:
install:
#If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
#If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
runtime-versions:
nodejs: 12
#commands:
# - command
# - command
#pre_build:
#commands:
# - command
# - command
build:
commands:
-
#post_build:
#commands:
# - command
# - command
artifacts:
files:
- '*'
# - location
name: $(date +%Y-%m-%d)
#discard-paths: yes
#base-directory: location
#cache:
#paths:
# - paths
```
1. Pilih **Lanjutkan ke CodePipeline**. Ini kembali ke CodePipeline konsol dan membuat CodeBuild proyek yang menggunakan perintah build Anda untuk konfigurasi. Proyek build menggunakan peran layanan untuk mengelola Layanan AWS izin. Langkah ini mungkin memakan waktu beberapa menit.
1. Pilih **Berikutnya**.
1. Pada **Langkah 5: Tambahkan tahap pengujian**, pilih **Lewati tahap pengujian**, lalu terima pesan peringatan dengan memilih **Lewati** lagi.
Pilih **Berikutnya**.
1. Pada **Langkah 6: Tambahkan halaman tahap penerapan**, pilih **Lewati tahap penerapan**, lalu terima pesan peringatan dengan memilih **Lewati** lagi. Pilih **Berikutnya**.
1. Pada **Langkah 7: Tinjau**, pilih **Buat pipeline**.
## Langkah 2: Edit tahap build untuk menambahkan kondisi dan aturan
Pada langkah ini, Anda mengedit tahap untuk menambahkan kondisi On Entry untuk aturan pemeriksaan variabel.
1. Pilih pipeline Anda, lalu pilih **Edit**. Pilih untuk menambahkan aturan entri pada tahap build.
Di **Penyedia aturan**, pilih **VariableCheck**.
1. Di **Variable**, masukkan variabel atau variabel yang ingin Anda periksa. Di **Nilai**, masukkan nilai string untuk memeriksa variabel yang diselesaikan. Di layar contoh berikut, aturan dibuat untuk pemeriksaan “sama dengan”, dan aturan lain dibuat untuk pemeriksaan “berisi”.
![\[Halaman pembuatan aturan untuk pemeriksaan variabel “sama”\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/varcheck-tut-create-rule-equals.png)
![\[Halaman pembuatan aturan untuk pemeriksaan variabel “berisi”\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/varcheck-tut-create-rule-contains.png)
1. Pilih **Simpan**.
Pilih **Selesai**.
## Langkah 3: Jalankan pipeline dan lihat variabel yang diselesaikan
Pada langkah ini, Anda melihat nilai dan hasil yang diselesaikan dari aturan pemeriksaan variabel.
1. Lihat proses yang diselesaikan setelah pemeriksaan aturan berhasil seperti yang ditunjukkan pada contoh berikut.
![\[Lari yang sukses\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/varcheck-tut-run-succeeded.png)
1. Lihat informasi variabel pada tab **Timeline**.
![\[Halaman riwayat yang menampilkan tab Timline dengan variabel berhasil\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/varcheck-tut-history.png)