Method: projects.locations.memberships.generateConnectManifest

Genera el manifiesto para la implementación del agente de conexión de GKE.

Las bibliotecas proporcionadas por Google usan este método de forma interna. La mayoría de los clientes no deberían necesitar llamar a este método de forma directa.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El nombre del recurso de la membresía con el que se asociará el agente, en el formato projects/*/locations/*/memberships/*.

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • gkehub.memberships.generateConnectManifest

Parámetros de consulta

Parámetros
namespace

string

Opcional. Espacio de nombres para los recursos del agente de GKE Connect. La configuración predeterminada es gke-connect.

El agente de Connect se autoriza automáticamente cuando se ejecuta en el espacio de nombres predeterminado. De lo contrario, se debe otorgar la autorización explícita con una vinculación de IAM adicional.

proxy

string (bytes format)

Opcional. Es el URI de un proxy si la conectividad del agente a gkeconnect.googleapis.com requiere el uso de un proxy. El formato debe tener el formato http(s)://{proxy_address}, según el protocolo HTTP/HTTPS que admita el proxy. Esto dirigirá el tráfico saliente del agente de conexión a través de un proxy HTTP(S).

String codificada en base64.

version

string

Opcional. La versión del agente de Connect que se usará. El valor predeterminado es la versión más reciente.

isUpgrade

boolean

Opcional. Si es verdadero, genera los recursos solo para la actualización. Se excluirán algunos recursos generados solo para la instalación (p. ej., los secretos).

registry

string

Opcional. El registro desde el que se recupera la imagen del agente de conexión. La configuración predeterminada es gcr.io/gkeconnect.

imagePullSecretContent

string (bytes format)

Opcional. La imagen extrae contenido del secreto para el registro, si no es público.

String codificada en base64.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

GenerateConnectManifestResponse contiene información del manifiesto para instalar o actualizar un agente de Connect.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "manifest": [
    {
      object (ConnectAgentResource)
    }
  ]
}
Campos
manifest[]

object (ConnectAgentResource)

La lista ordenada de recursos de Kubernetes que se deben aplicar al clúster para la instalación o actualización del agente de GKE Connect.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ConnectAgentResource

ConnectAgentResource representa un manifiesto de recursos de Kubernetes para la implementación del agente Connect.

Representación JSON
{
  "type": {
    object (TypeMeta)
  },
  "manifest": string
}
Campos
type

object (TypeMeta)

Tipo de Kubernetes del recurso.

manifest

string

Manifiesto YAML del recurso.

TypeMeta

TypeMeta es la información de tipo necesaria para el contenido deserializar los recursos de Kubernetes en el manifiesto.

Representación JSON
{
  "kind": string,
  "apiVersion": string
}
Campos
kind

string

Tipo del recurso (p. ej., implementación)

apiVersion

string

APIVersion del recurso (p. ej., v1).