Menggunakan toolchain GKE Enterprise dengan Active Assist

Menyiapkan lingkungan Anda

Dalam tutorial ini, Anda akan menjalankan semua perintah di Cloud Shell.

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

2. Tetapkan variabel untuk project ID dan nomor project dari project Google Cloud build saat ini:

   export RECO_MGR_PROJECT=PROJECT_ID
   gcloud config set project $RECO_MGR_PROJECT
   export RECO_MGR_PROJECT_NUMBER=$(gcloud projects describe $RECO_MGR_PROJECT --format='value(projectNumber)')
   

   Ganti PROJECT_ID dengan project ID yang Anda catat di bagian sebelumnya.

3. Tetapkan variabel untuk region deployment:

   export REGION=us-central1
   export ZONE=us-central1-a
   

4. Clone repositori yang berisi kode untuk aplikasi contoh yang digunakan dalam tutorial ini:

   git clone https://github.com/GoogleCloudPlatform/activeassist-anthos-toolchain.git
   

5. Buka direktori project:

   cd activeassist-anthos-toolchain
   

Membangun pipeline

Di bagian ini, Anda akan membuat komponen untuk mem-build pipeline. Rekomendasi Active Assist dihasilkan berdasarkan pola penggunaan dan metrik sistem. Setiap kategori rekomendasi dapat menggunakan periode waktu default yang berbeda untuk menganalisis data penggunaan dan metrik berdasarkan rekomendasi yang dibuat. Untuk menguji pipeline end-to-end, repositori yang Anda clone pada langkah sebelumnya memberikan contoh rekomendasi (stub) yang Anda gunakan untuk menjalankan pipeline end-to-end.

Atau, jika Anda menjalankan pipeline dalam project contoh yang sudah memiliki resource dan rekomendasi, Anda dapat membuat perubahan yang sesuai pada kode contoh, lalu menjalankan pipeline.

Menyiapkan contoh repositori GitHub pribadi

Di bagian berikut, Anda akan menyiapkan contoh repositori GitHub untuk tutorial ini.

Menyiapkan repositori GitHub DRY pribadi

1. Buat repositori GitHub pribadi untuk repositori DRY. Catat nama yang Anda berikan ke repositori.

2. Di Cloud Shell, buat variabel lingkungan untuk nama pengguna GitHub Anda dan nama repositori DRY:

   export REPO_OWNER=YOUR_GITHUB_USERNAME
   export DRY_REPO_NAME=YOUR_PRIVATE_DRY_REPO
   

   Ganti kode berikut:

   • YOUR_GITHUB_USERNAME: nama pengguna GitHub Anda.
   • YOUR_PRIVATE_DRY_REPO: nama repositori DRY Anda.

3. Buat token akses pribadi (PAT) untuk membuat masalah di repositori ini. Pipeline ini menimbulkan masalah GitHub jika ada rekomendasi Active Assist yang perlu ditinjau. Untuk mengetahui informasi selengkapnya tentang cara membuat PAT di GitHub, lihat dokumentasi GitHub.

   Saat Anda menetapkan scope untuk token ini, pilih Full control of private repositories.

4. Di Cloud Shell, buat variabel lingkungan untuk PAT yang Anda buat:

   export GITHUB_TOKEN=YOUR_PERSONAL_ACCESS_TOKEN
   

   Ganti YOUR_PERSONAL_ACCESS_TOKEN dengan token Anda sendiri.

Menyiapkan repositori GitHub pribadi yang terhidrasi

1. Buat repositori GitHub pribadi untuk repositori terhidrasi. Catat nama yang Anda berikan ke repositori.

2. Di Cloud Shell, tetapkan variabel lingkungan untuk repositori terhidrasi:

   export HYDRATED_REPO_NAME=YOUR_PRIVATE_HYDRATED_REPO
   export HYDRATED_REPO='[email protected]:$REPO_OWNER/$HYDRATED_REPO_NAME.git'
   

   Ganti YOUR_PRIVATE_HYDRATED_REPO dengan nama repositori terhidrasi Anda.

3. Buat pasangan kunci deploy:

   ssh-keygen -t rsa -b 4096 \
   -C 'active-assist-robot' \
   -N '' \
   -f $(pwd)/active-assist-robot
   

   Dengan kunci deploy, Anda dapat men-deploy ke repositori GitHub pribadi saat menjalankan tugas Cloud Build untuk menghidrasi file konfigurasi.

4. Cetak kunci yang dibuat:

   cat $(pwd)/active-assist-robot.pub
   

