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 ( |
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la compilación. Formato:
|
displayName |
Opcional. Nombre legible por humanos. Límite de 63 caracteres. |
state |
Solo salida. El estado de la compilación. |
error |
Solo salida. Un mensaje de estado y de error (legible) de la compilación, si tiene el estado |
environment |
Solo salida. El nombre del entorno del backend cuando se creó esta compilación. |
config |
Opcional. Configuración adicional del servicio. |
image |
Solo salida. El URI de la imagen de contenedor de Artifact Registry, que usa Cloud Run |
source |
Obligatorio. Inmutable. Es la fuente de la compilación. |
buildLogsUri |
Solo salida. La ubicación de los registros de Cloud Build para el proceso de compilación. |
reconciling |
Solo salida. Un campo que, si es verdadero, indica que la compilación tiene una LRO en curso. |
createTime |
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: |
updateTime |
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: |
deleteTime |
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: |
labels |
Opcional. Mapa de clave-valor no estructurado que se puede usar para organizar y categorizar objetos. Un objeto que contiene una lista de pares |
annotations |
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 |
uid |
Solo salida. Es un identificador único asignado por el sistema. |
etag |
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
Configuración adicional para aplicar a Cloud Run service
.
Representación JSON |
---|
{ "cpu": number, "memoryMib": integer, "concurrency": integer, "maxInstances": integer, "minInstances": integer } |
Campos | |
---|---|
cpu |
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:
|
memoryMib |
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:
|
concurrency |
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 |
Opcional. Cantidad de instancias de Cloud Run que se deben mantener como máximo para cada revisión. De forma predeterminada, cada |
minInstances |
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 |
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 |
Una fuente de base de código |
container |
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 ( |
Campos | |
---|---|
displayName |
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 |
Solo salida. El hash SHA-1 completo de una confirmación de Git, si está disponible |
commitMessage |
Solo salida. Es el mensaje de un cambio en la base de código. |
uri |
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 |
Solo salida. El autor incluido en los metadatos de un cambio de control de versión. |
commitTime |
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: |
Campo de unión
|
|
branch |
Rama de la base de código a partir de la cual compilar, con la confirmación más reciente. |
commit |
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 |
Solo salida. El 'nombre' en el git.config de un usuario de Git. Obligatorio para Git. |
email |
Solo salida. El "correo electrónico" en el git.config de un usuario de Git, si está disponible. |
imageUri |
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 |
Obligatorio. Un URI que representa un contenedor para que use el backend. |