Mendesain dan men-deploy penawaran SaaS

Application Design Center dan App Lifecycle Manager memungkinkan Anda menstandarkan dan menskalakan pengiriman SaaS multi-tenant tanpa mengonfigurasi infrastruktur secara manual untuk setiap pelanggan. Anda menyusun modul Terraform yang dapat digunakan kembali menjadi template aplikasi gabungan di App Design Center, lalu mengemas template tersebut ke dalam penawaran SaaS terkelola di App Lifecycle Manager.

Dalam tutorial ini, Anda akan menyediakan lingkungan tenant yang terisolasi serta mengotomatiskan update dan peluncuran progresif. Alur kerja ini dirancang untuk engineer platform, arsitek perusahaan, dan operator DevOps.

Tujuan

  • Siapkan repositori GitHub yang berisi modul Terraform Cloud Run dan Cloud Storage.
  • Tautkan repositori GitHub Anda ke Google Cloud menggunakan Developer Connect.
  • Impor modul Terraform untuk membuat dan membuat katalog template komponen di App Design Center.
  • Desain template aplikasi gabungan yang menyertakan template komponen Anda.
  • Mengemas template dan men-deploy lingkungan pelanggan di App Lifecycle Manager.
  • Otomatiskan peluncuran progresif di seluruh lingkungan pelanggan Anda.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, baca bagian Pembersihan.

Sebelum memulai

  1. 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.
  2. 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Developer Connect, Secret Manager, App Lifecycle Manager, Infrastructure Manager, and Cloud Run APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. 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

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Developer Connect, Secret Manager, App Lifecycle Manager, Infrastructure Manager, and Cloud Run APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  8. Pastikan Anda memiliki peran Identity and Access Management (IAM) berikut di project Anda:
    • Application Design Center Admin (roles/designcenter.admin) dan Service Usage Admin (roles/serviceusage.serviceUsageAdmin) untuk melakukan penyiapan.
    • SaaS Service Management Admin (roles/saasservicemgmt.admin)
    • Developer Connect Admin (roles/developerconnect.admin)
    • Project IAM Admin (roles/resourcemanager.projectIamAdmin) atau Security Admin (roles/iam.securityAdmin) untuk membuat akun layanan dan memberikan peran IAM.
    • Cloud Run Admin (roles/run.admin)
    • Storage Admin (roles/storage.admin)
    • Service Account Admin (roles/iam.serviceAccountAdmin)
  9. Instal Google Cloud CLI, lalu lakukan inisialisasi:
    gcloud init
    Pastikan Anda telah menginstal komponen beta:
    gcloud components install beta
  10. Selesaikan penyiapan untuk Application Design Center di project Anda menggunakan batas pengelolaan aplikasi satu project. Penyiapan ini memungkinkan pengelolaan aplikasi, menyediakan bucket penyimpanan untuk Terraform, serta membuat ruang default-space dan katalog default-catalog.
  11. Instal Git di komputer lokal Anda.
  12. Pastikan Anda memiliki akun GitHub dengan izin untuk membuat repositori dan membuat token akses pribadi.

Menyiapkan lingkungan dan repositori sumber

Untuk menyiapkan lingkungan Anda untuk tutorial ini, tentukan nilai variabel dan konfigurasikan repositori GitHub Anda.

Menentukan variabel tutorial

Tetapkan variabel dalam tutorial ini dan di terminal perintah Anda.

  1. Tetapkan variabel berikut untuk memperbarui perintah dalam tutorial ini:

    Variabel Deskripsi Nilai
    PROJECT_ID Project ID Google Cloud Anda PROJECT_ID
    REGION Region deployment untuk resource App Design Center, Developer Connect, penawaran App Lifecycle Manager, dan infrastruktur tenant us-central1
  2. Di terminal perintah, konfigurasikan project Google Cloud aktif:

    gcloud config set project PROJECT_ID
    
  3. Ambil nomor project Google Cloud Anda dan simpan dalam variabel lingkungan:

    PROJECT_NUM=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")
    

