Men-deploy aplikasi ke Cloud Run menggunakan Cloud Deploy

Halaman ini menunjukkan cara menggunakan Cloud Deploy untuk mengirimkan image aplikasi contoh bernama hello ke urutan dua layanan Cloud Run, dua tugas Cloud Run, atau dua kumpulan pekerja Cloud Run. (Worker pool Cloud Run ada di Pratinjau).

Dalam panduan memulai ini, Anda akan melakukan hal berikut:

Membuat konfigurasi Skaffold
Buat file konfigurasi untuk dua layanan Cloud Run, dua tugas, atau dua kumpulan worker.

File ini menentukan layanan atau tugas, dan menentukan image container (bawaan) yang akan di-deploy.
Tentukan pipeline pengiriman dan target deployment Cloud Deploy, yang mengarah ke dua layanan, dua tugas, atau dua kumpulan pekerja.
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

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, Cloud Run, and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat pipeline dan rilis pengiriman Cloud Deploy, minta administrator untuk memberi Anda peran IAM Cloud Deploy Job Runner (roles/clouddeploy.jobrunner) di project Anda.

Untuk memastikan bahwa akun layanan Cloud Deploy memiliki izin yang diperlukan untuk menjalankan operasi Cloud Deploy dan men-deploy ke Cloud Run, minta administrator untuk memberikan peran IAM berikut kepada akun layanan Cloud Deploy di project Anda:

Cloud Run Developer (roles/run.developer)
Pengguna Akun Layanan IAM (roles/iam.serviceAccountUser)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan Cloud Deploy melalui peran khusus atau peran bawaan lainnya.

Menyiapkan konfigurasi Skaffold

Cloud Deploy menggunakan Skaffold untuk memberikan detail tentang apa yang akan di-deploy dan cara men-deploy-nya dengan benar untuk target terpisah Anda.

Untuk panduan memulai ini, Anda akan membuat file skaffold.yaml, yang mengidentifikasi definisi layanan atau tugas Cloud Run yang akan digunakan untuk men-deploy aplikasi contoh.

Buka jendela terminal.
Buat direktori baru, bernama deploy-run-quickstart, lalu buka direktori tersebut.
```
mkdir deploy-run-quickstart
cd deploy-run-quickstart
```

Buat file bernama skaffold.yaml dengan konten berikut:

Layanan

apiVersion: skaffold/v4beta7
kind: Config
metadata: 
  name: deploy-run-quickstart
profiles:
- name: dev
  manifests:
    rawYaml:
    - run-service-dev.yaml
- name: prod
  manifests:
    rawYaml:
    - run-service-prod.yaml
deploy:
  cloudrun: {}

Pekerjaan

apiVersion: skaffold/v4beta7
kind: Config
metadata: 
  name: deploy-run-quickstart
profiles:
- name: dev
  manifests:
    rawYaml:
    - run-job-dev.yaml
- name: prod
  manifests:
    rawYaml:
    - run-job-prod.yaml
deploy:
  cloudrun: {}

Kumpulan pekerja (Pratinjau)

apiVersion: skaffold/v4beta7
kind: Config
metadata:
  name: deploy-run-quickstart
profiles:
- name: dev
  manifests:
    rawYaml:
    - run-worker-pool-dev.yaml
- name: prod
  manifests:
    rawYaml:
    - run-worker-pool-prod.yaml
deploy:
  cloudrun: {}

File ini adalah konfigurasi Skaffold minimal, yang mengidentifikasi layanan, tugas, atau kumpulan worker Cloud Run Anda. Lihat referensi skaffold.yaml untuk mengetahui informasi selengkapnya tentang file ini.

Menyiapkan layanan, tugas, atau kumpulan worker Cloud Run

