REST Resource: projects.locations.releases

Resource: Rilis

Versi baru yang akan disebarkan dan di-deploy ke unit. Hal ini mencakup pointer ke cetak biru yang dikemas untuk aktuasi (misalnya, paket konfigurasi Helm atau Terraform) melalui artifact registry.

Representasi JSON
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "applicationTemplateComponent": {
    object (ComponentRef)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Kolom
name

string

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

"projects/{project}/locations/{location}/releases/{release}"

unitKind

string

Wajib. Tidak dapat diubah. Referensi ke UnitKind yang sesuai dengan Rilis ini (wajib dan tidak dapat diubah setelah dibuat).

blueprint

object (Blueprint)

Opsional. Blueprint adalah Image OCI yang berisi semua artefak yang diperlukan untuk menyediakan unit.

releaseRequirements

object (ReleaseRequirements)

Opsional. Kumpulan persyaratan yang harus dipenuhi di Unit saat menggunakan Rilis ini.

inputVariables[]

object (UnitVariable)

Opsional. Hanya output. Daftar variabel input yang dideklarasikan pada cetak biru dan dapat ada dengan nilainya pada spesifikasi unit

outputVariables[]

object (UnitVariable)

Opsional. Hanya output. Daftar variabel output yang dideklarasikan pada cetak biru dan dapat ditampilkan dengan nilainya pada status unit

inputVariableDefaults[]

object (UnitVariable)

Opsional. Pemetaan variabel input ke nilai default. Maksimal 100

applicationTemplateComponent

object (ComponentRef)

Hanya output. Referensi ke komponen dan revisi dalam ApplicationTemplate komposit.

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 pembuatan resource berhasil 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".

Cetak biru

Blueprint adalah Image OCI yang berisi semua artefak yang diperlukan untuk menyediakan unit. Metadata seperti jenis mesin yang digunakan untuk menggerakkan blueprint (misalnya, terraform, helm, dll.) dan versi akan berasal dari manifes image. Jika nama host tidak disertakan, nama host akan dianggap sebagai jalur regional ke Artifact Registry (mis. us-east1-docker.pkg.dev).

Representasi JSON
{
  "package": string,
  "engine": string,
  "version": string
}
Kolom
package

string

Opsional. Tidak dapat diubah. URI ke blueprint yang digunakan oleh Unit (wajib diisi kecuali jika unitKind atau rilis ditetapkan).

engine

string

Hanya output. Jenis mesin yang digunakan untuk menggerakkan blueprint. Misalnya, terraform, helm, dll.

version

string

Hanya output. Metadata versi jika ada pada cetak biru.

ReleaseRequirements

Kumpulan persyaratan yang harus dipenuhi di Unit saat menggunakan Rilis ini.

Representasi JSON
{
  "upgradeableFromReleases": [
    string
  ]
}
Kolom
upgradeableFromReleases[]

string

Opsional. Daftar rilis yang dapat digunakan untuk mengupgrade unit ke rilis ini (opsional). Jika dibiarkan kosong, tidak ada batasan yang akan diterapkan. Jika disediakan, permintaan upgrade unit ke rilis ini akan memeriksa dan menerapkan batasan ini.

Metode

create

Buat rilis baru.

delete

Menghapus satu rilis.

get

Mengambil satu rilis.

list

Mengambil kumpulan rilis.

patch

Memperbarui satu rilis.