Membuat file konfigurasi Terraform

Membuat definisi Terraform modular untuk Cloud Run dan Cloud Storage. Nantinya, Anda akan mengimpor modul ini ke App Design Center untuk memaketkannya menjadi komponen arsitektur yang dapat digunakan kembali.

  1. Buat struktur direktori lokal untuk modul Terraform Anda:

    mkdir -p adc-alm-starter/infra/cloud-run
    mkdir -p adc-alm-starter/infra/cloud-storage
    cd adc-alm-starter
    
  2. Di infra/cloud-run/main.tf, buat definisi modul Cloud Run:

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = ">= 5.0.0"
        }
      }
    }
    
    variable "project_id" {
      type        = string
      description = "The Google Cloud project ID."
    }
    
    variable "region" {
      type        = string
      description = "The deployment region."
      default     = "us-central1"
    }
    
    variable "service_name" {
      type        = string
      description = "Name of the Cloud Run service."
      default     = "sample-app"
    }
    
    variable "bucket_name" {
      type        = string
      description = "Name of the Cloud Storage bucket to connect."
      default     = ""
    }
    
    resource "google_service_account" "app_sa" {
      account_id   = "${var.service_name}-sa"
      display_name = "Service Account for ${var.service_name}"
      project      = var.project_id
    }
    
    resource "google_cloud_run_v2_service" "app_service" {
      name                = var.service_name
      location            = var.region
      project             = var.project_id
      deletion_protection = false
    
      template {
        service_account = google_service_account.app_sa.email
        containers {
          image = "us-docker.pkg.dev/cloudrun/container/hello"
          env {
            name  = "STORAGE_BUCKET"
            value = var.bucket_name
          }
          resources {
            limits = {
              cpu    = "1"
              memory = "512Mi"
            }
          }
        }
      }
    }
    
    output "service_url" {
      description = "URL of the deployed Cloud Run service."
      value       = google_cloud_run_v2_service.app_service.uri
    }
    
    output "service_account_email" {
      description = "Email of the Cloud Run service account."
      value       = google_service_account.app_sa.email
    }
    
  3. Di infra/cloud-run/metadata.yaml, buat definisi metadata modul:

    apiVersion: blueprints.cloud.google.com/v1alpha1
    kind: BlueprintMetadata
    metadata:
      name: cloud-run-component
    spec:
      info:
        title: Cloud Run Component
        version: 0.1.0
        actuationTool:
          flavor: Terraform
          version: ">= 1.5.0"
      interfaces:
        variables:
          - name: project_id
            description: The Google Cloud project ID.
            varType: string
            required: true
          - name: region
            description: The deployment region.
            varType: string
            defaultValue: us-central1
          - name: service_name
            description: Name of the Cloud Run service.
            varType: string
            defaultValue: sample-app
          - name: bucket_name
            description: Name of the Cloud Storage bucket to connect.
            varType: string
            defaultValue: ""
        outputs:
          - name: service_url
            description: URL of the deployed Cloud Run service.
          - name: service_account_email
            description: Email of the Cloud Run service account.
    
  4. Di infra/cloud-storage/main.tf, buat definisi modul Cloud Storage:

    terraform {
      required_version = ">= 1.5.0"
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = ">= 5.0.0"
        }
        random = {
          source  = "hashicorp/random"
          version = ">= 3.5.0"
        }
      }
    }
    
    variable "project_id" {
      type        = string
      description = "The Google Cloud project ID."
    }
    
    variable "region" {
      type        = string
      description = "The deployment region."
      default     = "us-central1"
    }
    
    variable "bucket_name_prefix" {
      type        = string
      description = "Prefix for the Cloud Storage bucket."
      default     = "app-data"
    }
    
    variable "writer_service_account" {
      type        = string
      description = "Service account email granted objectAdmin permissions."
      default     = ""
    }
    
    resource "random_id" "bucket_suffix" {
      byte_length = 4
    }
    
    resource "google_storage_bucket" "bucket" {
      name                        = "${var.bucket_name_prefix}-${random_id.bucket_suffix.hex}"
      location                    = var.region
      project                     = var.project_id
      uniform_bucket_level_access = true
      force_destroy               = true
    }
    
    resource "google_storage_bucket_iam_member" "writer_grant" {
      count  = var.writer_service_account != "" ? 1 : 0
      bucket = google_storage_bucket.bucket.name
      role   = "roles/storage.objectAdmin"
      member = "serviceAccount:${var.writer_service_account}"
    }
    
    output "bucket_name" {
      description = "Name of the created storage bucket."
      value       = google_storage_bucket.bucket.name
    }
    
  5. Di infra/cloud-storage/metadata.yaml, buat definisi metadata modul:

    apiVersion: blueprints.cloud.google.com/v1alpha1
    kind: BlueprintMetadata
    metadata:
      name: cloud-storage-component
    spec:
      info:
        title: Cloud Storage Component
        version: 0.1.0
        actuationTool:
          flavor: Terraform
          version: ">= 1.5.0"
      interfaces:
        variables:
          - name: project_id
            description: The Google Cloud project ID.
            varType: string
            required: true
          - name: region
            description: The deployment region.
            varType: string
            defaultValue: us-central1
          - name: bucket_name_prefix
            description: Prefix for the Cloud Storage bucket.
            varType: string
            defaultValue: app-data
          - name: writer_service_account
            description: Service account email granted objectAdmin permissions.
            varType: string
            defaultValue: ""
        outputs:
          - name: bucket_name
            description: Name of the created storage bucket.
    

