Memperbarui penawaran SaaS

Dokumen ini menjelaskan cara mengupdate penawaran SaaS menggunakan App Lifecycle Manager.

App Lifecycle Manager memungkinkan update di beberapa unit yang disediakan menggunakan peluncuran. Peluncuran menargetkan unit berdasarkan UnitKind-nya dan dapat menerapkan filter (unit_filter) secara opsional untuk menargetkan subset unit tertentu menggunakan Google Cloud CLI . Hal ini memungkinkan update terkelola di seluruh basis yang di-deploy. Rollback dapat dilakukan dengan mengupgrade unit ke rilis sebelumnya.

Untuk operasi pada satu unit tertentu, gunakan kontrol yang tersedia di halaman Detail unit.

Sebelum memulai

Sebelum memperbarui penawaran Aplikasi, Anda harus:

Membuat rilis

Sebelum dapat mengupdate penawaran Aplikasi, Anda harus membuat rilis. Rilis mewakili versi tertentu dari aplikasi SaaS Anda yang ditentukan oleh paket blueprint dan konfigurasi terkaitnya. Pada dasarnya, rilis berisi update untuk unit Anda.

Konsol

  1. Buka App Lifecycle Manager.

    Buka App Lifecycle Manager

  2. Klik Rilis.

  3. Di halaman Rilis, klik Buat.

  4. Di halaman Create Release:

    1. Di kotak Nama rilis, masukkan nama unik untuk rilis Anda.
    2. Di kotak Unit kind, pilih jenis unit yang terkait dengan rilis ini.
    3. Di bagian Hanya dapat diupgrade dari (opsional), Anda dapat memilih rilis yang dapat diupgrade dari unit ke rilis ini. Dengan demikian, Anda dapat mengontrol jalur upgrade.
    4. Pada langkah Create Blueprint dan Store Blueprint, pilih atau buat blueprint Anda. Lihat dokumentasi Blueprint untuk mengetahui informasi mendetail tentang opsi pembuatan blueprint.
    5. Di bagian Variables (optional), Anda dapat menetapkan variabel input untuk rilis ini. Lihat dokumentasi Variabel untuk mengetahui informasi selengkapnya tentang cara menetapkan variabel.

  5. Klik Create.

  6. Anda telah membuat rilis. Anda dapat melihat detail rilis di halaman Detail rilis. Anda akan dapat mereferensikan rilis ini saat membuat peluncuran.

gcloud

Untuk membuat rilis menggunakan konsol Google Cloud :

gcloud app-lifecycle-manager releases create RELEASE_NAME --blueprint-package=BLUEPRINT_PACKAGE_URI --unit-kind=UNIT_KIND [--location=LOCATION] [--labels=[KEY=VALUE,...]] [--upgradeable-from-releases=[RELEASE_NAME,...]] [--input-variable-defaults=[variable=VARIABLE,value=VALUE,type=TYPE,...]]

Ganti:

  • RELEASE_NAME: ID rilis yang ingin Anda buat. ID ini akan menjadi bagian dari nama resource lengkap untuk rilis.
  • BLUEPRINT_PACKAGE_URI: URI paket blueprint yang akan digunakan untuk rilis ini. Blueprint adalah image OCI yang dihosting di Artifact Registry, atau registry OCI lainnya.
    • Paket blueprint berisi artefak yang diperlukan untuk menyediakan unit, dan menyertakan metadata tentang mesin yang digunakan (Terraform), serta versinya.
    • Jika Anda menghilangkan nama host di URI, nama host akan ditetapkan secara default ke jalur Artifact Registry regional (misalnya, us-east1-docker.pkg.dev).
    • Lihat dokumentasi Blueprint untuk mengetahui informasi selengkapnya tentang cara membuat blueprint.
  • UNIT_KIND: ID atau ID yang sepenuhnya memenuhi syarat untuk jenis unit yang sesuai dengan rilis ini. UNIT_KIND tidak dapat diubah setelah Anda membuat rilis.
  • LOCATION: Lokasi tempat Anda ingin membuat rilis. Flag ini memberikan nilai penggantian untuk lokasi rilis jika jalur URI lengkap tidak diberikan. Defaultnya adalah lokasi yang dikonfigurasi di lingkungan Google Cloud CLI Anda.
  • LABELS: (Opsional) Label yang akan diterapkan ke rilis untuk kategorisasi. Label merupakan pasangan nilai kunci.
    • Kunci harus diawali dengan huruf kecil dan hanya berisi tanda hubung, garis bawah, huruf kecil, dan angka.
    • Nilai hanya boleh berisi tanda hubung, garis bawah, karakter huruf kecil, dan angka.
    • Contoh: --labels=environment=staging,team=app-lifecycle-manager
  • UPGRADEABLE_FROM_RELEASES: (Opsional) Daftar nama rilis yang dipisahkan koma yang menentukan rilis yang ada yang dapat diupdate dengan rilis baru yang Anda buat.
    • Jika Anda mengosongkan flag ini, tidak ada batasan rilis mana yang dapat diupdate ke rilis ini.
    • Jika diberikan, permintaan update unit ke rilis ini akan menerapkan batasan ini.
  • INPUT_VARIABLE_DEFAULTS: (Opsional) Nilai default untuk variabel input yang diperlukan oleh blueprint.
    • Anda dapat menentukan default variabel secara inline atau dengan mereferensikan file YAML atau JSON.
    • Variabel yang ditentukan di sini dapat diganti selama pembuatan peluncuran.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan variabel, lihat Dokumentasi variabel. Untuk mengetahui informasi selengkapnya tentang rilis, lihat referensi Google Cloud CLI Release.