Untuk panduan memulai ini, Anda akan membuat dua layanan Cloud Run yang berbeda, dua tugas Cloud Run, atau dua kumpulan pekerja Cloud Run dalam project yang sama. Cloud Deploy juga mendukung deployment di beberapa project. Selain itu, kami menggunakan profil Skaffold untuk memungkinkan adanya dua layanan, tugas, atau kumpulan pekerja dalam project yang sama. Saat menggunakan project yang berbeda, Anda mungkin tidak perlu menggunakan profil Skaffold.

Layanan

Buat file bernama run-service-dev.yaml dengan konten berikut:
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: deploy-run-service-dev
spec:
  template:
    spec:
      containers:
      - image: my-app-image
```
File ini menentukan layanan Cloud Run. Seperti yang tersirat dalam nama deploy-run-service-dev, ini adalah layanan dev Anda, dan sesuai dengan target pertama dalam progres pipeline penayangan Anda.
Buat file bernama run-service-prod.yaml dengan konten berikut:
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: deploy-run-service-prod
spec:
  template:
    spec:
      containers:
      - image: my-app-image
```
File ini menentukan layanan Cloud Run lainnya, dan seperti yang tersirat dari nama deploy-run-service-prod, ini adalah layanan prod Anda, dan sesuai dengan target kedua dalam progres pipeline pengiriman Anda.

File ini adalah definisi layanan Cloud Run, yang digunakan 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.

Pekerjaan

Buat file bernama run-job-dev.yaml dengan konten berikut:

apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: deploy-run-job-dev
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: my-app-image

File ini menentukan tugas Cloud Run. Seperti yang tersirat dalam namanya, deploy-run-job-dev adalah tugas dev Anda, dan sesuai dengan target pertama dalam progres pipeline pengiriman Anda.

Buat file bernama run-job-prod.yaml dengan konten berikut:

apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: deploy-run-job-prod
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: my-app-image

File ini menentukan tugas Cloud Run lainnya. Seperti yang tersirat dalam nama deploy-run-job-prod, ini adalah tugas prod Anda, dan sesuai dengan target kedua dalam progres pipeline pengiriman Anda.

File ini adalah definisi tugas Cloud Run, yang digunakan 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.

Kumpulan pekerja (Pratinjau)

Buat file bernama run-worker-pool-dev.yaml dengan konten berikut:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: deploy-run-worker-pool-dev
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  template:
    spec:
      containers:
      - image: my-app-image
```
File ini menentukan kumpulan pekerja Cloud Run. Seperti yang ditunjukkan oleh namanya deploy-run-worker-pool-dev, ini adalah kumpulan pekerja dev Anda, dan sesuai dengan target pertama dalam progres pipeline pengiriman Anda.
Buat file bernama run-worker-pool-prod.yaml dengan konten berikut:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: deploy-run-worker-pool-prod
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  template:
    spec:
      containers:
      - image: my-app-image
```
File ini menentukan kumpulan pekerja Cloud Run lainnya. Seperti yang tersirat dalam nama deploy-run-worker-pool-prod, ini adalah kumpulan pekerja prod Anda, dan sesuai dengan target kedua dalam progres pipeline pengiriman Anda.

File ini adalah definisi kumpulan pekerja Cloud Run, yang digunakan 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-run-quickstart, buat file baru: clouddeploy.yaml, dengan konten berikut:

apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
  name: my-run-demo-app-1
description: main application pipeline
serialPipeline:
  stages:
  - targetId: run-qsdev
    profiles: [dev]
  - targetId: run-qsprod
    profiles: [prod]
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: run-qsdev
description: Cloud Run development service
run:
  location: projects/PROJECT_ID/locations/us-central1
---

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
  name: run-qsprod
description: Cloud Run production service
run:
  location: projects/PROJECT_ID/locations/us-central1

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-run-quickstart untuk membuat resource release yang merepresentasikan image container yang akan di-deploy:

Layanan

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a

Pekerjaan

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/job@sha256:8eb3f5e72586de6375abe95aa67511c57c61d35fb37d5670e4d68624a68ef916

