Questa pagina è stata tradotta dall'API Cloud Translation.

Tipo di build: build Cloud Build v1

Questa pagina illustra il tipo di build per Cloud Build.

Definizione build

Parametri esterni

La tabella seguente mostra i tipi di parametri esterni che possono essere utilizzati in una compilazione Cloud Build. I parametri esterni sono valori specificati che non sono presenti nella configurazione di compilazione. Sono inclusi i parametri di attivazione che non sono presenti nel file cloudbuild.yaml.

Campo	Tipo	Dettagli
buildConfigSource	oggetto	Posizione da cui è stata letta la configurazione di compilazione. In `BuildTrigger`, corrisponde al repository di origine che ha attivato la build (build attivate da eventi SCM) o a `gitFileSource` per tutti gli altri tipi di attivatori. Verrà impostato `buildConfigSource` OPPURE `buildConfig` (nel caso della configurazione build in linea).
buildConfigSource.ref	string	Riferimento Git all'interno di `buildConfigSource.repository` da dove è stata letta la configurazione, come riferimento Git completamente qualificato (che inizia con `refs/`) o come SHA del commit (in esadecimale minuscolo). Un commit SHA viene utilizzato solo se specificato nell'attivatore.
buildConfigSource.repository	string	URI HTTPS del repository Git contenente il file di configurazione della build, con protocollo `https://`. Verrà anteposto un `git+` per la compatibilità con il formato SPDX. Per ulteriori informazioni sui requisiti di formato, consulta ResourceURI.
buildConfigSource.path	string	Percorso del file di configurazione di compilazione all'interno del commit. Esempio: `cloudbuild.yaml` È mutuamente esclusivo di pathAutodetect. Esattamente uno di questi campi deve essere impostato su un valore diverso da quello predefinito.
buildConfigSource.pathAutoDetect	boolean	Se il valore è true, `path` è stato rilevato automaticamente, corrispondente all'opzione autodetect in `BuildTrigger`. False è considerato equivalente a non impostato; Cloud Build utilizza `path` se il rilevamento automatico non è stato attivato. È mutuamente esclusivo di `path`. È necessario impostare un valore non predefinito su uno di questi campi.
sourceToBuild	oggetto	Codice sorgente sottoposto a check-out e compilato. In genere è uguale a `buildConfigSource`; è diverso solo se per BuildTrigger è stato impostato `gitFileSource`. Questo campo non esiste se `repository` e `ref` sono uguali a `buildConfigSource` e `dir` è vuoto. In BuildTrigger, corrisponde a `sourceToBuild` o al commit che ha attivato la build, a seconda del tipo di trigger.
sourceToBuild.ref	string	Riferimento Git all'interno di `sourceToBuild.repository` che è stato controllato, come riferimento Git completamente qualificato (che inizia con `refs/`) o come SHA del commit (in esadecimale minuscolo). Un valore SHA del commit viene utilizzato solo se specificato nell'attivatore.
sourceToBuild.repository	string	URI HTTPS del repository Git sottoposto a check-out, con protocollo `https://`. Verrà preceduto da un `git+`.
sourceToBuild.dir	string	Directory all'interno del commit in cui eseguire la compilazione, senza una slash finale. Può essere vuoto, non impostato.
buildConfig	string	Quando viene fornita una configurazione di compilazione in linea, ad esempio in una compilazione inviata manualmente, vengono registrate le seguenti informazioni. - steps - opzioni di build (ad es. variabili di ambiente, volumi, dettagli del pool di worker, machineType, dettagli dei log) - sostituzioni Se la configurazione build è stata letta da un repository, viene registrata nella sezione `buildConfigSource` e la configurazione build in linea viene omessa. Queste informazioni vengono memorizzate come stringa JSON serializzata con codifica base64.
sostituzioni	map<string,string></string,string>	Mappa di (stringa -> stringa) contenente le sostituzioni da eseguire sulla risorsa di compilazione. Questo contiene solo sostituzioni "runtime" o "indipendenti" che non vengono registrate nella configurazione di compilazione, ovvero passate da un trigger o da un flag della CLI gcloud. Questo record non include le sostituzione predefinite fornite dal sistema, poiché sono considerate `internalParameters`. Le sostituzioni vengono visualizzate in questo campo indipendentemente dal fatto che siano richiamate o utilizzate nella configurazione di compilazione.

Parametri interni

La tabella seguente mostra i parametri interni impostati da Cloud Build per la compilazione, a meno che non li sovrascrivi. Per ulteriori informazioni, consulta le sostituzioni predefinite.

Campo	Dettagli
triggerUri	URI della risorsa dell'attivatore che ha invocato questa compilazione, in questo caso il nome completo della risorsa. Se la compilazione non è stata attivata, questo valore viene omesso.
systemSubstitutions	Esiste un sottoinsieme di valori di sostituzione predefiniti che vengono forniti automaticamente nelle build di Cloud Build, ad esempio `PROJECT_ID`, `BUILD_ID`. Se sovrascrivi una delle sostituzioni predefinite di Cloud Build, le tue sostituzione non verranno visualizzate qui. I valori verranno elencati in `externalParameters.substitutions`.

Dipendenze risolte

Se la build ha un repository di origine o un repository di configurazione di build, il repository è descritto nella resolvedDependencies sezione del BuildDefinition.

ResolvedDependencies sia conforme alla specifica ResourceDescriptor.

Tipo di dipendenza	Dettagli
Repository di configurazione build	Il repository da cui è stata estratta la configurazione di compilazione (ovvero `cloudbuild.yaml`), nel caso di build attivate. Questo valore può essere vuoto nel caso di una configurazione di compilazione che non è stata letta da un repository e viene fornita in linea, nel qual caso verrà omesso.
Repository di codice sorgente	Il repository da cui è stato estratto il codice sorgente da compilare. Può essere uguale a `buildConfigSource` o diverso. Se è uguale a `buildConfigSource`, il `sourceToBuild` viene omesso, ad esempio nelle compilazioni attivate da SCM. Il parametro `sourceToBuild` può essere vuoto se la compilazione viene eseguita tramite `–no-source` e verrà omesso.

Ad esempio, le seguenti informazioni resolvedDependencies contengono sia buildConfigRepo che sourceRepo (che sono uguali) sia un'immagine del passaggio di compilazione.

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

RunDetails

Campo	Dettagli
builder	Contiene un sottocampo `id` che identifica la piattaforma di compilazione che ha eseguito l'operazione e compilato questa provenienza. Contiene anche il livello SLSA. Il valore `id` previsto è `https://cloudbuild.googleapis.com/GoogleHostedWorker`.
metadati	Metadati aggiuntivi su questa particolare esecuzione della compilazione. `invocationId` mostra l'URL della build, ad esempio `https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/builds/BUILD_ID`. I campi `startedOn` e `finishedOn` contengono i timestamp di inizio e fine della compilazione.
sottoprodotti	Non ancora in uso. Progettato per contenere elementi aggiuntivi che non sono considerati output della compilazione, ma potrebbero essere utili per la risoluzione dei problemi o la risposta agli incidenti.
systemSubstitutions	Esiste un sottoinsieme di valori di sostituzione predefiniti che vengono forniti automaticamente nelle build di Cloud Build, ad esempio `PROJECT_ID`, `BUILD_ID`. Se sovrascrivi una delle sostituzioni predefinite di Cloud Build, le tue sostituzione non verranno visualizzate qui. I valori verranno elencati in `externalParameters.substitutions`.