Membuat jenis peluncuran

Sebelum dapat membuat peluncuran, Anda harus membuat jenis peluncuran yang berfungsi sebagai template untuk cara rilis di-deploy ke unit Anda.

Konsol

  1. Buka App Lifecycle Manager.

    Buka App Lifecycle Manager

  2. Klik Rollout kinds.

  3. Di halaman Rollout Kinds, klik Create.

  4. Di halaman Create a rollout kind:

    1. Di kotak Rollout kind name, masukkan nama untuk jenis peluncuran Anda.
    2. Di kotak Jenis unit, pilih jenis unit yang menjelaskan jenis unit yang ingin Anda update dengan rilis.
    3. Di menu drop-down Strategi peluncuran, pilih strategi yang ingin Anda gunakan untuk men-deploy rilis ke unit:

      • Satu lokasi sekaligus (sederhana): Memperbarui satu lokasi sekaligus (tanpa waktu tunggu). Mengupdate hingga 5% unit secara serentak.
      • Semua sekaligus (sederhana): Semua lokasi mulai diupdate secara bersamaan (ideal untuk lingkungan pengembangan dan skenario darurat).
      • Progresif (bertahap): Men-deploy update secara bertahap dalam batch persentase secara eksponensial di beberapa lokasi (dengan waktu tunggu).
      • Progresif (satu lokasi): Mengupdate unit dalam batch persentase dengan waktu tunggu yang diperpanjang untuk mendeteksi masalah dalam satu lokasi.

      Untuk mengetahui informasi selengkapnya tentang strategi peluncuran, lihat Strategi peluncuran.

  5. Klik Create.

  6. Anda telah membuat jenis peluncuran. Di halaman Rollout Kind details, Anda dapat melihat dan mengedit parameter untuk jenis peluncuran Anda.

gcloud

Untuk membuat jenis peluncuran menggunakan konsol Google Cloud :

  gcloud app-lifecycle-manager rollout-kinds create ROLLOUT_KIND_NAME --unit-kind=UNIT_KIND --location=LOCATION --rollout_strategy=ROLLOUT_STRATEGY --error_budget=ERROR_BUDGET --unit_filter=UNIT_FILTER --update_unit_kind_default=UPDATE_UNIT_KIND_DEFAULT

