REST Resource: projects.locations.backends.builds

Recurso: Build

Um único build para um back-end, em um ponto específico da tag de referência da base de código e no tempo. Encapsula vários recursos, incluindo uma imagem de contêiner do Artifact Registry, uma invocação do Cloud Build que criou a imagem e a revisão do Cloud Run que usa essa imagem.

Representação 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. O nome do recurso da compilação.

Formato:

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

string

Opcional. Nome legível por humanos. Limite de 63 caracteres.
state

enum (State)

Apenas saída. O estado do build.
error

object (Status)

Apenas saída. Uma mensagem de status e erro legível por humanos para o build, se estiver em um estado FAILED.
environment

string

Apenas saída. O nome do ambiente do back-end quando essa build foi criada.
config

object (Config)

Opcional. Configuração adicional do serviço.
image

string

Apenas saída. O URI da imagem do contêiner do Artifact Registry, usado pelo revision do Cloud Run para o build.
source

object (BuildSource)

Obrigatório. Imutável. A origem do build.
buildLogsUri

string

Apenas saída. O local dos registros do Cloud Build para o processo de build.
reconciling

boolean

Apenas saída. Um campo que, se for verdadeiro, indica que o build tem uma LRO em andamento.
createTime

string (Timestamp format)

Apenas saída. Horário em que o build foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. Horário em que o build foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Apenas saída. Horário em que o build foi excluído.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opcional. Mapa de chave-valor não estruturado que pode ser usado para organizar e categorizar objetos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcional. Mapa de chave-valor não estruturado que pode ser definido por ferramentas externas para armazenar metadados arbitrários. Elas não podem ser consultadas e precisam ser preservadas ao modificar objetos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Apenas saída. Identificador exclusivo atribuído pelo sistema.
etag

string

Apenas saída. Soma de verificação calculada pelo servidor com base em outros valores. podem ser enviados na atualização ou exclusão para garantir que a operação seja feita no recurso esperado.

Estado

O estado do build.

Enums
STATE_UNSPECIFIED O build está em um estado desconhecido.
BUILDING O build está sendo construído.
BUILT O build foi concluído e está aguardando a próxima etapa. Isso pode mudar para IMPLANTAÇÃO quando o App Hosting começar a configurar a infraestrutura.
DEPLOYING A infraestrutura deste build está sendo configurada.
READY A infraestrutura deste build está pronta. A versão pode ou não estar veiculando tráfego. Consulte Backend.traffic para saber o estado atual ou Backend.traffic_statuses para saber o estado pretendido.
FAILED Falha na criação.

Configuração

Configuração adicional do back-end para este build.

Representação JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
Campos
runConfig

object (RunConfig)

Opcional. Configuração adicional do service do Cloud Run.

RunConfig

Configuração adicional para aplicar ao service do Cloud Run.

Representação JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Campos
cpu

number

Opcional. Número de CPUs usadas para cada instância de exibição.

Por padrão, a CPU usa o padrão do Cloud Run, que é 1.0.

A CPU pode ser definida com o valor de 1, 2, 4, 6 ou 8 CPUs e, para menos de 1 CPU, com um valor de 0,08 a menos de 1,00, em incrementos de 0,01.

Se você definir um valor menor que uma CPU, defina a simultaneidade como 1, e a CPU será alocada somente durante o processamento da solicitação.

Aumentar o limite de CPUs pode exigir um aumento nos limites de memória:

  • 4 CPUs: pelo menos 2 GiB
  • 6 CPUs: pelo menos 4 GiB
  • 8 CPUs: pelo menos 4 GiB
memoryMib

integer

Opcional. Quantidade de memória alocada para cada instância de exibição em MiB.

Por padrão, a memória usa o padrão do Cloud Run, em que cada instância recebe 512 MiB de memória.

A memória pode ser definida como qualquer valor inteiro entre 128 e 32.768.

Aumentar o limite de memória pode exigir um aumento nos limites de CPUs:

  • Acima de 4 GiB: pelo menos 2 CPUs
  • Mais de 8 GiB: pelo menos 4 CPUs
  • Acima de 16 GiB: pelo menos 6 CPUs
  • Mais de 24 GiB: pelo menos 8 CPUs
concurrency

integer

Opcional. Número máximo de solicitações que cada instância do Cloud Run pode receber.

Por padrão, cada instância pode receber o padrão do Cloud Run de até 80 solicitações ao mesmo tempo.

A simultaneidade pode ser definida como qualquer valor inteiro até 1.000.
maxInstances

integer

Opcional. Número de instâncias do Cloud Run a serem mantidas, no máximo, para cada revisão.

Por padrão, cada service do Cloud Run é escalonado horizontalmente de acordo com o padrão do Cloud Run, que é de no máximo 100 instâncias. O limite máximo de maxInstances é baseado na sua cota. Consulte https://cloud.google.com/run/docs/creating/max-instances#limits.
minInstances

integer

Opcional. Número de instâncias do Cloud Run a serem mantidas, no mínimo, para cada serviço do Cloud Run.

Por padrão, não há um valor mínimo.

Mesmo que o serviço divida o tráfego em várias revisões, o número total de instâncias de um serviço será limitado a esse valor.

Origem do build

A origem do build.

Representação 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ão source. A origem de entrada para o build. Normalmente, faz referência a um commit em um repositório de origem. Também pode fazer referência a uma imagem de contêiner. source pode ser apenas de um dos tipos a seguir:
codebase

object (CodebaseSource)

Uma fonte de base de código.
container

object (ContainerSource)

Uma origem da imagem do contêiner do Artifact Registry.

Origem do código

Uma origem da base de código, representando o estado dela em que o build será criado.

Representação 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

Apenas saída. O nome legível a ser usado para essa base de código ao exibir um build. Usamos os oito primeiros caracteres do hash SHA-1 para o GitHub.com.
hash

string

Apenas saída. O hash SHA-1 completo de uma confirmação do Git, se disponível.
commitMessage

string

Apenas saída. A mensagem de uma mudança na base de código.
uri

string

Apenas saída. Um URI que vincula a base de código no site de um provedor de hospedagem. Pode não ser válido se a confirmação tiver sido rebaseada ou removida da existência no repositório vinculado.
author

object (UserMetadata)

Apenas saída. O autor contido nos metadados de uma alteração no controle de versão.
commitTime

string (Timestamp format)

Apenas saída. A hora em que a alteração foi feita.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Campo de união reference.

reference pode ser apenas de um dos tipos a seguir:
branch

string

A ramificação na base de código a partir da qual criar, usando a confirmação mais recente.
commit

string

A confirmação na base de código de base do build.

UserMetadata

Metadados de controle de versão para um usuário associado a uma base de código resolvida. Atualmente pressupõe um usuário do Git.

Representação JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Campos
displayName

string

Apenas saída. O "nome" no git.config de um usuário do Git. Exigido pelo Git.
email

string

Apenas saída. O "e-mail" no git.config de um usuário do Git, se disponível.
imageUri

string

Apenas saída. O URI de um arquivo de imagem associado à conta do usuário em um provedor de controle de origem externo, se disponível.

Origem do contêiner

O URI de uma imagem de contêiner do Artifact Registry para usar como origem do build.

Representação JSON 
{
  "image": string
}
Campos
image

string

Obrigatório. Um URI que representa um contêiner para o back-end usar.

Métodos

create

 Cria uma nova compilação para um back-end.

delete

 Exclui um único build.

get

 Recebe informações sobre uma versão.

list

 Lista as versões em um determinado projeto, local e back-end.