Esta página foi traduzida pela API Cloud Translation.

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 mostra os tipos de parâmetros externos que podem ser usados em um build do Cloud Build. Os parâmetros externos são valores que você especifica e não estão presentes na configuração do build. Isso inclui parâmetros de gatilho que não estão no arquivo cloudbuild.yaml.

Campo	Tipo	Detalhes
buildConfigSource	objeto	Local de onde a configuração do build foi lida. Em `BuildTrigger`, isso corresponde ao repositório de origem que acionou o build (builds acionados por evento do SCM) ou `gitFileSource` para todos os outros tipos de acionador. `buildConfigSource` OU `buildConfig` (no caso da configuração de build inline) serão definidos.
buildConfigSource.ref	string	Referência do Git em `buildConfigSource.repository` de onde a configuração foi lida, como uma referência do Git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal em letras minúsculas). Um SHA de confirmação é usado apenas se especificado no acionador.
buildConfigSource.repository	string	URI HTTPS do repositório do git que contém o arquivo de configuração do build, com protocolo `https://`. Ele terá o prefixo `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 no commit. Exemplo: `cloudbuild.yaml` É mutuamente exclusivo com pathAutodetect. Exatamente um desses campos precisa ser definido como um valor não padrão.
buildConfigSource.pathAutoDetect	booleano	Se verdadeiro, `path` foi detectado automaticamente, correspondendo à opção de detecção automática no `BuildTrigger`. O valor "false" é considerado equivalente a "not set". O Cloud Build usa `path` se o autodetecção não estiver ativado. Mutuamente exclusivo com `path`. Exatamente um desses campos PRECISA ser definido como um valor diferente do padrão.
sourceToBuild	objeto	Código-fonte que foi verificado e compilado. Normalmente, isso é igual a `buildConfigSource`. A diferença é apenas se o BuildTrigger tiver `gitFileSource` definido. Este campo não existe se `repository` e `ref` forem iguais a `buildConfigSource` e `dir` estiver vazio. No BuildTrigger, isso corresponde a `sourceToBuild` ou ao commit que acionou o build, dependendo do tipo de gatilho.
sourceToBuild.ref	string	Referência do Git em `sourceToBuild.repository` que foi retirada, como uma referência do Git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal em letras 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://`. Ele vai ter o prefixo `git+`.
sourceToBuild.dir	string	Diretório no commit em que o build será executado, sem uma barra no final. Pode ficar em branco, não definido.
buildConfig	string	Quando uma configuração de build inline é fornecida, como em um build enviado manualmente, as seguintes informações são registradas. - etapas - opções de build (por exemplo, variáveis de ambiente, volumes, detalhes do pool de workers, machineType, detalhes do registro) - substituições Se a configuração do build foi lida de um repositório, ela é gravada na seção `buildConfigSource` e a configuração do build inline é omitida. Essas informações são armazenadas como uma string JSON serializada codificada em base64.
substitutions	map<string,string></string,string>	Mapa de (string -> string) contendo as substituições a serem realizadas no recurso de build. Ele contém apenas substituições "runtime" ou "independent" que não são registradas na configuração do build, ou seja, transmitidas de um gatilho ou sinalizações da CLI do gcloud. Este registro não inclui as substituições padrão fornecidas pelo sistema, porque elas são consideradas `internalParameters`. As substituições aparecem neste campo, independentemente de serem referenciadas ou usadas na configuração do build.

Parâmetros internos

A tabela a seguir mostra 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 tiver sido acionado, isso será omitido.
systemSubstitutions	Há um subconjunto de valores de substituição padrão que são fornecidos automaticamente nos builds do Cloud Build, como `PROJECT_ID` e `BUILD_ID`. Se você substituir uma das substituições padrão do Cloud Build, elas não serão mostradas aqui. 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, ele será descrito na seção resolvedDependencies do BuildDefinition.

ResolvedDependencies em conformidade com a especificação ResourceDescriptor.

Tipo de dependência	Detalhes
Criar repositório de configuração	O repositório de onde a configuração do build (ou seja, o `cloudbuild.yaml`) foi extraida, no caso de builds acionados. Pode estar vazio no caso de uma configuração de build que não foi lida de um repositório e foi fornecida inline. Nesse caso, ela será omitida.
Repositório de origem	O repositório de onde o código-fonte do build 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` pode estar vazio se o build for executado pelo `–no-source` e será omitido.

Por exemplo, as informações resolvedDependencies a seguir contêm um buildConfigRepo e um 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 origem. Ele também contém o nível SLSA. O valor esperado de `id` é `https://cloudbuild.googleapis.com/GoogleHostedWorker`.
metadados	Metadados adicionais sobre essa execução específica do build. O `invocationId` mostra 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 artefatos adicionais 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 nos builds do Cloud Build, como `PROJECT_ID` e `BUILD_ID`. Se você substituir uma das substituições padrão do Cloud Build, elas não serão mostradas aqui. Seus valores serão listados em `externalParameters.substitutions`.