REST Resource: projects.locations.fleetPackages

Risorsa: FleetPackage

Una risorsa FleetPackage nell'API Config Delivery.

Un FleetPackage definisce un pacchetto tramite il quale viene eseguito il deployment della configurazione Kubernetes in un parco risorse di cluster Kubernetes.

Rappresentazione 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)
}
Campi
name

string

Identificatore. Nome di FleetPackage. Il formato è projects/{project}/locations/{location}/fleetPackages/{fleetPackage}. Il componente fleetPackage deve corrispondere a [a-z][a-z0-9\-]{0,62}

createTime

string (Timestamp format)

Solo output. Ora in cui è stato creato l'oggetto FleetPackage.

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. Data e ora dell'ultimo aggiornamento di FleetPackage.

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".

labels

map (key: string, value: string)

Facoltativo. Le etichette sono attributi che possono essere impostati e utilizzati sia dall'utente sia da Config Delivery. Le etichette devono soddisfare i seguenti vincoli:

  • Chiavi e valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini.
  • Tutti i caratteri devono utilizzare la codifica UTF-8; sono consentiti i caratteri internazionali.
  • Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.
  • Ogni risorsa è limitata a un massimo di 64 etichette.

Inoltre, sia le chiavi che i valori devono essere <= 128 byte.

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

resourceBundleSelector

object (ResourceBundleSelector)

Obbligatorio. Informazioni che specificano l'origine della configurazione di Kubernetes di cui eseguire il deployment.

target

object (Target)

Facoltativo. Configurazione per selezionare i cluster di destinazione in cui eseguire il deployment della configurazione Kubernetes.

rolloutStrategy

object (RolloutStrategy)

Facoltativo. La strategia da utilizzare per eseguire il deployment della configurazione Kubernetes nei cluster.

variantSelector

object (VariantSelector)

Obbligatorio. Informazioni che specificano come mappare una variante ResourceBundle a un cluster di destinazione.

info

object (FleetPackageInfo)

Solo output. Informazioni contenenti lo stato di implementazione di FleetPackage in tutti i cluster di destinazione.

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Facoltativo. Informazioni su come gestire le risorse Kubernetes nei cluster di destinazione quando FleetPackage viene eliminato.

state

enum (State)

Facoltativo. Lo stato desiderato del pacchetto del parco risorse.

ResourceBundleSelector

Informazioni che specificano l'origine della configurazione di Kubernetes di cui eseguire il deployment.

Rappresentazione 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.
}
Campi
L'origine può essere un ResourceBundle o un CloudBuildRepository di cui è stato eseguito il push diretto contenente la configurazione di Kubernetes. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
resourceBundle

object (ResourceBundleTag)

Informazioni che specificano ResourceBundle.

cloudBuildRepository

object (CloudBuildRepository)

Informazioni che specificano CloudBuildRepository.

Fine dei campi che si escludono a vicenda.

ResourceBundleTag

ResourceBundleTag contiene le informazioni per fare riferimento a una release per un ResourceBundle.

Rappresentazione JSON
{
  "name": string,
  "tag": string
}
Campi
name

string

Obbligatorio. Nome di ResourceBundle. Il formato è projects/{p}/locations/{l}/resourceBundles/{r}.

tag

string

Obbligatorio. Il tag Git per una versione della release in un ResourceBundle. Il tag deve seguire il formato del controllo delle versioni semantico vX.Y.Z.

CloudBuildRepository

CloudBuildRepository contiene informazioni sul recupero della configurazione di Kubernetes da un CloudBuildRepository.

Rappresentazione 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.
}
Campi
name

string

Obbligatorio. Nome del repository Cloud Build. Il formato è projects/{p}/locations/{l}/connections/{c}/repositories/{r}.

path

string

Facoltativo. Percorso della directory o del file all'interno del repository che contiene la configurazione di Kubernetes. Se non specificato, si presume che il percorso sia la directory root di primo livello del repository.

tag

string

Obbligatorio. Tag Git del repository Git sottostante. Il tag git deve essere nel formato di versione semantica vX.Y.Z.

serviceAccount

string

Obbligatorio. Account di servizio Google da utilizzare nei trigger Cloud Build per recuperare e archiviare la configurazione di Kubernetes.

Specifica la configurazione per trovare le varianti nel repository. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
variantsPattern

string

