REST Resource: projects.locations.fleetPackages

Resource: FleetPackage

Resource FleetPackage di Config Delivery API.

FleetPackage menentukan paket yang digunakan untuk men-deploy konfigurasi Kubernetes ke fleet cluster Kubernetes.

Representasi JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "resourceBundleSelector": {
    object (ResourceBundleSelector)
  },
  "target": {
    object (Target)
  },
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "variantSelector": {
    object (VariantSelector)
  },
  "info": {
    object (FleetPackageInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "state": enum (State)
}
Kolom
name

string

ID. Nama FleetPackage. Formatnya adalah projects/{project}/locations/{location}/fleetPackages/{fleetPackage}. Komponen fleetPackage harus cocok dengan [a-z][a-z0-9\-]{0,62}

createTime

string (Timestamp format)

Hanya output. Waktu pembuatan FleetPackage.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format 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. Waktu terakhir FleetPackage diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format 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".

labels

map (key: string, value: string)

Opsional. Label adalah atribut yang dapat ditetapkan dan digunakan oleh pengguna dan Config Delivery. Label harus memenuhi batasan berikut:

  • Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung.
  • Semua karakter harus menggunakan encoding UTF-8, dan karakter internasional boleh digunakan.
  • Kunci harus diawali dengan huruf kecil atau karakter internasional.
  • Setiap resource dibatasi hingga maksimum 64 label.

Kunci dan nilai juga dibatasi hingga <= 128 byte.

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

resourceBundleSelector

object (ResourceBundleSelector)

Wajib. Informasi yang menentukan sumber konfigurasi Kubernetes yang akan di-deploy.

target

object (Target)

Opsional. Konfigurasi untuk memilih cluster target yang akan di-deploy konfigurasi Kubernetes.

rolloutStrategy

object (RolloutStrategy)

Opsional. Strategi yang akan digunakan untuk men-deploy konfigurasi Kubernetes ke cluster.

variantSelector

object (VariantSelector)

Wajib. Informasi yang menentukan cara memetakan varian ResourceBundle ke cluster target.

info

object (FleetPackageInfo)

Hanya output. Informasi yang berisi status peluncuran FleetPackage di semua cluster target.

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Opsional. Informasi seputar cara menangani resource Kubernetes di cluster target saat FleetPackage dihapus.

state

enum (State)

Opsional. Status paket fleet yang diinginkan.

ResourceBundleSelector

Informasi yang menentukan sumber konfigurasi Kubernetes yang akan di-deploy.

Representasi JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "resourceBundle": {
    object (ResourceBundleTag)
  },
  "cloudBuildRepository": {
    object (CloudBuildRepository)
  }
  // End of mutually exclusive fields.
}
Kolom
Sumber dapat berupa ResourceBundle atau CloudBuildRepository yang dikirim langsung yang berisi konfigurasi Kubernetes. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
resourceBundle

object (ResourceBundleTag)

Informasi yang menentukan ResourceBundle.

cloudBuildRepository

object (CloudBuildRepository)

Informasi yang menentukan CloudBuildRepository.

Akhir kolom yang saling eksklusif.

ResourceBundleTag

ResourceBundleTag berisi informasi untuk merujuk ke rilis untuk ResourceBundle.

Representasi JSON
{
  "name": string,
  "tag": string
}
Kolom
name

string

Wajib. Nama ResourceBundle. Formatnya adalah projects/{p}/locations/{l}/resourceBundles/{r}.

tag

string

Wajib. Tag Git untuk versi rilis di ResourceBundle. Tag harus mengikuti format pembuatan versi semantik vX.Y.Z.

CloudBuildRepository

CloudBuildRepository berisi informasi tentang pengambilan konfigurasi Kubernetes dari CloudBuildRepository.

Representasi JSON
{
  "name": string,
  "path": string,
  "tag": string,
  "serviceAccount": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "variantsPattern": string
  // End of mutually exclusive fields.
}
Kolom
name

string

Wajib. Nama repositori Cloud Build. Formatnya adalah projects/{p}/locations/{l}/connections/{c}/repositories/{r}.

path

string

Opsional. Jalur ke direktori atau file dalam repositori yang berisi konfigurasi Kubernetes. Jika tidak ditentukan, jalur akan diasumsikan ke direktori root level teratas repositori.

tag

string

Wajib. Tag Git dari repositori Git yang mendasarinya. Tag git harus dalam format versi semantik vX.Y.Z.

serviceAccount

string

Wajib. Akun layanan Google yang akan digunakan dalam pemicu CloudBuild untuk mengambil dan menyimpan konfigurasi Kubernetes.

