REST Resource: projects.locations.backends.builds

Recurso: Build

Una sola compilación para un backend, en una etiqueta de referencia de base de código de punto específico y en un momento determinado. Encapsula varios recursos, incluida una imagen de contenedor de Artifact Registry, una invocación de Cloud Build que compiló la imagen y la revisión de Cloud Run que usa esa imagen.

Representación JSON 
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "error": {
    object (Status)
  },
  "environment": string,
  "config": {
    object (Config)
  },
  "image": string,
  "source": {
    object (BuildSource)
  },
  "buildLogsUri": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
Campos
name

string

Identificador. El nombre del recurso de la compilación.

Formato:

projects/{project}/locations/{locationId}/backends/{backendId}/builds/{buildId}.
displayName

string

Opcional. Nombre legible por humanos. Límite de 63 caracteres.
state

enum (State)

Solo salida. El estado de la compilación.
error

object (Status)

Solo salida. Un mensaje de estado y de error (legible) de la compilación, si tiene el estado FAILED
environment

string

Solo salida. El nombre del entorno del backend cuando se creó esta compilación.
config

object (Config)

Opcional. Configuración adicional del servicio.
image

string

Solo salida. El URI de la imagen de contenedor de Artifact Registry, que usa Cloud Run revision para esta compilación.
source

object (BuildSource)

Obligatorio. Inmutable. Es la fuente de la compilación.
buildLogsUri

string

Solo salida. La ubicación de los registros de Cloud Build para el proceso de compilación.
reconciling

boolean

Solo salida. Un campo que, si es verdadero, indica que la compilación tiene una LRO en curso.
createTime

string (Timestamp format)

Solo salida. Hora en la que se creó la compilación.

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 en la que se actualizó la compilación por última vez.

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

string (Timestamp format)

Solo salida. Hora en la que se borró la compilación.

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

map (key: string, value: string)

Opcional. Mapa de clave-valor no estructurado que se puede usar para organizar y categorizar objetos.

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

map (key: string, value: string)

Opcional. Mapa clave-valor no estructurado que puede establecerse por herramientas externas para almacenar metadatos arbitrarios. No se pueden consultar y deben conservarse cuando se modifican objetos.

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

string

Solo salida. Es un identificador único asignado por el sistema.
etag

string

Solo salida. Suma de verificación procesada por el servidor basada en otros valores se puede enviar cuando se actualice o borre para garantizar que la operación se realice en el recurso esperado.

Estado

El estado de la compilación.

Enums
STATE_UNSPECIFIED La compilación se encuentra en un estado desconocido.
BUILDING La compilación se está construyendo.
BUILT Se completó la compilación y está esperando el siguiente paso. Es posible que esta opción pase a IMPLEMENTACIÓN una vez que App Hosting comience a configurar la infraestructura.
DEPLOYING Se está configurando la infraestructura para esta compilación.
READY La infraestructura para esta compilación está lista. La compilación puede o no entregar tráfico. Consulta Backend.traffic para el estado actual o Backend.traffic_statuses para el estado deseado.
FAILED No se pudo completar la compilación.

Configuración

Configuración adicional del backend para esta compilación.

Representación JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
Campos
runConfig

object (RunConfig)

Opcional. Configuración adicional de service de Cloud Run.

RunConfig

Configuración adicional para aplicar a Cloud Run service.

Representación JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Campos
cpu

number

Opcional. Cantidad de CPU usadas para cada instancia de entrega.

De forma predeterminada, la CPU tiene la configuración predeterminada de 1.0 en Cloud Run.

La CPU se puede configurar en los valores 1, 2, 4, 6 u 8 y, para menos de 1 CPU, un valor de 0.08 a menos de 1.00, en incrementos de 0.01.

Si configuras un valor inferior a 1 CPU, debes establecer la simultaneidad en 1, y la CPU solo se asignará durante el procesamiento de la solicitud.

El aumento del límite de CPU puede requerir un aumento en los límites de memoria:

  • 4 CPU: al menos 2 GiB
  • 6 CPU: al menos 4 GiB
  • 8 CPU: al menos 4 GiB
memoryMib

integer

Opcional. Cantidad de memoria asignada por cada instancia de entrega en MiB.

De forma predeterminada, la memoria se establece de forma predeterminada en la configuración predeterminada de Cloud Run, en la que a cada instancia se le asignan 512 MiB de memoria.

La memoria se puede establecer en cualquier valor entero entre 128 y 32,768.

