REST Resource: projects.locations.targets

Recurso: Destino

Un recurso Target en la API de Cloud Deploy.

Un objeto Target define una ubicación en la que se puede implementar una configuración de Skaffold.

Representación JSON 
{
  "name": string,
  "targetId": string,
  "uid": string,
  "description": string,
  "annotations": {
    string: string,
    ...
  },
  "labels": {
    string: string,
    ...
  },
  "requireApproval": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "executionConfigs": [
    {
      object (ExecutionConfig)
    }
  ],
  "deployParameters": {
    string: string,
    ...
  },

  // Union field deployment_target can be only one of the following:
  "gke": {
    object (GkeCluster)
  },
  "anthosCluster": {
    object (AnthosCluster)
  },
  "run": {
    object (CloudRunLocation)
  },
  "multiTarget": {
    object (MultiTarget)
  },
  "customTarget": {
    object (CustomTarget)
  }
  // End of list of possible types for union field deployment_target.
}
Campos
name

string

Opcional. Es el nombre de Target. El formato es projects/{project}/locations/{location}/targets/{target}. El componente target debe coincidir con [a-z]([a-z0-9-]{0,61}[a-z0-9])?
targetId

string

Solo salida. Es el ID de recurso de Target.
uid

string

Solo salida. Es el identificador único de Target.
description

string

Opcional. Descripción de Target. La longitud máxima es de 255 caracteres.
annotations

map (key: string, value: string)

Opcional. Anotaciones de usuario Solo el usuario puede configurar y usar estos atributos, no Cloud Deploy. Consulta https://google.aip.dev/128#annotations para obtener más detalles, como las limitaciones de formato y tamaño.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
labels

map (key: string, value: string)

Opcional. Las etiquetas son atributos que el usuario y Cloud Deploy pueden configurar y usar. Las etiquetas deben cumplir con las siguientes restricciones:

  • Las claves y los valores solo pueden contener letras minúsculas, números, guiones bajos y guiones.
  • Todos los caracteres deben usar la codificación UTF-8 y se permiten los caracteres internacionales.
  • Las claves deben comenzar con una letra en minúscula o un carácter internacional.
  • Cada recurso está limitado a un máximo de 64 etiquetas.

Las claves y los valores también tienen el límite de 128 bytes o menos.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
requireApproval

boolean

Opcional. Indica si Target requiere aprobación o no.
createTime

string (Timestamp format)

Solo salida. Hora en la que se creó el Target.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo salida. Hora más reciente a la que se actualizó el Target.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
etag

string

Opcional. El servidor calcula esta suma de verificación según el valor de otros campos, y puede enviarse en las solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar.
executionConfigs[]

object (ExecutionConfig)

Configuraciones para todas las ejecuciones relacionadas con este Target. Cada valor de ExecutionEnvironmentUsage solo se puede usar en una configuración. Usar el mismo valor varias veces es un error. Cuando se especifican una o más configuraciones, deben incluir los valores ExecutionEnvironmentUsage de RENDER y DEPLOY. Cuando no se especifiquen parámetros de configuración, la ejecución usará el predeterminado que se especifica en DefaultPool.
deployParameters

map (key: string, value: string)

Opcional. Los parámetros de implementación que se usarán para este destino

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Campo de unión deployment_target. Destino al que se aplica la configuración de Skaffold durante un lanzamiento. deployment_target puede ser solo uno de los siguientes:
gke

object (GkeCluster)

Opcional. Información que especifica un clúster de GKE.
anthosCluster

object (AnthosCluster)

Opcional. Información que especifica un clúster de Anthos.
run

object (CloudRunLocation)

Opcional. Información que especifica un destino de implementación de Cloud Run.
multiTarget

object (MultiTarget)

Opcional. Información que especifica un multiTarget.
customTarget

object (CustomTarget)

Opcional. Información que especifica un destino personalizado.

GkeCluster

Información que especifica un clúster de GKE.

Representación JSON 
{
  "cluster": string,
  "internalIp": boolean
}
Campos
cluster

string

Opcional. Información que especifica un clúster de GKE. El formato es projects/{projectId}/locations/{locationId}/clusters/{cluster_id}.
internalIp

boolean

Opcional. Si es verdadero, se accede a cluster mediante la dirección IP privada del extremo del plano de control. De lo contrario, se usa la dirección IP predeterminada del extremo del plano de control. La dirección IP predeterminada es la dirección IP privada de los clústeres con extremos del plano de control privado y, de lo contrario, la dirección IP pública.

Solo especifica esta opción cuando cluster sea un clúster de GKE privado.

AnthosCluster

Información que especifica un clúster de Anthos.

Representación JSON 
{
  "membership": string
}
Campos
membership

string

Opcional. Membresía del clúster registrado en GKE Hub al que se aplica la configuración de Skaffold. El formato es projects/{project}/locations/{location}/memberships/{membership_name}.

CloudRunLocation

Información que especifica dónde implementar un servicio de Cloud Run.

Representación JSON 
{
  "location": string
}
Campos
location

string

Obligatorio. La ubicación del servicio de Cloud Run. El formato debe ser projects/{project}/locations/{location}.

MultiTarget

Información que especifica un multiTarget.

