Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tutorial: Gunakan variabel tingkat pipa
Dalam tutorial ini, Anda akan membuat pipeline di mana Anda menambahkan variabel pada tingkat pipeline dan menjalankan tindakan CodeBuild build yang mengeluarkan nilai variabel Anda.
**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.
**Topics**
+ [Prasyarat](#tutorials-pipeline-variables-prereq)
+ [Langkah 1: Buat pipeline Anda dan bangun proyek](#tutorials-pipeline-variables-pipeline)
+ [Langkah 2: Lepaskan perubahan dan lihat log](#tutorials-pipeline-variables-view)
## Prasyarat
Sebelum Anda mulai, Anda harus melakukan hal berikut:
+ Buat CodeCommit repositori.
+ Tambahkan file.txt ke repositori.
## Langkah 1: Buat pipeline Anda dan bangun proyek
Dalam bagian ini, Anda membuat alur dengan tindakan berikut:
+ Tahap sumber dengan koneksi ke CodeCommit repositori Anda.
+ Tahap build dengan aksi AWS CodeBuild build.
**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**MyVariablesPipeline**.
1. Dalam **tipe Pipeline**, pertahankan pilihan default di **V2**. Jenis pipa berbeda dalam karakteristik dan harga. Untuk informasi selengkapnya, lihat [Jenis pipa](pipeline-types.md).
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 **Variabel**, pilih **Tambahkan variabel**. Di **Nama**, masukkan `timeout`. Di **Default**, masukkan 1000. Dalam deskripsi, masukkan deskripsi berikut:**Timeout**.
Ini akan membuat variabel di mana Anda dapat mendeklarasikan nilai ketika eksekusi pipeline dimulai. Nama variabel harus cocok `[A-Za-z0-9@\-_]+` dan bisa apa saja kecuali string kosong.
1. Di bawah **Pengaturan lanjutan**, biarkan default. Di **Penyimpanan artifact**, pilih **Lokasi default** untuk menggunakan penyimpanan artifact default, seperti bucket artifact Amazon S3 yang ditetapkan sebagai default, untuk alur Anda di Wilayah yang Anda pilih untuk alur Anda.
**catatan**
Ini bukan bucket sumber untuk kode sumber Anda. Ini adalah penyimpanan artifact untuk alur Anda. Penyimpanan artifact terpisah, seperti bucket S3, diperlukan untuk setiap alur.
Pilih **Berikutnya**.
1. Pada **Langkah 3: Tambahkan halaman tahap sumber**, tambahkan tahap sumber:
1. Di **penyedia Sumber**, pilih **AWS CodeCommit**.
1. Dalam nama **Repositori dan nama** **Cabang**, pilih repositori dan cabang Anda.
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**. Dalam buildspec, variabel pelanggan `$CUSTOM_VAR1` akan digunakan untuk menampilkan variabel pipeline di log build. Anda akan membuat variabel `$CUSTOM_VAR1` output sebagai variabel lingkungan pada langkah berikut.
```
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:
- echo $CUSTOM_VAR1
#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. Di bawah **variabel Lingkungan *- opsional***, untuk membuat variabel lingkungan sebagai variabel input untuk tindakan build yang akan diselesaikan oleh variabel tingkat pipa, pilih **Tambahkan** variabel lingkungan. Ini akan membuat variabel yang ditentukan dalam buildspec sebagai. `$CUSTOM_VAR1` Di **Nama**, masukkan `CUSTOM_VAR1`. Dalam **Value** (Nilai), masukkan `#{variables.timeout}`. Di **Type**, pilih`Plaintext`.
`#{variables.timeout}`Nilai untuk variabel lingkungan didasarkan pada namespace variabel tingkat pipa `variables` dan variabel tingkat pipa yang dibuat untuk pipeline pada langkah 7. `timeout`
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: Lepaskan perubahan dan lihat log
1. Setelah pipeline berjalan dengan sukses, pada tahap build yang berhasil, pilih **Lihat detail**.
Pada halaman detail, pilih tab **Log**. Lihat output CodeBuild build. Perintah menampilkan nilai variabel yang dimasukkan.
1. **Di navigasi sebelah kiri, pilih History.**
Pilih eksekusi terbaru, lalu pilih tab **Variabel**. Lihat nilai yang diselesaikan untuk variabel pipeline.