Mengirim Terraform ke GitHub

Commit konfigurasi Terraform Anda ke repositori GitHub dan hubungkan repositori ke Google Cloud melalui Developer Connect. Koneksi ini memberi App Design Center akses aman untuk mengimpor revisi infrastruktur langsung dari kontrol sumber.

  1. Di browser web, buat repositori GitHub baru bernama adc-alm-starter.

  2. Buat token akses pribadi yang mendetail di GitHub untuk mengautentikasi perintah git push Anda. Pilih repositori adc-alm-starter dan berikan izin Contents: Read and write.

  3. Di terminal perintah, lakukan inisialisasi Git di direktori adc-alm-starter, commit file, lalu kirim ke GitHub:

    cd adc-alm-starter
    git init
    git add infra/
    git commit -m "feat: initialize Cloud Run and Cloud Storage modules"
    git branch -M main
    git remote add origin https://github.com/GITHUB_USER_OR_ORG/adc-alm-starter.git
    git push -u origin main
    

    Saat diminta untuk melakukan autentikasi, masukkan nama pengguna GitHub dan token akses pribadi Anda.

  4. Di konsol Google Cloud , buka halaman Developer Connect:

    Buka Developer Connect

  5. Buat koneksi di region us-central1 untuk akun GitHub Anda dan tautkan repositori Anda. Untuk mengetahui petunjuk mendetail, lihat Menghubungkan ke GitHub.

  6. Identifikasi ID Koneksi dan ID link repositori Git untuk repositori yang ditautkan, lalu perbarui variabel berikut:

    • CONNECTION_ID: ID koneksi Developer Connect.
    • GIT_REPO_LINK_ID: ID repositori Git yang ditautkan.

Membuat template di App Design Center

Untuk mendesain infrastruktur Google Cloud , impor modul Terraform ke App Design Center sebagai template komponen. Kemudian, buat template aplikasi gabungan yang menyertakan komponen tersebut.

Memverifikasi ruang dan katalog Anda

Jika Anda telah menyelesaikan penyiapan App Design Center di konsol Google Cloud , ruang dan katalog default Anda akan otomatis dibuat.