Representación JSON 
{
  "targetIds": [
    string
  ]
}
Campos
targetIds[]

string

Obligatorio. Los targetIds de este multiTarget.

CustomTarget

Información que especifica un destino personalizado.

Representación JSON 
{
  "customTargetType": string
}
Campos
customTargetType

string

Obligatorio. Es el nombre del CustomTargetType. El formato debe ser projects/{project}/locations/{location}/customTargetTypes/{customTargetType}.

ExecutionConfig

Configuración del entorno que se usará cuando se llame a Skaffold.

Representación JSON 
{
  "usages": [
    enum (ExecutionEnvironmentUsage)
  ],
  "workerPool": string,
  "serviceAccount": string,
  "artifactStorage": string,
  "executionTimeout": string,
  "verbose": boolean,

  // Union field execution_environment can be only one of the following:
  "defaultPool": {
    object (DefaultPool)
  },
  "privatePool": {
    object (PrivatePool)
  }
  // End of list of possible types for union field execution_environment.
}
Campos
usages[]

enum (ExecutionEnvironmentUsage)

Obligatorio. Usos en los que se debe aplicar esta configuración.
workerPool

string

Opcional. El nombre del recurso de WorkerPool, con el formato projects/{project}/locations/{location}/workerPools/{workerPool}. Si no se especifica este campo opcional, se usará el grupo predeterminado de Cloud Build.
serviceAccount

string

Opcional. Cuenta de servicio de Google que se usará para la ejecución. Si no se especifica, se usa la cuenta de servicio de ejecución del proyecto (-compute@developer.gserviceaccount.com).
artifactStorage

string

Opcional. Ubicación de Cloud Storage en la que se almacenan los resultados de la ejecución. Puede ser un bucket (“gs://my-bucket”) o una ruta dentro de un bucket (“gs://my-bucket/my-dir”). Si no se especifica, se usará un bucket predeterminado ubicado en la misma región.
executionTimeout

string (Duration format)

Opcional. Tiempo de espera de ejecución para una ejecución de Cloud Build. Debe estar entre 10 min y 24 h en formato de segundos. Si no se especifica, se usa el tiempo de espera predeterminado de 1 h.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
verbose

boolean

Opcional. Si es verdadero, se habilitarán registros adicionales para las ejecuciones de Cloud Build que se ejecutan en este entorno de ejecución.
Campo de unión execution_environment. Detalles del entorno execution_environment puede ser solo uno de los siguientes:
defaultPool

object (DefaultPool)

Opcional. Usa el grupo predeterminado de Cloud Build.
privatePool

object (PrivatePool)

Opcional. Usa el grupo privado de Cloud Build.

ExecutionEnvironmentUsage

Posibles usos de esta configuración.

Enums
EXECUTION_ENVIRONMENT_USAGE_UNSPECIFIED Valor predeterminado Este valor no se usa.
RENDER Se usa para la renderización.
DEPLOY Se usa para implementar hooks de implementación.
VERIFY Se usa para verificar la implementación.
PREDEPLOY Se usa para la ejecución de trabajos de implementación previa.
POSTDEPLOY Se usa para la ejecución de trabajos posteriores a la implementación.

DefaultPool

Ejecución con el grupo predeterminado de Cloud Build.

Representación JSON 
{
  "serviceAccount": string,
  "artifactStorage": string
}
Campos
serviceAccount

string

Opcional. Cuenta de servicio de Google que se usará para la ejecución. Si no se especifica, se usará la cuenta de servicio de ejecución del proyecto (-compute@developer.gserviceaccount.com).
artifactStorage

string

Opcional. Ubicación de Cloud Storage donde se deben almacenar los resultados de la ejecución. Puede ser un bucket (“gs://my-bucket”) o una ruta dentro de un bucket (“gs://my-bucket/my-dir”). Si no se especifica, se usará un bucket predeterminado ubicado en la misma región.

PrivatePool

Ejecución mediante un grupo privado de Cloud Build.

Representación JSON 
{
  "workerPool": string,
  "serviceAccount": string,
  "artifactStorage": string
}
Campos
workerPool

string

Obligatorio. Nombre del recurso del grupo de trabajadores de Cloud Build que se usará. El formato es projects/{project}/locations/{location}/workerPools/{pool}.
serviceAccount

string

Opcional. Cuenta de servicio de Google que se usará para la ejecución. Si no se especifica, se usará la cuenta de servicio de ejecución del proyecto (-compute@developer.gserviceaccount.com).
artifactStorage

string

Opcional. Ubicación de Cloud Storage donde se deben almacenar los resultados de la ejecución. Puede ser un bucket (“gs://my-bucket”) o una ruta dentro de un bucket (“gs://my-bucket/my-dir”). Si no se especifica, se usará un bucket predeterminado ubicado en la misma región.

Métodos

create

 Crea un destino nuevo en un proyecto y una ubicación determinados.

delete

 Borra un solo destino.

get

 Obtiene detalles de un solo destino.

getIamPolicy

 Permite obtener la política de control de acceso de un recurso.

list

 Muestra una lista de objetivos en un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de un solo destino.

setIamPolicy

 Permite configurar la política de control de acceso en el recurso especificado.

testIamPermissions

 Permite mostrar los permisos que tiene un emisor para un recurso específico.