5. Tambahkan kunci deploy ke repositori GitHub pribadi. Pastikan Anda memilih Izinkan akses tulis saat menambahkan kunci deploy. Untuk mempelajari cara menambahkan kunci deploy ke repositori GitHub, lihat dokumentasi GitHub untuk Mengelola kunci deploy.

Mengupload kunci GitHub ke Secret Manager

1. Di Cloud Shell, buat rahasia untuk menyimpan kunci pribadi dari pasangan kunci yang di-deploy:

   gcloud secrets create github-ssh-key \
     --data-file=$(pwd)/active-assist-robot
   

2. Buat secret untuk menyimpan PAT:

   echo $GITHUB_TOKEN | gcloud secrets create github-pat --data-file=-
   

Membuat cluster GKE

Di bagian ini, Anda akan membuat cluster GKE dengan add-on Config Connector, membuat identitas, dan mengonfigurasi Config Connector. Anda juga akan mengonfigurasi Config Sync. Anda dapat menggunakan Config Sync untuk membuat konfigurasi umum di seluruh infrastruktur, termasuk kebijakan kustom, serta menerapkannya di infrastruktur lokal dan cloud. Config Sync mengevaluasi perubahan dan meluncurkannya ke semua cluster Kubernetes sehingga status yang Anda inginkan selalu tercermin dalam cluster Anda.

1. Di Cloud Shell, buat cluster GKE baru dengan add-on Config Connector yang diaktifkan:

   gcloud container clusters create sample-ops \
     --machine-type n1-standard-4 \
     --zone $ZONE \
     --release-channel regular \
     --addons ConfigConnector \
     --workload-pool=$RECO_MGR_PROJECT.svc.id.goog \
     --enable-stackdriver-kubernetes \
     --enable-ip-alias
   

2. Selesaikan bagian berikut dalam panduan Menginstal dengan add-on GKE untuk membuat identitas dan mengonfigurasi Config Connector.

   1. Membuat identitas
   2. Mengonfigurasi Config Connector

3. Instal Config Sync di cluster GKE yang Anda buat. Saat mengonfigurasi Config Sync, Anda harus melakukan hal berikut:

   1. Gunakan token untuk memberikan akses hanya baca Config Sync ke Git. Gunakan token GitHub yang Anda buat saat menyiapkan repositori GitHub DRY pribadi. Token ini tersedia melalui variabel lingkungan $GITHUB_TOKEN.
   2. Mengonfigurasi Config Sync menggunakan gcloud. Tetapkan setelan berikut:
      1. sourceFormat: hierarchy
      2. syncRepo: https://github.com/YOUR_GITHUB_USERNAME/YOUR_PRIVATE_HYDRATED_REPO
      3. syncBranch: main
      4. secretType: token
      5. policyDir: Jangan isi opsi ini

Buat pemicu Cloud Build untuk dikirim ke repositori terhidrasi

Di bagian berikut, Anda akan membuat pemicu Cloud Build yang terpicu saat template dikirim ke cabang utama repositori YOUR_PRIVATE_DRY_REPO Anda. Pemicu ini menjalankan langkah-langkah yang menghidrasi template KRM konfigurasi sebagai data di repositori YOUR_PRIVATE_DRY_REPO dan mengirim file konfigurasi terhidrasi ke repositori YOUR_PRIVATE_HYDRATED_REPO Anda.

Menghubungkan Cloud Build ke repositori GitHub Anda

Di bagian ini, Anda akan menghubungkan repositori GitHub YOUR_PRIVATE_DRY_REPO dan YOUR_PRIVATE_HYDRATED_REPO ke Cloud Build.

1. Buka halaman marketplace GitHub untuk aplikasi Cloud Build.

   Buka halaman aplikasi Cloud Build

2. Klik Setup with Google Cloud Build.

3. Jika diminta, login ke GitHub.

4. Pilih Hanya pilih repositori.

   Gunakan drop-down Select repository untuk mengaktifkan akses ke repositori YOUR_PRIVATE_DRY_REPO dan YOUR_PRIVATE_HYDRATED_REPO Anda melalui aplikasi Cloud Build.

5. Klik Install (Instal).

6. Login ke Google Cloud Halaman Authorization akan ditampilkan dan Anda diminta untuk mengizinkan aplikasi Google Cloud Build agar terhubung ke Google Cloud.

7. Klik otorisasikan Google Cloud Build dengan GoogleCloudBuild. Anda akan dialihkan ke konsol Google Cloud.

8. Pilih project Google Cloud Anda.

9. Centang kotak izin, lalu klik Berikutnya.

10. Klik Install (Instal).

11. Login ke Google Cloud Halaman Authorization akan ditampilkan dan Anda diminta untuk mengizinkan aplikasi Google Cloud Build agar terhubung ke Google Cloud.

