REST Resource: projects.locations.rolloutKinds

Resource: RolloutKind

Objek yang menjelaskan berbagai setelan eksekusi Peluncuran. Mencakup kebijakan bawaan dan yang dapat disesuaikan.

Representasi JSON
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "maintenancePolicyEnforcement": enum (MaintenancePolicyEnforcement),
  "unitFilter": string,
  "updateUnitKindStrategy": enum (UpdateUnitKindStrategy),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "errorBudget": {
    object (ErrorBudget)
  }
}
Kolom
name

string

ID. Nama resource (URI lengkap resource) yang mengikuti skema penamaan standar:

"projects/{project}/locations/{location}/rolloutKinds/{rolloutKindId}"

unitKind

string

Wajib. Tidak dapat diubah. UnitKind yang sesuai dengan jenis peluncuran ini. Peluncuran yang berasal dari jenis peluncuran ini akan menargetkan unit dari jenis unit ini. Dengan kata lain, hal ini menentukan populasi unit target yang akan diupgrade oleh peluncuran.

rolloutOrchestrationStrategy

string

Opsional. Strategi yang digunakan untuk mengeksekusi Peluncuran. Kolom ini wajib diisi.

Ada dua strategi nilai yang didukung yang digunakan untuk mengontrol - "Google.Cloud.Simple.AllAtOnce" - "Google.Cloud.Simple.OneLocationAtATime"

Peluncuran dengan salah satu strategi sederhana ini akan diluncurkan di semua lokasi yang ditentukan di Lokasi Saas UnitKind terkait.

maintenancePolicyEnforcement

enum (MaintenancePolicyEnforcement)

Opsional. Nilai antara ketat (menerapkan kebijakan pemeliharaan dan hanya melihat Unit dengan kebijakan pemeliharaan), abaikan (mengabaikan kebijakan pemeliharaan), dan lewati (melewati Unit dengan kebijakan pemeliharaan)

unitFilter

string

Opsional. String filter berformat CEL(https://github.com/google/cel-spec) terhadap Unit. Filter akan diterapkan untuk menentukan populasi unit yang memenuhi syarat. Filter ini hanya dapat mengurangi, tetapi tidak dapat memperluas cakupan peluncuran.

updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

Opsional. Konfigurasi untuk memperbarui jenis unit. Secara default, jenis unit akan diperbarui saat peluncuran dimulai.

labels

map (key: string, value: string)

Opsional. Label pada resource, yang dapat digunakan untuk kategorisasi, mirip dengan label resource Kubernetes.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Opsional. Anotasi adalah peta nilai kunci tidak terstruktur yang disimpan dengan resource yang dapat ditetapkan oleh alat eksternal untuk menyimpan dan mengambil metadata arbitrer. Objek ini tidak dapat dikueri dan harus dipertahankan saat mengubah objek.

Info selengkapnya: https://kubernetes.io/docs/user-guide/annotations

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Hanya output. ID unik resource. UID bersifat unik dalam waktu dan ruang untuk resource ini dalam cakupan layanan. ID ini biasanya dibuat oleh server saat resource berhasil dibuat dan tidak boleh diubah. UID digunakan untuk mengidentifikasi resource secara unik dengan penggunaan ulang nama resource. Nilai ini harus berupa UUID4.

etag

string

Hanya output. Nilai buram yang secara unik mengidentifikasi versi atau generasi resource. Nilai ini dapat digunakan untuk mengonfirmasi bahwa klien dan server menyetujui pengurutan resource yang sedang ditulis.

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource terakhir diperbarui. Setiap perubahan pada resource yang dilakukan oleh pengguna harus memperbarui nilai ini. Perubahan pada resource yang dilakukan oleh layanan harus memperbarui nilai ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

errorBudget

object (ErrorBudget)

Opsional. Konfigurasi untuk anggaran error. Jika jumlah unit yang gagal melebihi max(allowedCount, allowed_ratio * totalUnits), peluncuran akan dijeda. Jika tidak disetel, semua unit akan dicoba diperbarui, terlepas dari jumlah kegagalan yang terjadi.

MaintenancePolicyEnforcement

Menentukan penegakan kebijakan pemeliharaan.

Enum
MAINTENANCE_POLICY_ENFORCEMENT_UNSPECIFIED
MAINTENANCE_POLICY_ENFORCEMENT_STRICT
MAINTENANCE_POLICY_ENFORCEMENT_IGNORED
MAINTENANCE_POLICY_ENFORCEMENT_SKIPPED

UpdateUnitKindStrategy

Enum
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
UPDATE_UNIT_KIND_STRATEGY_ON_START Perbarui strategi jenis unit saat peluncuran dimulai.
UPDATE_UNIT_KIND_STRATEGY_NEVER Jangan pernah memperbarui jenis unit.

ErrorBudget

Konfigurasi untuk anggaran error. Jika jumlah unit yang gagal melebihi max(allowedCount, allowed_ratio * totalUnits), peluncuran akan dijeda.

Representasi JSON
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
Kolom
allowedCount

integer

Opsional. Jumlah maksimum unit yang gagal yang diizinkan di suatu lokasi tanpa menjeda peluncuran.

allowedPercentage

integer

Opsional. Persentase maksimum unit yang diizinkan untuk gagal (0, 100] dalam suatu lokasi tanpa menjeda peluncuran.

Metode

create

Buat jenis peluncuran baru.

delete

Menghapus satu jenis peluncuran.

get

Mengambil satu jenis peluncuran.

list

Mengambil kumpulan jenis peluncuran.

patch

Memperbarui satu jenis peluncuran.