El aumento del límite de memoria puede requerir un aumento en los límites de CPU:

  • Más de 4 GiB: Al menos 2 CPU
  • Más de 8 GiB: Al menos 4 CPU
  • Más de 16 GiB: Al menos 6 CPU
  • Más de 24 GiB: Al menos 8 CPU
concurrency

integer

Opcional. Cantidad máxima de solicitudes que puede recibir cada instancia de Cloud Run.

De forma predeterminada, cada instancia puede recibir hasta 80 solicitudes al mismo tiempo de Cloud Run.

La simultaneidad se puede configurar en cualquier valor de número entero hasta 1,000.
maxInstances

integer

Opcional. Cantidad de instancias de Cloud Run que se deben mantener como máximo para cada revisión.

De forma predeterminada, cada service de Cloud Run escala horizontalmente según la configuración predeterminada de Cloud Run de un máximo de 100 instancias. El límite máximo de maxInstances se basa en tu cuota. Consulta https://cloud.google.com/run/docs/configuration/max-instances#limits.
minInstances

integer

Opcional. Cantidad de instancias de Cloud Run que se deben mantener como mínimo para cada Servicio de Cloud Run.

De forma predeterminada, no hay un mínimo.

Incluso si el servicio divide el tráfico en varias revisiones, el número total de instancias de un servicio se limitará a este valor.

Fuente de compilación

Es la fuente de la compilación.

Representación JSON 
{

  // Union field source can be only one of the following:
  "codebase": {
    object (CodebaseSource)
  },
  "container": {
    object (ContainerSource)
  }
  // End of list of possible types for union field source.
}
Campos
Campo de unión source. La fuente de entrada para la compilación. Por lo general, harán referencia a una confirmación en un repositorio de código fuente. También puede hacer referencia a una imagen de contenedor. source puede ser solo uno de los siguientes:
codebase

object (CodebaseSource)

Una fuente de base de código
container

object (ContainerSource)

Una fuente de imagen de contenedor de Artifact Registry.

CódigobaseSource

Es una fuente de base de código que representa el estado de la base de código en la que se creará la compilación.

Representación JSON 
{
  "displayName": string,
  "hash": string,
  "commitMessage": string,
  "uri": string,
  "author": {
    object (UserMetadata)
  },
  "commitTime": string,

  // Union field reference can be only one of the following:
  "branch": string,
  "commit": string
  // End of list of possible types for union field reference.
}
Campos
displayName

string

Solo salida. El nombre sencillo que se debe usar para esta base de código cuando se muestra una compilación. Usamos los primeros ocho caracteres del hash SHA-1 para GitHub.com.
hash

string

Solo salida. El hash SHA-1 completo de una confirmación de Git, si está disponible
commitMessage

string

Solo salida. Es el mensaje de un cambio en la base de código.
uri

string

Solo salida. Es un URI que vincula a la base de código en el sitio web de un proveedor de hosting. Puede no ser válida si la confirmación se volvió a basar o si se quitó de manera forzada la existencia en el repositorio vinculado.
author

object (UserMetadata)

Solo salida. El autor incluido en los metadatos de un cambio de control de versión.
commitTime

string (Timestamp format)

Solo salida. Hora en la que se realizó el cambio.

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

Campo de unión reference.

reference puede ser una de las siguientes opciones:
branch

string

Rama de la base de código a partir de la cual compilar, con la confirmación más reciente.
commit

string

La confirmación en la base de código a partir de la cual se compilará.

UserMetadata

Metadatos del control de versión para un usuario asociado con una base de código resuelta. Actualmente, asume un usuario de Git.

Representación JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Campos
displayName

string

Solo salida. El 'nombre' en el git.config de un usuario de Git. Obligatorio para Git.
email

string

Solo salida. El "correo electrónico" en el git.config de un usuario de Git, si está disponible.
imageUri

string

Solo salida. Es el URI de un archivo de imagen asociado a la cuenta del usuario en un proveedor de control de fuente externo, si está disponible.

ContainerSource

El URI de una imagen de contenedor de Artifact Registry para usar como fuente de compilación.

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

string

Obligatorio. Un URI que representa un contenedor para que use el backend.

Métodos

create

 Crea una compilación nueva para un backend.

delete

 Borra una sola compilación.

get

 Obtiene información sobre una compilación.

list

 Muestra una lista de las compilaciones en un proyecto, una ubicación y un backend determinados.