Jika Anda telah menyelesaikan penyiapan dengan gcloud CLI, lakukan hal berikut:

  1. Pastikan default-space ada di region Anda:

    gcloud design-center spaces describe "default-space" \
        --location="us-central1"
    

    Ganti default-space dengan ID ruang App Design Center Anda.

  2. Jika ruang tidak ada, buat ruang dan katalog:

    gcloud design-center spaces create "default-space" \
        --location="us-central1" \
        --display-name="Default Space"
    
    gcloud design-center spaces catalogs create "default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --display-name="Default Catalog"
    

    Ganti default-catalog dengan ID katalog Anda.

Membuat template komponen

Template komponen mengubah modul Terraform individual menjadi elemen penyusun yang dapat Anda tambahkan ke template aplikasi multi-layanan.

Buat template komponen berdasarkan modul Terraform di repositori Git Anda:

  1. Buat template katalog untuk Cloud Run:

    gcloud design-center spaces catalogs templates create "cloud-run-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --display-name="Cloud Run Component" \
        --template-category=component-template
    

    Ganti cloud-run-component dengan ID untuk template komponen Cloud Run.

  2. Buat template katalog untuk Cloud Storage:

    gcloud design-center spaces catalogs templates create "cloud-storage-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --display-name="Cloud Storage Component" \
        --template-category=component-template
    

    Ganti cloud-storage-component dengan ID template komponen Cloud Storage.

  3. Buat revisi template dengan mengimpor modul Terraform Cloud Run dari repositori Git Anda:

    gcloud design-center spaces catalogs templates revisions create r-1 \
        --template="cloud-run-component" \
        --catalog="default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --developer-connect-repo="projects/PROJECT_ID/locations/us-central1/connections/CONNECTION_ID/gitRepositoryLinks/GIT_REPO_LINK_ID" \
        --developer-connect-repo-dir="infra/cloud-run" \
        --developer-connect-repo-ref="refs/heads/main"
    

    Ganti kode berikut:

    • CONNECTION_ID: ID koneksi Developer Connect Anda.
    • GIT_REPO_LINK_ID: ID link repositori Git tertaut Anda.
  4. Buat revisi template dengan mengimpor modul Terraform Cloud Storage dari repositori Git Anda:

    gcloud design-center spaces catalogs templates revisions create r-1 \
        --template="cloud-storage-component" \
        --catalog="default-catalog" \
        --space="default-space" \
        --location="us-central1" \
        --developer-connect-repo="projects/PROJECT_ID/locations/us-central1/connections/CONNECTION_ID/gitRepositoryLinks/GIT_REPO_LINK_ID" \
        --developer-connect-repo-dir="infra/cloud-storage" \
        --developer-connect-repo-ref="refs/heads/main"
    

    Ganti kode berikut:

    • CONNECTION_ID: ID koneksi Developer Connect Anda.
    • GIT_REPO_LINK_ID: ID link repositori Git tertaut Anda.
  5. Cantumkan template yang dibagikan di ruang Anda untuk mengambil ID template yang dibagikan:

    gcloud design-center spaces shared-templates list \
        --space="default-space" \
        --location="us-central1"
    

    Dalam output perintah, catat segmen SHARED_TEMPLATE_ID dari kolom name (projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/SHARED_TEMPLATE_ID) untuk cloud-run-component dan cloud-storage-component.

Membuat template aplikasi gabungan