Kumpulan pekerja (Pratinjau)

 gcloud deploy releases create test-release-001 \
   --project=PROJECT_ID \
   --region=us-central1 \
   --delivery-pipeline=my-run-demo-app-1 \
   --skaffold-version=2.17.0 \
   --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:95ade4b17adcd07623b0a0c68359e344fe54e65d0cb01b989e24c39f2fcd296a

Perhatikan flag --images=, yang Anda gunakan untuk mengganti placeholder (my-app-image) dalam definisi layanan, tugas, atau kumpulan pekerja dengan image spesifik yang memenuhi syarat SHA. Google merekomendasikan agar Anda membuat template definisi layanan dan tugas dengan cara ini, dan menggunakan nama image yang memenuhi syarat SHA saat pembuatan rilis.

Flag --skaffold-version= menentukan versi Skaffold yang akan digunakan untuk deployment. Untuk dukungan kumpulan pekerja Cloud Run, Anda harus menggunakan Skaffold versi 2.17 atau yang lebih baru.

Seperti semua rilis (kecuali jika menyertakan --disable-initial-rollout), Cloud Deploy juga otomatis membuat resource rollout. Aplikasi akan otomatis di-deploy ke target pertama dalam progres.

Mempromosikan rilis

Dari halaman Delivery pipelines, klik pipeline my-run-demo-app-1.

Buka halaman Delivery pipelines

Halaman Detail pipeline pengiriman menampilkan representasi grafis dari progres pipeline pengiriman Anda. Dalam hal ini, terlihat bahwa rilis telah di-deploy ke target run-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 run-qsprod. Setelah deployment selesai, visualisasi pipeline pengiriman akan menunjukkannya sebagai di-deploy:

Melihat hasil di konsol Google Cloud

Di konsol Google Cloud , buka halaman Cloud Deploy Delivery pipelines untuk melihat pipeline pengiriman my-run-demo-app-1.

Buka halaman Delivery pipelines
Klik nama pipeline pengiriman Anda "my-run-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.

Mengakses layanan Cloud Run Anda

Secara default, Anda harus diautentikasi untuk mengakses layanan Cloud Run atau kumpulan worker yang baru dibuat. Lihat Ringkasan autentikasi Cloud Run untuk mempelajari cara memberikan kredensial dan mengetahui konfigurasi Identity and Access Management yang diperlukan untuk mengakses layanan tanpa autentikasi. Hal ini tidak berlaku untuk tugas Cloud Run.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Hapus layanan, tugas, atau kumpulan pekerja Cloud Run deploy-qs-dev:
Layanan
```
gcloud run services delete deploy-run-service-dev --region=us-central1 --project=PROJECT_ID
```
Pekerjaan
```
gcloud run jobs delete deploy-run-job-dev --region=us-central1 --project=PROJECT_ID
```
Kumpulan pekerja (Pratinjau)
gcloud beta run worker-pools delete deploy-run-worker-pool-dev --region=us-central1 --project=PROJECT_ID

Hapus layanan, tugas, atau kumpulan pekerja deploy-qs-prod:

Layanan

gcloud run services delete deploy-run-service-prod --region=us-central1 --project=PROJECT_ID

Pekerjaan

gcloud run jobs delete deploy-run-job-prod --region=us-central1 --project=PROJECT_ID

Kumpulan pekerja (Pratinjau)

gcloud beta run worker-pools delete deploy-run-worker-pool-prod --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.

Buka halaman browser Cloud Storage

Selesai, Anda telah menyelesaikan panduan memulai ini.

Langkah berikutnya

Pelajari Cloud Deploy lebih lanjut.
Pelajari dasar-dasar men-deploy aplikasi.
Baca artikel panduan cara men-deploy ke Cloud Run
Pelajari cara mengelola manifes Anda.
Pelajari cara menggabungkan alat CI/CD untuk mengembangkan dan mengirimkan software secara efektif ke GKE. Google Cloud