Menentukan konfigurasi untuk cara menemukan varian di repositori. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
variantsPattern

string

Opsional. Pola glob yang akan digunakan untuk menemukan varian di repositori. Contoh: variants/*.yaml, us-*

Akhir kolom yang saling eksklusif.

Target

Target menentukan berbagai cara untuk menargetkan kumpulan cluster Kubernetes.

Representasi JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fleet": {
    object (Fleet)
  }
  // End of mutually exclusive fields.
}
Kolom
Target untuk paket fleet. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
fleet

object (Fleet)

Informasi fleet GKE untuk menargetkan peluncuran FleetPackage.

Akhir kolom yang saling eksklusif.

Fleet

Fleet tempat FleetPackage harus di-deploy.

Representasi JSON
{
  "project": string,
  "selector": {
    object (LabelSelector)
  }
}
Kolom
project

string

Wajib. Project host untuk fleet GKE. Format adalah projects/{project}.

selector

object (LabelSelector)

Opsional. Selector memungkinkan penargetan subset anggota fleet menggunakan labelnya.

LabelSelector

Pemilih label adalah kueri label pada sekumpulan resource. Pemilih label kosong cocok dengan semua objek.

Representasi JSON
{
  "matchLabels": {
    string: string,
    ...
  }
}
Kolom
matchLabels

map (key: string, value: string)

Opsional. Peta pasangan {key,value}. Setiap pasangan {key,value} harus sama persis dengan kunci dan nilai label yang ada agar cocok.

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

VariantSelector

VariantSelector berisi informasi untuk memilih varian di ResourceBundle yang akan di-deploy ke cluster target.

Representasi JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "variantNameTemplate": string
  // End of mutually exclusive fields.
}
Kolom
strategi untuk memilih varian. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
variantNameTemplate

string

Wajib. variantNameTemplate adalah template yang dapat merujuk ke variabel yang berisi metadata keanggotaan cluster seperti lokasi, nama, dan label untuk menghasilkan nama varian untuk cluster target. Sintaksis variabel mirip dengan variabel shell unix.

Variabel yang tersedia adalah ${membership.name}, ${membership.location}, ${membership.project}, dan ${membership.labels['label_name']}.

Jika ingin men-deploy varian tertentu, misalnya "default" ke semua cluster, Anda dapat menggunakan "default" (string tanpa variabel apa pun) sebagai variantNameTemplate.

Akhir kolom yang saling eksklusif.

FleetPackageInfo

FleetPackageInfo merepresentasikan status FleetPackage di semua cluster target.

Representasi JSON
{
  "activeRollout": string,
  "lastCompletedRollout": string,
  "state": enum (State),
  "errors": [
    {
      object (FleetPackageError)
    }
  ]
}
Kolom
activeRollout

string

Opsional. Peluncuran aktif, jika ada. Format adalah projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout}.

lastCompletedRollout

string

Opsional. Peluncuran terakhir yang selesai, jika ada. Format adalah projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout}.

state

enum (State)

Opsional. Hanya output. Status FleetPackage saat ini.

errors[]

object (FleetPackageError)

Opsional. Hanya output. Error yang terjadi selama deployment konfigurasi (jika ada).

Negara bagian/Provinsi

Nilai yang mungkin untuk status FleetPackage.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
ACTIVE FleetPackage aktif.
SUSPENDED FleetPackage ditangguhkan.
FAILED FleetPackage gagal direkonsiliasi.
DELETING FleetPackage sedang dihapus.

FleetPackageError

Informasi yang menunjukkan error yang terjadi selama peluncuran konfigurasi.

Representasi JSON
{
  "errorMessage": string
}
Kolom
errorMessage

string

Opsional. Deskripsi error.

Negara bagian/Provinsi

State menunjukkan status yang diinginkan untuk paket fleet. Nilai yang tidak ditentukan setara dengan ACTIVE. Jika status ditetapkan ke SUSPENDED, peluncuran aktif (jika ada) akan dilanjutkan, tetapi tidak ada peluncuran baru yang akan dijadwalkan.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
ACTIVE FleetPackage dimaksudkan untuk aktif.
SUSPENDED FleetPackage dimaksudkan untuk ditangguhkan.

Metode

create

Membuat FleetPackage baru di project dan lokasi tertentu.

delete

Menghapus satu FleetPackage.

get

Mendapatkan detail satu FleetPackage.

list

Mencantumkan FleetPackage di project dan lokasi tertentu.

patch

Memperbarui parameter satu FleetPackage.