Ganti:

  • ROLLOUT_KIND_NAME: Nama jenis peluncuran.
  • UNIT_KIND: Menentukan unit yang ingin Anda terapkan rilisnya. Rilis diterapkan ke semua unit dari jenis unit yang dipilih.
  • LOCATION: Lokasi tempat Anda ingin membuat jenis peluncuran.
  • ROLLOUT_STRATEGY: Menentukan strategi peluncuran untuk jenis peluncuran Anda. Nilai yang memungkinkan mencakup:

    • Google.Cloud.Simple.OneLocationAtATime: Mengupdate satu lokasi dalam satu waktu (tanpa waktu tunggu). Mengupdate hingga 5% unit secara serentak.
    • Google.Cloud.Simple.AllAtOnce: Semua lokasi mulai diupdate secara bersamaan (ideal untuk lingkungan pengembangan dan skenario darurat).
    • Google.Cloud.Progressive.Gradual.v1: Men-deploy update secara bertahap dalam batch persentase secara eksponensial di beberapa lokasi (dengan waktu tunggu).
    • Google.Cloud.Progressive.SingleLocation.v1: Memperbarui unit dalam batch persentase dengan waktu tunggu yang diperpanjang untuk mendeteksi masalah dalam satu lokasi.

    Untuk mengetahui informasi selengkapnya tentang strategi peluncuran, lihat Strategi peluncuran.

  • ERROR_BUDGET: Konfigurasi untuk anggaran error. Jika jumlah unit yang gagal melebihi batas maksimum error_budget (ditentukan oleh allowed_count, allowed_ratio * total_units), peluncuran akan dijeda. Jika error_budget tidak ditetapkan, App Lifecycle Manager akan mencoba mengupdate semua unit, terlepas dari jumlah kegagalan yang terjadi.

  • UNIT_FILTER: String filter berformat CEL yang digunakan terhadap unit. Filter akan diterapkan untuk menentukan populasi unit yang memenuhi syarat. Filter ini hanya dapat mengurangi cakupan peluncuran. Tindakan ini tidak dapat memperluas cakupan peluncuran.

  • UPDATE_UNIT_KIND_DEFAULT: Konfigurasi untuk memperbarui jenis unit. Secara default, jenis unit akan diupdate saat peluncuran dimulai. Nilai yang memungkinkan mencakup:

    • UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED: Strategi update jenis unit tidak ditentukan.
    • UPDATE_UNIT_KIND_STRATEGY_ON_START: Memperbarui strategi jenis unit pada awal peluncuran.
    • UPDATE_UNIT_KIND_STRATEGY_NEVER: Jangan pernah mengupdate strategi jenis unit.

Untuk mengetahui informasi selengkapnya, lihat referensi Google Cloud CLI RolloutKind.

Fitur anggaran error

App Lifecycle Manager menyertakan fitur anggaran error (ErrorBudget di RolloutKind) sebagai pengaman. Hal ini dapat otomatis menjeda peluncuran jika jumlah atau persentase kegagalan update unit (misalnya, selama penerapan infrastruktur) melebihi batas yang dikonfigurasi, sehingga membantu membatasi dampak potensi masalah selama update.

Membuat peluncuran

Setelah membuat jenis peluncuran, Anda dapat membuat peluncuran yang menentukan rilis yang ingin Anda gunakan untuk mengupdate unit.

Setelah peluncuran dibuat, App Lifecycle Manager akan mengupdate unit Anda sesuai dengan strategi yang ditentukan dalam jenis unit.

Konsol

  1. Buka App Lifecycle Manager.

    Buka App Lifecycle Manager

  2. Klik Peluncuran.

  3. Di halaman Rollout List, klik Create.

  4. Di halaman Create a rollout:

    1. Di kotak Jenis Peluncuran, pilih jenis peluncuran yang menjelaskan cara men-deploy rilis ke unit yang ditentukan.
    2. Di kotak Release, tentukan rilis untuk mengupdate unit.
    3. Di kotak Rollout Name, masukkan nama untuk peluncuran Anda.
  5. Klik Create.

  6. Peluncuran Anda telah dibuat.

    Di halaman Global Rollout Detail, Anda dapat memantau detail peluncuran, termasuk status peluncuran, progres peluncuran (berdasarkan jumlah unit), dan kegagalan peluncuran.

gcloud

Untuk membuat peluncuran menggunakan konsol Google Cloud :

  gcloud app-lifecycle-manager rollouts create ROLLOUT_NAME --rollout-kind=ROLLOUT_KIND_NAME --release=RELEASE_NAME --location=LOCATION

Ganti:

  • ROLLOUT_NAME: Nama peluncuran.
  • ROLLOUT_KIND_NAME: Menentukan jenis peluncuran yang ingin Anda gunakan untuk menerapkan rilis ke unit Anda. Rilis diterapkan ke semua unit dari jenis unit yang ditentukan dalam jenis peluncuran.
  • RELEASE_NAME: Menentukan biner rilis yang ingin Anda deploy ke unit.
  • LOCATION: Lokasi tempat Anda ingin membuat peluncuran.

Untuk mengetahui informasi selengkapnya, lihat referensi Google Cloud CLI Rollout.

Langkah berikutnya