Gabungkan template komponen Anda ke dalam template aplikasi gabungan dan konfigurasikan koneksi parameter. App Lifecycle Manager menggunakan template komposit untuk mengelola topologi aplikasi Anda sebagai penawaran SaaS. Anda menentukan output dan input untuk memastikan bahwa layanan Cloud Run otomatis menerima nama bucket dan izin IAM yang diperlukan untuk mengakses Cloud Storage.

  1. Buat template aplikasi gabungan:

    gcloud design-center spaces application-templates create "run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --display-name="Cloud Run and Storage Multi-Tenant Application" \
        --composition-type=composite
    

    Ganti run-storage-app dengan ID template aplikasi gabungan Anda.

  2. Tambahkan komponen Cloud Run ke template aplikasi:

    gcloud design-center spaces application-templates components create cloud-run-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --shared-template-revision-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/RUN_SHARED_TEMPLATE_ID/revisions/r-1"
    

    Ganti RUN_SHARED_TEMPLATE_ID dengan ID template yang dibagikan cloud-run-component yang Anda ambil.

  3. Tambahkan komponen Cloud Storage ke template aplikasi:

    gcloud design-center spaces application-templates components create cloud-storage-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --shared-template-revision-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/sharedTemplates/STORAGE_SHARED_TEMPLATE_ID/revisions/r-1"
    

    Ganti STORAGE_SHARED_TEMPLATE_ID dengan ID template yang dibagikan cloud-storage-component yang Anda ambil.

  4. Buat koneksi dari layanan Cloud Run ke bucket Cloud Storage. Tindakan ini akan menautkan output bucket ke variabel lingkungan layanan dan memberikan akses IAM akun layanan:

    gcloud design-center spaces application-templates components connections create run-to-storage \
        --component=cloud-run-comp \
        --application-template="run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --destination-component-uri="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app/components/cloud-storage-comp" \
        --source-component-parameters='[{"key": "bucket_name", "value": "module.cloud-storage-comp.bucket_name"}]' \
        --destination-component-parameters='[{"key": "writer_service_account", "value": "module.cloud-run-comp.service_account_email"}]'
    
  5. Commit template aplikasi untuk membuat revisi template yang tidak dapat diubah:

    gcloud design-center spaces application-templates commit "run-storage-app" \
        --space="default-space" \
        --location="us-central1"
    

    Output perintah akan mengonfirmasi ID revisi yang dihasilkan (seperti r-1), yang akan Anda referensikan saat membuat penawaran SaaS di App Lifecycle Manager.


Men-deploy lingkungan pelanggan dengan App Lifecycle Manager

Gunakan App Lifecycle Manager untuk mengubah template aplikasi Anda menjadi produk yang dapat di-deploy dan menyediakan lingkungan khusus untuk setiap pelanggan.

Mengemas template aplikasi Anda

Daftarkan revisi template Anda ke App Lifecycle Manager untuk membuat penawaran SaaS yang dapat di-deploy:

  1. Buat penawaran SaaS di us-central1:

    gcloud beta app-lifecycle-manager saas create "saas-run-storage" \
        --location="us-central1" \
        --locations=name="us-central1" \
        --application-template="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app" \
        --application-template-revision="projects/PROJECT_ID/locations/us-central1/spaces/default-space/applicationTemplates/run-storage-app/revisions/r-1"
    

    Ganti saas-run-storage dengan ID penawaran SaaS Anda.

  2. Buat daftar rilis yang dihasilkan untuk mengambil ID rilis, jenis unit, dan variabel input:

    gcloud beta app-lifecycle-manager releases list \
        --location="us-central1"
    

    App Lifecycle Manager membangun dan memaketkan blueprint template gabungan secara asinkron. Jika daftar kosong, tunggu beberapa menit dan jalankan kembali perintah.

    Perintah ini menghasilkan informasi berikut:

    • Kolom name (misalnya, projects/PROJECT_ID/locations/us-central1/releases/r-r-1-06c6a0). Segmen di bagian akhir adalah RELEASE_ID Anda (seperti r-r-1-06c6a0).
    • Kolom unitKind (misalnya, projects/PROJECT_ID/locations/us-central1/unitKinds/u-native-components-e97e0c). Segmen di bagian akhir adalah UNIT_KIND_ID Anda (seperti u-native-components-e97e0c).

