REST Resource: projects.locations.releases

Risorsa: Release

Una nuova versione da propagare e distribuire alle unità. Ciò include puntatori a blueprint in pacchetto per l'attivazione (ad es.pacchetti di configurazione Helm o Terraform) tramite il registro degli artefatti.

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

string

Identificatore. Il nome della risorsa (URI completo della risorsa) che segue lo schema di denominazione standard:

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

unitKind

string

Obbligatorio. Immutabile. Riferimento a UnitKind a cui corrisponde questa release (obbligatorio e non modificabile dopo la creazione).

blueprint

object (Blueprint)

Facoltativo. Questi sono immagini OCI contenenti tutti gli artefatti necessari per eseguire il provisioning di un'unità.

releaseRequirements

object (ReleaseRequirements)

Facoltativo. Insieme di requisiti da soddisfare sull'unità quando si utilizza questa versione.

inputVariables[]

object (UnitVariable)

Facoltativo. Solo output. Elenco delle variabili di input dichiarate nel progetto e che possono essere presenti con i relativi valori nella specifica dell'unità

outputVariables[]

object (UnitVariable)

Facoltativo. Solo output. Elenco delle variabili di output dichiarate nel progetto e che possono essere presenti con i relativi valori nello stato dell'unità

inputVariableDefaults[]

object (UnitVariable)

Facoltativo. Mappatura delle variabili di input ai valori predefiniti. Massimo 100

labels

map (key: string, value: string)

Facoltativo. Le etichette sulla risorsa, che possono essere utilizzate per la categorizzazione, simili alle etichette delle risorse Kubernetes.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Facoltativo. Le annotazioni sono una mappa chiave-valore non strutturata archiviata con una risorsa che può essere impostata da strumenti esterni per archiviare e recuperare metadati arbitrari. Non sono interrogabili e devono essere conservati durante la modifica degli oggetti.

Scopri di più: https://kubernetes.io/docs/user-guide/annotations

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Solo output. Identificatore unico della risorsa. L'UID è unico nello spazio e nel tempo per questa risorsa nell'ambito del servizio. Viene tipicamente generato dal server durante la creazione di una risorsa e non deve essere modificato. L'UID viene utilizzato per identificare in modo unico le risorse quando i nomi risorsa vengono riutilizzati. Deve essere un UUID4.

etag

string

Solo output. Valore opaco che identifica in modo unico una versione o generazione di una risorsa. Può essere usato per confermare che client e server concordano nell'ordine di una risorsa in fase di scrittura.

createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della risorsa. Qualsiasi modifica apportata alla risorsa dagli utenti deve aggiornare questo valore. Le modifiche a una risorsa apportate dal servizio devono aggiornare questo valore.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Progetto iniziale

Questi sono immagini OCI contenenti tutti gli artefatti necessari per eseguire il provisioning di un'unità. I metadati come il tipo di motore utilizzato per attivare il blueprint (ad es. Terraform, Helm e così via) e la versione provengono dal manifest dell'immagine. Se il nome host viene omesso, si presume che sia il percorso regionale di Artifact Registry (ad es. us-east1-docker.pkg.dev).

Rappresentazione JSON
{
  "package": string,
  "engine": string,
  "version": string
}
Campi
package

string

Facoltativo. Immutabile. URI di un progetto utilizzato dall'unità (obbligatorio a meno che non sia impostato unitKind o release).

engine

string

Solo output. Il tipo di motore utilizzato per attivare il progetto. Ad esempio, Terraform, Helm e così via.

version

string

Solo output. Metadati della versione, se presenti nel progetto.

ReleaseRequirements

Insieme di requisiti da soddisfare sull'unità quando si utilizza questa versione.

Rappresentazione JSON
{
  "upgradeableFromReleases": [
    string
  ]
}
Campi
upgradeableFromReleases[]

string

Facoltativo. Un elenco di release da cui è possibile eseguire l'upgrade di un'unità a questa release (facoltativo). Se lasciato vuoto, non verranno applicati vincoli. Se fornite, le richieste di upgrade delle unità a questa release verranno controllate e verrà applicato questo vincolo.

Metodi

create

Crea una nuova release.

delete

Elimina una singola release.

get

Recuperare una singola uscita.

list

Recupera una raccolta di uscite.

patch

Aggiorna una singola release.