Method: projects.locations.memberships.generateConnectManifest

Génère le fichier manifeste pour le déploiement de l'agent GKE Connect.

Cette méthode est utilisée en interne par les bibliothèques fournies par Google. La plupart des clients n'ont normalement pas besoin d'appeler cette méthode directement.

Requête HTTP

GET https://gkehub.googleapis.com/v1beta1/{name=projects/*/locations/*/memberships/*}:generateConnectManifest

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de la ressource Membership à laquelle l'agent va s'associer, au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.memberships.generateConnectManifest

Paramètres de requête

Paramètres
connectAgent

object (ConnectAgent)

Facultatif. Agent Connect pour lequel générer le fichier manifeste.

version

string

Facultatif. Version de l'agent Connect à utiliser. Correspond par défaut à la version la plus récente.

isUpgrade

boolean

Facultatif. Si la valeur est définie sur "true", générez les ressources pour la mise à niveau uniquement. Certaines ressources générées uniquement pour l'installation (par exemple, les ressources Secret) seront exclues.

registry

string

Facultatif. Registre à partir duquel récupérer l'image de l'agent Connect. La valeur par défaut est gcr.io/gkeconnect.

imagePullSecretContent

string (bytes format)

Facultatif. Le contenu du secret d'extraction de l'image du registre, s'il n'est pas public.

Chaîne encodée en base64.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

GenerateConnectManifestResponse contient des informations du fichier manifeste pour l'installation/la mise à niveau d'un agent Connect.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "manifest": [
    {
      object (ConnectAgentResource)
    }
  ]
}
Champs
manifest[]

object (ConnectAgentResource)

Liste numérotée des ressources Kubernetes à appliquer au cluster pour l'installation ou la mise à niveau de l'agent GKE Connect.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.

ConnectAgent

Informations requises par les utilisateurs finaux pour utiliser GKE Connect.

Représentation JSON
{
  "name": string,
  "proxy": string,
  "namespace": string
}
Champs
name
(deprecated)

string

Ne le paramétrez pas.

proxy

string (bytes format)

Facultatif. URI d'un proxy si la connectivité de l'agent à gkeconnect.googleapis.com nécessite l'utilisation d'un proxy. Doit être au format http(s)://{proxy_address}, en fonction du protocole HTTP/HTTPS accepté par le proxy. Le trafic sortant de l'agent Connect sera acheminé via un proxy HTTP(S).

Chaîne encodée en base64.

namespace

string

Facultatif. Espace de noms des ressources de l'agent GKE Connect. La valeur par défaut est gke-connect.

L'agent Connect est automatiquement autorisé lorsqu'il est exécuté dans l'espace de noms par défaut. Sinon, vous devez accorder une autorisation explicite avec une liaison IAM supplémentaire.

ConnectAgentResource

ConnectAgentResource représente un fichier manifeste de ressource Kubernetes pour le déploiement de Connect Agent.

Représentation JSON
{
  "type": {
    object (TypeMeta)
  },
  "manifest": string
}
Champs
type

object (TypeMeta)

Type Kubernetes de la ressource.

manifest

string

Fichier manifeste YAML de la ressource.

TypeMeta

La ressource TypeMeta est l'information de type nécessaire au démarshaling de contenu des ressources Kubernetes dans le fichier manifeste.

Représentation JSON
{
  "kind": string,
  "apiVersion": string
}
Champs
kind

string

Genre de la ressource (par exemple, Deployment).

apiVersion

string

Version d'API de la ressource (par exemple, v1).