Halaman ini diterjemahkan oleh Cloud Translation API.

Men-deploy alur kerja dari repositori Git menggunakan Cloud Build

Anda dapat menggunakan pemicu Cloud Build untuk otomatis memulai build dan men-deploy alur kerja dari repositori Git. Anda dapat mengonfigurasi pemicu untuk men-deploy alur kerja berdasarkan setiap perubahan pada repositori sumber, atau men-deploy alur kerja hanya jika perubahan tersebut cocok dengan kriteria tertentu.

Pendekatan ini dapat membantu Anda mengelola siklus proses deployment. Misalnya, Anda dapat men-deploy perubahan pada alur kerja di lingkungan staging, menjalankan pengujian pada lingkungan tersebut, lalu meluncurkan perubahan ini secara bertahap ke lingkungan produksi.

Sebelum memulai

Petunjuk ini mengasumsikan bahwa Anda memiliki peran Cloud Build Editor (roles/cloudbuild.builds.editor) di project Google Cloud sehingga Anda dapat membuat pemicu. Anda juga memerlukan alur kerja di repositori sumber seperti GitHub atau Bitbucket.

Konsol

Aktifkan Cloud Build dan Workflows API.

Mengaktifkan API
Berikan peran Workflows Admin (roles/workflows.admin) ke akun layanan Cloud Build:
1. Di konsol Google Cloud, buka halaman IAM.
  
  Buka IAM
2. Pilih project Anda.
3. Di baris untuk akun layanan Cloud Build (PROJECT_NUMBER@cloudbuild.gserviceaccount.com), klik Edit principal.
4. Klik Add another role.
5. Dalam daftar Role, pilih peran Workflows Admin.
6. Klik Save.
Berikan peran Pengguna Akun Layanan (roles/iam.serviceAccountUser) di akun layanan default Compute Engine ke akun layanan Cloud Build. Setelah Anda mengaktifkan Compute Engine API, akun layanan default Compute Engine adalah PROJECT_NUMBER-compute@developer.gserviceaccount.com.

Perhatian: Menetapkan peran Service Account User secara tidak langsung memberikan peran yang terkait dengan akun layanan default kepada pengguna. Misalnya, jika akun layanan default memiliki peran Editor, pengguna dapat "bertindak sebagai" Editor. Untuk meminimalkan dampak penetapan peran ini, sebaiknya konfigurasikan akun layanan default sesuai dengan prinsip hak istimewa terendah. Untuk mengetahui informasi selengkapnya, lihat Menonaktifkan pemberian peran otomatis ke akun layanan default.
1. Di konsol Google Cloud, buka halaman Akun Layanan.
  
  Buka Akun Layanan
2. Pilih project Anda.
3. Klik alamat email akun layanan default Compute Engine (PROJECT_NUMBER-compute@developer.gserviceaccount.com).
4. Klik tab Izin.
5. Klik tombol Grant access.
6. Untuk menambahkan akun utama baru, masukkan alamat email akun layanan Anda (SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com).
7. Dalam daftar Select a role, pilih peran Service Accounts > Service Account User.
8. Klik Save.

gcloud

Aktifkan Cloud Build dan Workflows API.

gcloud services enable cloudbuild.googleapis.com \
  workflows.googleapis.com

Berikan peran Workflows Admin (roles/workflows.admin) ke akun layanan Cloud Build:

PROJECT_NUMBER=$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')
gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=serviceAccount:$PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
  --role=roles/workflows.admin

Ganti PROJECT_ID dengan ID project Google Cloud Anda.

Berikan peran Pengguna Akun Layanan (roles/iam.serviceAccountUser) di akun layanan default Compute Engine ke akun layanan Cloud Build. Setelah Anda mengaktifkan Compute Engine API, akun layanan default Compute Engine adalah PROJECT_NUMBER-compute@developer.gserviceaccount.com.

Perhatian: Menetapkan peran Service Account User secara tidak langsung memberikan peran yang terkait dengan akun layanan default kepada pengguna. Misalnya, jika akun layanan default memiliki peran Editor, pengguna dapat "bertindak sebagai" Editor. Untuk meminimalkan dampak penetapan peran ini, sebaiknya konfigurasikan akun layanan default sesuai dengan prinsip hak istimewa terendah. Untuk mengetahui informasi selengkapnya, lihat Menonaktifkan pemberian peran otomatis ke akun layanan default.
```
gcloud iam service-accounts add-iam-policy-binding \
  $PROJECT_NUMBER-compute@developer.gserviceaccount.com \
  --member=serviceAccount:$PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
  --role=roles/iam.serviceAccountUser
```