Membuat akun layanan deployment

Buat akun layanan yang memberi App Lifecycle Manager izin untuk menyediakan resource atas nama Anda:

  1. Buat akun layanan aktuasi:

    gcloud iam service-accounts create "tenant-actuation-sa" \
        --display-name="Tenant Actuation Service Account"
    

    Ganti tenant-actuation-sa dengan nama akun layanan aktuasi Anda.

  2. Buat email akun layanan dan ambil identitas agen layanan App Lifecycle Manager:

    ACTUATION_SA="tenant-actuation-sa@PROJECT_ID.iam.gserviceaccount.com"
    ALM_P4SA="service-${PROJECT_NUM}@gcp-sa-saasservicemgmt.iam.gserviceaccount.com"
    INFRA_MANAGER_P4SA="service-${PROJECT_NUM}@gcp-sa-config.iam.gserviceaccount.com"
    
  3. Berikan peran yang diperlukan kepada akun layanan aktuasi untuk membuat dan mengelola infrastruktur tenant:

    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/run.admin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/storage.admin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/iam.serviceAccountAdmin" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    
    gcloud projects add-iam-policy-binding "PROJECT_ID" \
        --member="serviceAccount:${ACTUATION_SA}" \
        --role="roles/config.admin" \
        --condition=None
    
  4. Beri izin kepada agen layanan App Lifecycle Manager dan Infra Manager untuk meniru akun layanan aktuasi:

    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${ALM_P4SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    
    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${ALM_P4SA}" \
        --role="roles/iam.serviceAccountTokenCreator" \
        --condition=None
    
    gcloud iam service-accounts add-iam-policy-binding "${ACTUATION_SA}" \
        --member="serviceAccount:${INFRA_MANAGER_P4SA}" \
        --role="roles/iam.serviceAccountUser" \
        --condition=None
    

Men-deploy lingkungan untuk pelanggan

Buat lingkungan pelanggan dan picu deployment infrastruktur khusus mereka:

  1. Buat lingkungan Unit yang mewakili tenant pelanggan yang terisolasi menggunakan jenis unit yang dihasilkan:

    gcloud beta app-lifecycle-manager units create "tenant-1" \
        --location="us-central1" \
        --unit-kind="UNIT_KIND_ID"
    

    Ganti tenant-1 dengan ID unit tenant Anda.

  2. Memicu operasi unit untuk menyediakan infrastruktur tenant:

    gcloud beta app-lifecycle-manager unit-operations create provision-tenant-1 \
        --location="us-central1" \
        --unit="projects/PROJECT_ID/locations/us-central1/units/tenant-1" \
        --provision \
        --provision-release="RELEASE_ID" \
        --provision-input-variables=variable=project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=project_number,value="${PROJECT_NUM}",type=string \
        --provision-input-variables=variable=actuation_sa,value="${ACTUATION_SA}",type=string \
        --provision-input-variables=variable=cloud-run-comp_project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=cloud-run-comp_region,value="us-central1",type=string \
        --provision-input-variables=variable=cloud-storage-comp_project_id,value="PROJECT_ID",type=string \
        --provision-input-variables=variable=cloud-storage-comp_region,value="us-central1",type=string
    
  3. Deskripsikan operasi unit untuk memantau status penyediaan hingga mencapai SUCCEEDED:

    gcloud beta app-lifecycle-manager unit-operations describe provision-tenant-1 \
        --location="us-central1"
    

Mengotomatiskan update di seluruh lingkungan pelanggan

Gunakan peluncuran untuk men-deploy update aplikasi dengan aman di semua lingkungan pelanggan Anda.

Memilih strategi update

Tentukan cara update dikirimkan ke lingkungan pelanggan, seperti men-deploy semua sekaligus atau secara bertahap:

  1. Buat RolloutKind untuk menentukan strategi orkestrasi untuk unit Anda:

    gcloud beta app-lifecycle-manager rollout-kinds create "progressive-rollout" \
        --location="us-central1" \
        --unit-kind="projects/PROJECT_ID/locations/us-central1/unitKinds/UNIT_KIND_ID" \
        --rollout-orchestration-strategy="Google.Cloud.Simple.AllAtOnce"
    

    Ganti progressive-rollout dengan ID jenis peluncuran.

Men-deploy dan melacak update

Mulai peluncuran dan pantau progresnya hingga deployment selesai:

  1. Picu peluncuran untuk men-deploy rilis Anda di seluruh unit tenant yang memenuhi syarat:

    gcloud beta app-lifecycle-manager rollouts create "rollout-v1" \
        --location="us-central1" \
        --rollout-kind="projects/PROJECT_ID/locations/us-central1/rolloutKinds/progressive-rollout" \
        --release="projects/PROJECT_ID/locations/us-central1/releases/RELEASE_ID"
    

    Ganti rollout-v1 dengan ID untuk peluncuran Anda.

  2. Deskripsikan peluncuran untuk memeriksa eksekusi aktif dan memverifikasi bahwa statusnya mencapai SUCCEEDED:

    gcloud beta app-lifecycle-manager rollouts describe "rollout-v1" \
        --location="us-central1"
    

    Output peluncuran mengonfirmasi bahwa unit tenant Anda telah diupdate ke revisi template target.

Pembersihan

Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

Menghapus project

Menghapus Google Cloud project:

gcloud projects delete PROJECT_ID

Menghapus resource satu per satu

Jika Anda men-deploy resource tutorial ke project yang sudah ada, hapus setiap resource dalam urutan dependensi terbalik untuk mencegah penagihan yang tidak terduga:

  1. Cabut akses infrastruktur lingkungan pelanggan dan tunggu hingga selesai:

    gcloud beta app-lifecycle-manager unit-operations create deprovision-tenant-1 \
        --location="us-central1" \
        --unit="projects/PROJECT_ID/locations/us-central1/units/tenant-1" \
        --deprovision
    
    gcloud beta app-lifecycle-manager unit-operations describe deprovision-tenant-1 \
        --location="us-central1"
    
  2. Hapus lingkungan pelanggan App Lifecycle Manager:

    gcloud beta app-lifecycle-manager units delete "tenant-1" \
        --location="us-central1" \
        --quiet
    
  3. Hapus resource peluncuran dan rilis App Lifecycle Manager dalam urutan dependensi terbalik:

    gcloud beta app-lifecycle-manager rollouts delete "rollout-v1" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager rollout-kinds delete "progressive-rollout" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager releases delete "RELEASE_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager unit-kinds delete "UNIT_KIND_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud beta app-lifecycle-manager saas delete "saas-run-storage" \
        --location="us-central1" \
        --quiet
    
  4. Hapus template aplikasi, entri katalog, dan ruang App Design Center:

    gcloud design-center spaces application-templates delete "run-storage-app" \
        --space="default-space" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces catalogs templates delete "cloud-run-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces catalogs templates delete "cloud-storage-component" \
        --space="default-space" \
        --catalog="default-catalog" \
        --location="us-central1" \
        --force \
        --quiet
    
    gcloud design-center spaces delete "default-space" \
        --location="us-central1" \
        --force \
        --quiet
    
  5. Hapus link dan koneksi repositori Git Developer Connect:

    gcloud developer-connect connections git-repository-links delete "GIT_REPO_LINK_ID" \
        --connection="CONNECTION_ID" \
        --location="us-central1" \
        --quiet
    
    gcloud developer-connect connections delete "CONNECTION_ID" \
        --location="us-central1" \
        --quiet
    
  6. Hapus akun layanan aktuasi:

    gcloud iam service-accounts delete "${ACTUATION_SA}" \
        --quiet
    

Langkah berikutnya