Tipo de build: build do Cloud Build v1

Nesta página, explicamos o Tipo de build do Cloud Build.

Definição do build

Parâmetros externos

A tabela a seguir exibe os tipos de parâmetros externos que podem ser usados em um build do Cloud Build. Parâmetros externos são valores que você especifica e não estão presentes na configuração do build. Isso inclui parâmetros do acionador que não estão no arquivo cloudbuild.yaml.

Campo	Tipo	Detalhes
buildConfigSource	objeto	Local em que a configuração do build foi lida. Em `BuildTrigger`, isso corresponde ao repositório de origem que acionou o build (build acionado por evento do SCM) ou `gitFileSource` para todos os outros tipos de gatilho. `buildConfigSource` OU `buildConfig` (no caso de configuração de build inline) vai ser definido.
buildConfigSource.ref	string	Referência do Git em `buildConfigSource.repository` a partir da qual a configuração foi lida, como uma referência git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal minúsculas). Um SHA de confirmação será usado apenas se especificado no acionador.
buildConfigSource.repository	string	URI HTTPS do repositório git que contém o arquivo de configuração da versão, com o protocolo `https://`. Ela será prefixada com um `git+` para compatibilidade com o formato SPDX. Para mais informações sobre os requisitos de formato, consulte ResourceURI.
buildConfigSource.path	string	Caminho para o arquivo de configuração do build na confirmação. Exemplo: `cloudbuild.yaml` Mutuamente exclusivo com pathAutodetect. Exatamente um desses campos precisa ser definido como um valor não padrão.
buildConfigSource.pathAutoDetect	boolean	Se verdadeiro, `path` foi detectado automaticamente, correspondendo à opção de detecção automática em `BuildTrigger`. "False" é considerado equivalente a não definido. O Cloud Build usa `path` se a detecção automática não tiver sido ativada. Mutuamente exclusivo com `path`. Exatamente um desses campos PRECISA ser definido como um valor não padrão.
sourceToBuild	objeto	Código-fonte que foi verificado e criado. Normalmente, é o mesmo que `buildConfigSource`. Só difere se o BuildTrigger tiver `gitFileSource` definido. Esse campo não vai existir se `repository` e `ref` forem iguais a `buildConfigSource` e o `dir` estiver vazio. No BuildTrigger, isso corresponde a `sourceToBuild` ou à confirmação que acionou o build, dependendo do tipo de acionador.
sourceToBuild.ref	string	Referência do Git em `sourceToBuild.repository` que foi verificada, como uma referência git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal minúsculas). Um SHA de confirmação é usado apenas se especificado no acionador.
sourceToBuild.repository	string	URI HTTPS do repositório git que foi verificado, com protocolo `https://`. Ela será prefixada com um `git+`.
sourceToBuild.dir	string	Diretório na confirmação em que será executada a versão, sem uma barra no final. Pode ficar em branco, sem definição.
buildConfig	string	Quando uma configuração de versão inline é fornecida, por exemplo, em um build enviado manualmente, as informações a seguir são registradas. - etapas - opções de build (por exemplo, variáveis de ambiente, volumes, detalhes do pool de workers, tipo de máquina, detalhes de registro) - substituições Se a configuração de build tiver sido lida de um repositório, ela vai ser gravada na seção `buildConfigSource`, e a configuração de build inline será omitida. Essas informações são armazenadas como uma string JSON serializada codificada em base64.
substitutions	mapa<string,string></string,string>	Mapa de (string -> string) contendo as substituições a serem realizadas no recurso Build. Contém apenas substituições de "ambiente de execução" ou "independente" que não são registradas na configuração do build, ou seja, transmitidas de um gatilho ou de uma sinalização da CLI gcloud. Esse registro não inclui as substituições padrão fornecidas pelo sistema, porque elas são consideradas `internalParameters`. As substituições aparecem nesse campo independentemente de serem referenciadas ou usadas na configuração da versão.

Parâmetros internos

A tabela a seguir exibe os parâmetros internos que o Cloud Build define para o build, a menos que você os substitua. Para mais informações, consulte substituições padrão.

Campo	Detalhes
triggerUri	URI do recurso do acionador que invocou esse build. Neste caso, o nome completo do recurso. Se o build não foi acionado, ele é omitido.
systemSubstitutions	Há um subconjunto de valores de substituição padrão que são fornecidos automaticamente nas versões do Cloud Build, como `PROJECT_ID` e `BUILD_ID`. Se você substituir uma das substituições padrão do Cloud Build, suas substituições não serão exibidas aqui. Em vez disso, seus valores serão listados em `externalParameters.substitutions`.

Dependências resolvidas

Se o build tiver um repositório de origem ou de configuração do build, o repositório será descrito na seção resolvedDependencies do BuildDefinition.

ResolvedDependencies estão em conformidade com a especificação ResourceDescriptor.

Tipo de dependência	Detalhes
Repositório de configuração da versão	O repositório de onde a configuração do build (ou seja, o `cloudbuild.yaml`) foi extraída, no caso de builds acionados. Pode ficar vazio no caso de uma configuração de build que não foi lida de um repositório e é fornecida inline. Nesse caso, ela será omitida.
Repositório de origem	O repositório de onde o código-fonte para criação foi extraído. Pode ser igual a `buildConfigSource` ou diferente. Se for o mesmo que `buildConfigSource`, o `sourceToBuild` será omitido, por exemplo, em builds acionados pelo SCM. O `sourceToBuild` poderá estar vazio se o build for executado por `–no-source` e será omitido.

Por exemplo, as informações de resolvedDependencies a seguir contêm um buildConfigRepo e sourceRepo (que são iguais) e uma imagem de etapa de build.

"resolvedDependencies": [
{
    "uri": "git+https://github.com/octocat/hello-world.git",
    "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"}
}, {
    "uri": "gcr.io/cloud-builders/git",
    "digest": {
        "sha256": "28ff94e63e4058afc3f15b4c11c08cf3b54fa91faa646a4bba7158df"}
    }
]

RunDetails

Campo	Detalhes
builder	Contém um subcampo `id` que identifica a plataforma de build que executou a operação e preencheu essa procedência. Também contém o nível SLSA. O valor de `id` esperado é `https://cloudbuild.googleapis.com/GoogleHostedWorker`.
metadados	Outros metadados sobre essa execução específica do build. O `invocationId` exibe o URL do build, como `https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/builds/BUILD_ID`. Os campos `startedOn` e `finishedOn` contêm os carimbos de data/hora de quando o build foi iniciado e concluído.
subprodutos	Ainda não está em uso. Projetado para conter outros artefatos que não são considerados a saída do build, mas podem ser úteis para solução de problemas ou resposta a incidentes.
systemSubstitutions	Há um subconjunto de valores de substituição padrão que são fornecidos automaticamente nas versões do Cloud Build, como `PROJECT_ID` e `BUILD_ID`. Se você substituir uma das substituições padrão do Cloud Build, suas substituições não serão exibidas aqui. Em vez disso, seus valores serão listados em `externalParameters.substitutions`.