Menghubungkan ke repositori sumber

Anda harus menghubungkan Cloud Build ke repositori sumber agar Cloud Build dapat mengotomatiskan build sebagai respons terhadap peristiwa yang terjadi di repositori.

Selesaikan langkah-langkah berikut untuk terhubung ke GitHub atau Bitbucket:

Di konsol Google Cloud, buka halaman Pemicu Cloud Build:

Buka Pemicu
Jika perlu, pilih project Anda, lalu klik Buka.
Dari daftar Region, pilih region tempat Anda ingin membuat pemicu.

Catatan: Jika Anda memilih global sebagai region, kumpulan default akan digunakan untuk menjalankan build; jika tidak, kumpulan pribadi di region pemicu akan digunakan. Anda harus menentukan kumpulan pribadi dalam file konfigurasi build atau melalui argumen build.
Klik Connect repository.
Pilih repositori sumber tempat Anda menyimpan kode sumber.

Misalnya: GitHub (Cloud Build GitHub App)
Klik Lanjutkan.
Lakukan autentikasi ke repositori sumber dengan nama pengguna dan sandi Anda.

Jika Anda login ke GitHub, Anda akan diminta untuk memberi otorisasi ke Aplikasi GitHub Google Cloud Build agar dapat mengakses akun GitHub Anda untuk melanjutkan.
Dari daftar repositori yang tersedia, pilih repositori yang diinginkan, lalu klik OK.

Untuk repositori eksternal seperti GitHub dan Bitbucket, Anda harus memiliki izin tingkat pemilik untuk project Google Cloud tempat Anda bekerja.
Baca pernyataan penyangkalan dan pilih kotak centang di sampingnya untuk menunjukkan bahwa Anda menyetujui persyaratan.
Klik Connect.
Untuk melanjutkan pembuatan pemicu build guna mengotomatiskan build untuk kode sumber di repositori, klik Buat pemicu. Jika tidak, klik Selesai.

Membuat file konfigurasi Cloud Build

File konfigurasi build menentukan kolom yang diperlukan saat menggunakan pemicu build untuk memulai build. Buat file konfigurasi di direktori root project Anda dan tulis menggunakan YAML atau JSON.

Misalnya, file konfigurasi berikut men-deploy dan menjalankan alur kerja pengujian, lalu menggunakan skrip untuk memeriksa output. Jika pengujian lulus, alur kerja akan di-deploy:

steps:
# Deploy the test workflow with the commit sha
- id: 'deploy-test-workflow'
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['workflows', 'deploy', '$_WORKFLOW_NAME-$BRANCH_NAME-$SHORT_SHA', '--source', 'gitops/workflow.yaml']

# Run the test workflow and capture the output
- id: 'run-test-workflow'
  name: 'gcr.io/cloud-builders/gcloud'
  entrypoint: 'bash'
  args: ['-c', 'gcloud workflows run $_WORKFLOW_NAME-$BRANCH_NAME-$SHORT_SHA > /workspace/testoutput.log']

# Delete the test workflow
- id: 'delete-test-workflow'
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['workflows', 'delete', '$_WORKFLOW_NAME-$BRANCH_NAME-$SHORT_SHA', '--quiet']

# Check the test output
- id: 'check-test-workflow'
  name: 'gcr.io/cloud-builders/gcloud'
  entrypoint: 'bash'
  args: ['gitops/test-$BRANCH_NAME.sh']

# Deploy the workflow
- id: 'deploy-workflow'
  name: 'gcr.io/cloud-builders/gcloud'
  args: ['workflows', 'deploy', '$_WORKFLOW_NAME-$BRANCH_NAME', '--source', 'gitops/workflow.yaml']

Variabel penggantian $BRANCH_NAME dan $SHORT_SHA diisi oleh Cloud Build saat build dipicu dari repositori Git. Kedua nama tersebut masing-masing mewakili nama cabang dan tujuh karakter pertama ID commit yang terkait dengan build Anda.

Variabel penggantian $_WORKFLOW_NAME memungkinkan Anda menggunakan kembali file konfigurasi dengan nilai variabel yang berbeda. Anda dapat menentukan nilainya saat membuat pemicu build.

