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 .
|