Facoltativo. Pattern glob che verrà utilizzato per trovare le varianti nel repository. Esempi: variants/*.yaml, us-*

Fine dei campi che si escludono a vicenda.

Target

Il target definisce diversi modi per scegliere come target un insieme di cluster Kubernetes.

Rappresentazione 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.
}
Campi
Target per il pacchetto del parco risorse. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
fleet

object (Fleet)

Informazioni sul parco risorse GKE per l'implementazione target di FleetPackage.

Fine dei campi che si escludono a vicenda.

Parco risorse

Il parco risorse in cui deve essere eseguito il deployment di FleetPackage.

Rappresentazione JSON
{
  "project": string,
  "selector": {
    object (LabelSelector)
  }
}
Campi
project

string

Obbligatorio. Il progetto host per il parco risorse GKE. Il formato è projects/{project}.

selector

object (LabelSelector)

Facoltativo. Il selettore consente di scegliere come target un sottoinsieme di membri del parco risorse utilizzando le relative etichette.

LabelSelector

Un selettore di etichette è una query di etichette su un insieme di risorse. Un selettore di etichette vuoto corrisponde a tutti gli oggetti.

Rappresentazione JSON
{
  "matchLabels": {
    string: string,
    ...
  }
}
Campi
matchLabels

map (key: string, value: string)

Facoltativo. Mappa di coppie {key,value}. Ogni coppia {key,value} deve corrispondere esattamente a una chiave e un valore di etichetta esistenti per soddisfare la corrispondenza.

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

VariantSelector

VariantSelector contiene informazioni per selezionare una variante in ResourceBundle da distribuire in un cluster di destinazione.

Rappresentazione 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.
}
Campi
strategia per la selezione di una variante. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
variantNameTemplate

string

Obbligatorio. variantNameTemplate è un modello che può fare riferimento a variabili contenenti metadati di appartenenza al cluster, come località, nome ed etichette, per generare il nome della variante per un cluster di destinazione. La sintassi delle variabili è simile a quella delle variabili shell unix.

Le variabili disponibili sono ${membership.name}, ${membership.location}, ${membership.project} e ${membership.labels['label_name']}.

Se vuoi eseguire il deployment di una variante specifica, ad esempio "default", a tutti i cluster, puoi usare "default" (stringa senza variabili) come variantNameTemplate.

Fine dei campi che si escludono a vicenda.

FleetPackageInfo

FleetPackageInfo rappresenta lo stato di FleetPackage in tutti i cluster di destinazione.

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

string

Facoltativo. L'implementazione attiva, se presente. Il formato è projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout}.

lastCompletedRollout

string

Facoltativo. L'ultimo lancio completato, se presente. Il formato è projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/{rollout}.

state

enum (State)

Facoltativo. Solo output. Lo stato attuale di FleetPackage.

errors[]

object (FleetPackageError)

Facoltativo. Solo output. Errori riscontrati durante il deployment della configurazione (se presenti).

Stato

Valori possibili per lo stato FleetPackage.

Enum
STATE_UNSPECIFIED Stato non specificato.
ACTIVE FleetPackage è attivo.
SUSPENDED FleetPackage è stato sospeso.
FAILED Riconciliazione di FleetPackage non riuscita.
DELETING Eliminazione di FleetPackage in corso.

FleetPackageError

Informazioni che rappresentano un errore riscontrato durante l'implementazione delle configurazioni.

Rappresentazione JSON
{
  "errorMessage": string
}
Campi
errorMessage

string

Facoltativo. Una descrizione dell'errore.

Stato

Lo stato indica lo stato desiderato per il pacchetto del parco risorse. Il valore non specificato equivale a ACTIVE. Se lo stato è impostato su SUSPENDED, l'implementazione attiva (se presente) continuerà, ma non verranno pianificate nuove implementazioni.

Enum
STATE_UNSPECIFIED Stato non specificato.
ACTIVE FleetPackage deve essere attivo.
SUSPENDED FleetPackage deve essere sospeso.

Metodi

create

Crea un nuovo FleetPackage in un progetto e una località specifici.

delete

Elimina un singolo FleetPackage.

get

Recupera i dettagli di un singolo FleetPackage.

list

Elenca le risorse FleetPackage in un progetto e una località specifici.

patch

Aggiorna i parametri di un singolo FleetPackage.