12. Klik otorisasikan Google Cloud Build dengan GoogleCloudBuild. Anda akan dialihkan ke konsol Google Cloud.

13. Pilih project Google Cloud Anda.

14. Centang kotak izin, lalu klik Berikutnya.

15. Di halaman Select repository yang muncul, pilih repositori GitHub berikut:

    • YOUR_PRIVATE_DRY_REPO
    • YOUR_PRIVATE_HYDRATED_REPO

16. Klik Hubungkan, lalu klik Selesai.

Membuat pemicu Cloud Build untuk repositori DRY

1. Jalankan perintah berikut di Cloud Shell:

   envsubst < cloudbuild.template.yaml > cloudbuild.yaml
   

   Perintah ini menghasilkan file cloudbuild.yaml.

2. Buat pemicu:

   gcloud beta builds triggers create github \
     --name ActiveAssistDemo \
     --repo-name=$DRY_REPO_NAME \
     --repo-owner=$REPO_OWNER \
     --branch-pattern="main" \
     --build-config=cloudbuild.yaml
   

3. Beri akun layanan Cloud Build izin untuk mengakses Secret Manager:

   gcloud secrets add-iam-policy-binding github-ssh-key  \
     --member="serviceAccount:${RECO_MGR_PROJECT_NUMBER}@cloudbuild.gserviceaccount.com" \
     --role="roles/secretmanager.secretAccessor"
   
   gcloud secrets add-iam-policy-binding github-pat  \
     --member="serviceAccount:${RECO_MGR_PROJECT_NUMBER}@cloudbuild.gserviceaccount.com" \
     --role="roles/secretmanager.secretAccessor"
   

Membuat pemicu Cloud Build terjadwal untuk rekomendasi Active Assist

Di bagian berikut, Anda akan membuat pemicu Cloud Build terjadwal yang berjalan secara berkala. Pemicu ini mengambil rekomendasi Active Assist menggunakan fungsi kpt dan menentukan apakah ada rekomendasi aktif untuk resource di repositori YOUR_PRIVATE_HYDRATED_REPO Anda. Fungsi kpt juga akan menimbulkan masalah GitHub di repositori YOUR_PRIVATE_HYDRATED_REPO Anda jika ada rekomendasi aktif untuk konfigurasi resource yang perlu ditinjau dan ditindaklanjuti.

Membuat image Cloud Build

Di bagian ini, Anda akan membuat image Cloud Build yang memiliki komponen kpt, gh, dan Node.

1. Di Cloud Shell, build dan kirim image Docker ke Container Registry:

   gcloud auth configure-docker
   
   docker build -t gcr.io/$RECO_MGR_PROJECT/kpt-dev-gh:1 ./recommender-kpt-function
   
   docker push gcr.io/$RECO_MGR_PROJECT/kpt-dev-gh:1
   

Buat pemicu Cloud Build untuk repo terhidrasi

1. Di Cloud Shell, buat file konfigurasi yang diperlukan untuk menyiapkan pemicu Cloud Build yang dijadwalkan:

    envsubst < cloudbuild-scheduled-recommendations.template.yaml > cloudbuild-scheduled-recommendations.yaml
   

2. Buat pemicu Cloud Build:

   gcloud beta builds triggers create github \
     --name ActiveAssistScheduledRecommendations \
     --repo-name=YOUR_PRIVATE_HYDRATED_REPO \
     --repo-owner=$REPO_OWNER \
     --branch-pattern="main" \
     --build-config=cloudbuild-scheduled-recommendations.yaml
   

3. Dapatkan ID pemicu ini:

   export TRIGGER_ID=`gcloud beta builds triggers describe \
     ActiveAssistScheduledRecommendations \
     --format="value(id)"`
   

Buat tugas Cloud Scheduler untuk memanggil pemicu Anda

1. Di Cloud Shell, buat akun layanan:

   gcloud iam service-accounts create build-invoker \
      --description "Service Account used by Cloud Scheduler to invoke the sample scheduled Cloud Build job" \
      --display-name "recommender-scheduler-sa" \
      --project $RECO_MGR_PROJECT
   

   Tugas Cloud Scheduler menggunakan akun layanan ini untuk menjalankan layanan recommender-parser.

2. Beri akun layanan tersebut izin untuk memanggil tugas Cloud Build:

   gcloud projects add-iam-policy-binding $RECO_MGR_PROJECT \
     --member serviceAccount:build-invoker@$RECO_MGR_PROJECT.iam.gserviceaccount.com \
     --role roles/cloudbuild.builds.editor \
     --project $RECO_MGR_PROJECT
   
    gcloud projects add-iam-policy-binding $RECO_MGR_PROJECT \
      --member serviceAccount:build-invoker@$RECO_MGR_PROJECT.iam.gserviceaccount.com \
      --role roles/serviceusage.serviceUsageConsumer \
      --project $RECO_MGR_PROJECT
   