Untuk mengetahui informasi selengkapnya, lihat Membuat file konfigurasi build.

Membuat pemicu build

Anda dapat mengotomatiskan deployment alur kerja dengan membuat pemicu Cloud Build.

Untuk membuat pemicu build untuk file konfigurasi di bagian sebelumnya:

Di konsol Google Cloud, buka halaman Pemicu Cloud Build:

Buka Pemicu
Klik Create trigger.
Di kolom Nama, masukkan nama pemicu Anda.
Untuk Peristiwa, pilih peristiwa untuk memanggil pemicu Anda.

Misalnya: Push to a branch
Untuk Sumber, pilih repositori, dan cabang atau nama tag yang akan memulai pemicu Anda. Anda dapat menggunakan ekspresi reguler untuk menentukan kecocokan dengan cabang atau tag.

Misalnya: GoogleCloudPlatform/workflows-demos (repositori) dan ^main$|^staging$ (cocok dengan cabang main dan staging)
Luaskan bagian Tampilkan filter file yang disertakan dan diabaikan, lalu tentukan alur kerja Anda sebagai file yang disertakan sehingga saat diubah, build akan dipanggil.

Contoh: gitops/workflow.yaml
Untuk Konfigurasi, pilih File konfigurasi Cloud Build (YAML atau JSON) sebagai jenis, dan Repositori sebagai lokasi.
Di kolom Cloud Build configuration file location, tentukan lokasi file Anda.

Contoh: gitops/cloudbuild.yaml
Secara opsional, untuk menambahkan variabel penggantian, klik Tambahkan variabel dan tentukan kombinasi kunci dan nilai.

Misalnya: _WORKFLOW_NAME (variabel) dan workflows-gitops (nilai)
Untuk menyimpan pemicu build, klik Buat.

Jika ada perubahan yang dikirim ke alur kerja di cabang repositori Git yang ditentukan, perubahan tersebut akan otomatis memicu Cloud Build untuk men-deploy alur kerja.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola pemicu build.

Menguji pemicu build

Anda dapat menguji pemicu build dan file konfigurasi dari bagian sebelumnya.

Di cabang staging repositori Git, edit workflow.yaml, dan ubah Hello World menjadi Bye World:

main:
  steps:
    - init:
        assign:
          - message: "Hello World"
    - returnResult:
        return: ${message}

Lakukan commit dan kirim perubahan ke cabang staging.
```
git add workflow.yaml
git commit -m "Update workflow.yaml in staging"
git push
```
Pemicu Cloud Build berjalan dan memulai build.
Untuk mengonfirmasi keberhasilan build, di konsol Google Cloud, buka halaman Build history:

Buka Histori build

Setelah build selesai, Cloud Build akan memberikan status keseluruhan untuk build dan untuk setiap langkah build. Untuk mengetahui informasi selengkapnya, lihat Melihat hasil build.
Untuk mengonfirmasi bahwa alur kerja staging di-deploy, di konsol Google Cloud, buka halaman Workflows:

Buka Workflows

Anda akan melihat alur kerja bernama workflows-gitops-staging tercantum.

Untuk men-deploy alur kerja staging ke produksi, gabungkan cabang staging ke cabang main:

git checkout main
git merge staging
git push

Perhatikan bahwa karena test-main.sh mengharapkan Hello World dalam output alur kerja, build akan gagal:

RESULT_EXPECTED="result: '\"Hello World\"'"
RESULT_ACTUAL=$(grep "result: " $FILE)
if [[ $RESULT_EXPECTED == $RESULT_ACTUAL ]]; then
  echo "Result test passed"
else
  echo "Result test failed. Expected: $RESULT_EXPECTED Actual: $RESULT_ACTUAL"; exit 1;
fi

Agar berhasil men-deploy alur kerja produksi, di cabang staging, edit workflow.yaml lagi dan ubah string kembali ke Hello World.
Commit dan kirim perubahan ke cabang staging, lalu gabungkan cabang staging ke cabang main.
Untuk mengonfirmasi bahwa alur kerja produksi telah di-deploy, di konsol Google Cloud, buka halaman Workflows:

Buka Workflows

Anda akan melihat alur kerja bernama workflows-gitops-main tercantum.

Langkah selanjutnya

Pelajari Cloud Build lebih lanjut.
Pelajari cara memecahkan masalah error build.
Pelajari cara memecahkan masalah Alur Kerja.