Esta página foi traduzida pela API Cloud Translation.

Tipo de build: 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. Os parâmetros externos são valores que você especifica e que não estão presentes na configuração do build. Isso inclui gatilho parâmetros que não estão no seu arquivo cloudbuild.yaml.

Campo	Tipo	Detalhes
buildConfigSource	objeto	Local de onde a configuração do build foi lida. Em `BuildTrigger`, corresponde ao repositório de origem que acionou a compilação (compilações acionadas por eventos do SCM) ou `gitFileSource` para todos os outros tipos de gatilhos. `buildConfigSource` OU `buildConfig` (em caso da configuração da versão in-line) será definido.
buildConfigSource.ref	string	Referência do Git em `buildConfigSource.repository` de que a configuração foi lida, como uma referência de git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal minúsculo). 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://`. Será prefixado com um `git+` para compatibilidade com o SPDX . Para mais informações sobre os requisitos de formato, consulte ResourceURI associado.
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 ao opção de detecção automática em `BuildTrigger`. É considerado "falso" equivalente a "not set" O Cloud Build usa `path` se a detecção automática não estiver ativada. Mutuamente exclusivo com `path`. Exatamente um destes campos PRECISAM ser definidos com um valor não padrão.
sourceToBuild	objeto	Código-fonte que foi verificado e criado. Normalmente, é o mesmo como `buildConfigSource`; ela só será diferente se O BuildTrigger tinha `gitFileSource` definido. Este campo não existe se `repository` e `ref` forem iguais a `buildConfigSource` e `dir` estiver vazio. Em BuildTrigger, isso corresponde a `sourceToBuild` ou a confirmação que acionou o build, de acordo com o tipo de gatilho.
sourceToBuild.ref	string	Referência do Git no `sourceToBuild.repository` que foi concluído, como uma referência de git totalmente qualificada (começando com `refs/`) ou um SHA de confirmação (hexadecimal minúsculo). 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://`. O prefixo será `git+`.
sourceToBuild.dir	string	Diretório dentro da confirmação em que a versão será executada, sem uma barra final. Pode ficar vazio, 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, worker detalhes do pool, tipo de máquina, detalhes do registro) - substituições Se a configuração do build foi lida de um repositório, ela é registrada. na seção `buildConfigSource` e no build in-line config é omitido. Essas informações são armazenadas como uma string JSON serializada codificada em base64.
substitutions	map<string,string></string,string>	Mapa de (string -> string) com as substituições a serem realizadas o 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. Esse registro não inclui as substituições padrão fornecidas pelo sistema, já que elas são é considerado `internalParameters`. As substituições aparecem nesse campo independentemente de serem referenciadas ou usados na configuração do build.

Parâmetros internos

A tabela a seguir mostra os parâmetros internos que o Cloud Build para o build, a menos que sejam substituídos. Para mais informações, consulte substituições padrão.

Campo	Detalhes
triggerUri	URI de recurso do gatilho que invocou esta compilação. 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 nos builds do Cloud Build, como `PROJECT_ID` e `BUILD_ID`. Se você substituir uma das substituições padrão do Cloud Build, seu substituições não serão exibidas 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 de build, o repositório é descrito na resolvedDependencies do BuildDefinition.

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

Tipo de dependência	Detalhes
Repositório de configuração do build	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 versão que não foi lido de um repositório e é fornecido in-line. Nesse caso, será omitido.
Repositório de origem	O repositório de que foi extraído o código-fonte a ser criado. Pode ser o mesmo que `buildConfigSource` ou diferente. Se for o mesmo que `buildConfigSource`, o `sourceToBuild` será omitido, por exemplo, em builds acionados pelo SCM. O `sourceToBuild` pode ficar vazio se o build for executado por meio de `–no-source` e serão omitidas.

Por exemplo, as informações de resolvedDependencies a seguir contêm uma buildConfigRepo e sourceRepo (que são os mesmos) 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 de SLSA. O valor esperado de `id` é `https://cloudbuild.googleapis.com/GoogleHostedWorker`.
metadados	Metadados adicionais 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` os carimbos de data/hora de quando a compilação foi iniciada e concluída.
subprodutos	Ainda não está em uso. Criado para conter artefatos que não são considerados a saída do build, mas que podem ú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, seu substituições não serão exibidas aqui. Seus valores serão listados em `externalParameters.substitutions`.