3. Buat tugas Cloud Scheduler untuk memanggil pemicu yang Anda buat pada langkah sebelumnya:

   gcloud scheduler jobs create http scheduled-build \
      --project $RECO_MGR_PROJECT \
      --time-zone "America/Los_Angeles" \
      --schedule="0 */3 * * *" \
      --uri="https://cloudbuild.googleapis.com/v1/projects/${RECO_MGR_PROJECT}/triggers/${TRIGGER_ID}:run" \
      --description="Scheduler job to invoke Cloud Build" \
      --oauth-service-account-email="build-invoker@$RECO_MGR_PROJECT.iam.gserviceaccount.com" \
      --headers="Content-Type=application/json" \
      --http-method="POST" \
   

   Pilih Y jika Anda melihat pesan berikut:

   There is no App Engine app in the project.

   Jika diminta untuk memilih region tempat aplikasi App Engine berada, pilih region us-central.

Commit dan kirim file konfigurasi Cloud Build ke GitHub

Kirim dua file konfigurasi Cloud Build yang Anda buat ke repositori YOUR_PRIVATE_DRY_REPO Anda:

git remote add dry https://github.com/$REPO_OWNER/$DRY_REPO_NAME.git

git add cloudbuild.yaml
git add cloudbuild-scheduled-recommendations.yaml
git commit -m "Added cloudbuild configuration YAMLs"
git push dry main

Anda mungkin diminta untuk memasukkan kredensial GitHub saat mengirim ke repositori pribadi.

Meninjau hasil tugas Cloud Build

Saat Anda meng-commit dan mengirim perubahan ke repositori YOUR_PRIVATE_DRY_REPO, tugas Cloud Build akan dipicu. Jika tugas Cloud Build berhasil dijalankan, beberapa resource akan dibuat. Di bagian ini, Anda memverifikasi apakah resource sudah dibuat setelah tugas Cloud Build selesai.

1. Di Cloud Shell, di cluster sample-ops, validasi bahwa Anda memiliki namespace bernama activeassist-kcc:

   kubectl get ns | grep activeassist-kcc
   

2. Config Connector men-deploy contoh instance Compute Engine yang sedang berjalan ke project PROJECT_ID Anda.

   Validasi bahwa instance Compute Engine ada dalam project:

    gcloud compute instances list | grep \
    computeinstance-sample-cloudmachine
   

   Jenis MACHINE_TYPE untuk mesin ini adalah n1-standard-1.

Menjalankan pengujian menyeluruh

Agar Anda dapat menguji pipeline end-to-end, repositori yang Anda clone untuk tutorial ini menyediakan rekomendasi contoh (stub). Gunakan stub ini untuk menjalankan pipeline end-to-end. Stub tersebut meniru payload rekomendasi Active Assist dan memiliki rekomendasi untuk mengubah jenis mesin untuk instance Compute Engine yang di-deploy dari jenis instance n1-standard-1 ke jenis instance g1-small.

Di bagian ini, Anda akan memanggil pemicu Cloud Build terjadwal secara manual untuk menjalankan tugas yang menggunakan fungsi kpt untuk mengambil rekomendasi Active Assist. Anda juga harus memverifikasi bahwa masalah GitHub dibuat di repositori YOUR_PRIVATE_DRY_REPO Anda.

1. Buka halaman Build Triggers di Konsol Google Cloud.

   Buka halaman Pemicu Build

2. Pilih pemicu ActiveAssistScheduledRecommendations.

3. Untuk menguji pemicu secara manual, klik Run pada entri untuk pemicu Anda di daftar pemicu.

   Pemicu akan membuat masalah GitHub di repositori YOUR_PRIVATE_DRY_REPO Anda. Masalahnya mirip dengan yang berikut ini:

   gcloud auth configure-docker
   
   docker build -t gcr.io/$RECO_MGR_PROJECT/kpt-dev-gh:1 ./recommender-kpt-function
   
   docker push gcr.io/$RECO_MGR_PROJECT/kpt-dev-gh:1
   

   Dalam contoh masalah, output fungsi kpt menunjukkan bahwa jenis MACHINE_TYPE saat ini untuk instance Compute Engine adalah jenis n1-standard-1. Rekomendasi Active Assist adalah mengubahnya ke jenis g1-small.

   Peninjau kontrol versi di perusahaan Anda dapat meninjau masalah GitHub otomatis dan menindaklanjutinya sebagaimana mestinya untuk perusahaan Anda.