Men-deploy aplikasi ke GKE menggunakan Cloud Deploy
Halaman ini menunjukkan cara menggunakan Cloud Deploy untuk mengirimkan image aplikasi contoh bernama nginx
ke serangkaian dua cluster Google Kubernetes Engine.
Dalam panduan memulai ini, Anda akan melakukan hal berikut:
Buat dua cluster.
Buat konfigurasi Skaffold dan manifes Kubernetes untuk menentukan image container (yang telah dibuat sebelumnya) yang akan di-deploy.
Tentukan pipeline pengiriman dan target deployment Cloud Deploy, yang mengarah ke dua cluster.
Buat instance pipeline pengiriman dengan membuat rilis, yang otomatis di-deploy ke target pertama.
Promosikan rilis ke target kedua.
Lihat kedua peluncuran di konsol Google Cloud .
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Pastikan akun layanan Compute Engine default memiliki izin yang memadai.
Akun layanan mungkin sudah memiliki izin yang diperlukan. Langkah-langkah ini disertakan untuk project yang menonaktifkan pemberian peran otomatis untuk akun layanan default.
- Tambahkan peran
clouddeploy.jobRunner
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/clouddeploy.jobRunner"
- Tambahkan izin developer Kubernetes:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/container.developer"
Jika Anda mengalami masalah saat menambahkan salah satu peran ini, hubungi administrator project Anda.
-
Tambahkan peran
iam.serviceAccountUser
, yang mencakup izinactAs
untuk men-deploy ke runtime:gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/iam.serviceAccountUser" \ --project=PROJECT_ID
Buat cluster Google Kubernetes Engine Anda
Buat dua cluster: qsdev
dan qsprod
, dengan setelan default. Endpoint Kubernetes API cluster harus dapat dijangkau melalui jaringan dari internet publik.
Cluster GKE dapat diakses secara eksternal secara default.
gcloud container clusters create-auto quickstart-cluster-qsdev --project=PROJECT_ID --region=us-central1 && gcloud container clusters create-auto quickstart-cluster-qsprod --project=PROJECT_ID --region=us-central1
Menyiapkan konfigurasi Skaffold dan manifes Kubernetes
Cloud Deploy menggunakan Skaffold untuk memberikan detail tentang apa yang akan di-deploy dan cara men-deploy-nya dengan benar untuk target terpisah Anda.
Dalam panduan memulai ini, Anda akan membuat file skaffold.yaml
, yang mengidentifikasi
manifes Kubernetes yang akan digunakan untuk men-deploy aplikasi contoh.
Buka jendela terminal.
Buat direktori baru, bernama
deploy-gke-quickstart
, lalu buka direktori tersebut.mkdir deploy-gke-quickstart cd deploy-gke-quickstart
Buat file bernama
skaffold.yaml
dengan konten berikut:apiVersion: skaffold/v4beta7 kind: Config manifests: rawYaml: - k8s-* deploy: kubectl: {}
File ini adalah konfigurasi Skaffold minimal, yang mengidentifikasi manifes Anda. Untuk panduan memulai ini, Anda akan membuat file. Namun, Anda juga dapat meminta Cloud Deploy membuatnya untuk Anda, untuk aplikasi non-produksi yang sederhana.
Lihat referensi
skaffold.yaml
untuk mengetahui informasi selengkapnya tentang file ini.Buat file bernama
k8s-pod.yaml
, dengan konten berikut:apiVersion: v1 kind: Pod metadata: name: getting-started spec: containers: - name: nginx image: my-app-image
File ini adalah manifes Kubernetes dasar, yang diterapkan ke cluster untuk men-deploy aplikasi. Image container yang akan di-deploy ditetapkan di sini sebagai placeholder,
my-app-image
, yang diganti dengan image tertentu saat Anda membuat rilis.
Membuat target dan pipeline pengiriman
Anda dapat menentukan pipeline dan target dalam satu file atau dalam file terpisah. Dalam panduan memulai ini, Anda akan membuat satu file.
Di direktori
deploy-gke-quickstart
, buat file baru:clouddeploy.yaml
, dengan konten berikut:apiVersion: deploy.cloud.google.com/v1 kind: DeliveryPipeline metadata: name: my-gke-demo-app-1 description: main application pipeline serialPipeline: stages: - targetId: qsdev profiles: [] - targetId: qsprod profiles: [] --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: qsdev description: development cluster gke: cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsdev --- apiVersion: deploy.cloud.google.com/v1 kind: Target metadata: name: qsprod description: production cluster gke: cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod
Daftarkan pipeline dan target Anda dengan layanan Cloud Deploy:
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
Sekarang Anda memiliki pipeline, dengan target, yang siap men-deploy aplikasi ke target pertama Anda.
Konfirmasi pipeline dan target Anda:
Di konsol Google Cloud , buka halaman Cloud Deploy Delivery pipelines untuk melihat daftar pipeline pengiriman yang tersedia.
Buka halaman Delivery pipelines
Pipeline pengiriman yang baru saja Anda buat akan ditampilkan, dan kedua target akan tercantum di kolom Target.
Membuat rilis
Rilis adalah resource Cloud Deploy pusat yang merepresentasikan perubahan yang di-deploy. Pipeline pengiriman menentukan siklus proses rilis tersebut. Lihat arsitektur layanan Cloud Deploy untuk mengetahui detail tentang siklus proses tersebut.
Jalankan perintah berikut dari direktori deploy-gke-quickstart
untuk membuat resource
release
yang merepresentasikan image container yang akan di-deploy:
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-gke-demo-app-1 \
--images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa
Perhatikan
flag --images=
, yang
Anda gunakan untuk mengganti placeholder (my-app-image
) dalam
manifest dengan
image spesifik yang memenuhi syarat SHA. Google merekomendasikan agar Anda membuat template
manifes dengan cara ini, dan menggunakan nama image yang memenuhi syarat SHA saat pembuatan rilis.
Seperti semua rilis (kecuali jika menyertakan --disable-initial-rollout
),
Cloud Deploy juga otomatis membuat resource
rollout. Aplikasi akan di-deploy secara otomatis ke target pertama dalam progres.
Mempromosikan rilis
Dari halaman Delivery pipelines, klik pipeline
my-gke-demo-app-1
.Buka halaman Delivery pipelines
Halaman Detail pipeline pengiriman menampilkan representasi grafis progres pipeline pengiriman Anda. Dalam hal ini, terlihat bahwa rilis telah di-deploy ke target
qsdev
.Pada target pertama dalam visualisasi pipeline penayangan, klik Promosikan.
Dialog Promosikan rilis akan ditampilkan. Halaman ini menampilkan detail target yang Anda promosikan.
Klik Promote.
Rilis kini diantrekan untuk di-deploy ke
qsprod
. Setelah deployment selesai, visualisasi pipeline pengiriman akan menunjukkannya sebagai di-deploy:
Melihat hasil di Google Cloud console
Di konsol Google Cloud , buka halaman Cloud Deploy Delivery pipelines untuk melihat pipeline pengiriman my-gke-demo-app-1.
Klik nama pipeline pengiriman Anda "my-gke-demo-app-1".
Visualisasi pipeline menunjukkan progres aplikasi melalui pipeline.
Rilis Anda juga tercantum di tab Rilis di bagian Detail pipeline pengiriman.
Klik nama rilis,
test-release-001
.Peluncuran Anda akan muncul di bagian Peluncuran. Anda dapat mengklik peluncuran untuk melihat detailnya, termasuk log deployment.
Pembersihan
Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
Hapus cluster
qsdev
:gcloud container clusters delete quickstart-cluster-qsdev --region=us-central1 --project=PROJECT_ID
Hapus cluster
qsprod
:gcloud container clusters delete quickstart-cluster-qsprod --region=us-central1 --project=PROJECT_ID
Hapus pipeline pengiriman, target, rilis, dan peluncuran:
gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
Hapus bucket Cloud Storage yang dibuat Cloud Deploy.
Salah satunya diakhiri dengan
_clouddeploy
, dan yang lainnya adalah[region].deploy-artifacts.[project].appspot.com
.
Selesai, Anda telah menyelesaikan panduan memulai ini.