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 che puoi
e non sono presenti nella configurazione della build. Sono inclusi i trigger
parametri non presenti nel tuo file cloudbuild.yaml
.
Campo | Tipo | Dettagli |
---|---|---|
buildConfigSource | oggetto | Posizione da cui è stata letta la configurazione di compilazione. In BuildTrigger , corrisponde al repository di origine
Hanno attivato la build (build attivate da eventi SCM) oppure
gitFileSource per tutti gli altri tipi di trigger.buildConfigSource O buildConfig (in
nel caso della configurazione di compilazione in linea). |
buildConfigSource.ref | string | Riferimento Git all'interno di buildConfigSource.repository da cui è stata letta la configurazione, come riferimento Git completamente qualificato (che inizia con refs/ ) o come SHA del commit (in esadecimale minuscolo). Un SHA commit viene utilizzato solo se specificato nell'attivatore. |
buildConfigSource.repository | string | URI HTTPS del repository Git contenente la configurazione di compilazione
con il 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 non 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.Si escludono a vicenda con path . Esattamente uno di questi
I campi DEVONO essere impostati su un valore non predefinito. |
sourceToBuild | oggetto | Codice sorgente elaborato e creato. In genere è uguale a buildConfigSource ; è diverso solo se per BuildTrigger è stato impostato gitFileSource .Questo campo non esiste se repository e
ref corrispondono a buildConfigSource e
la dir è vuota.In BuildTrigger, corrisponde a sourceToBuild o il 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). Una SHA di commit è
utilizzata solo se specificato nel trigger. |
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 build, senza un barra finale. Può essere vuoto, non impostato. |
buildConfig | string | Quando viene fornita una configurazione di compilazione in linea, ad esempio in una
build inviata, vengono registrate le seguenti informazioni. - passaggi - opzioni di build (ad es. variabili di ambiente, volumi, dettagli del pool, machineType, dettagli log) - sostituzioni Se la configurazione di compilazione è stata letta da un repository, viene registrata nella sezione buildConfigSource e la build in linea
omesso.Queste informazioni vengono memorizzate come stringa JSON serializzata codificata in base64. |
sostituzioni | map<string,string></string,string> | Mappa di (stringa -> stringa) contenente le sostituzioni da eseguire sulla risorsa Build. Questo valore contiene solo "runtime" o "indipendente" che non sono registrato nella configurazione della build, ovvero trasmesso da un trigger o dal flag della gcloud CLI. 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 che Cloud Build per la build, a meno che tu non li sovrascriva. Per ulteriori informazioni, vedi 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
vengono forniti automaticamente nelle build di Cloud Build,
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 sezione resolvedDependencies
del BuildDefinition
.
ResolvedDependencies
è conforme alle
Specifica ResourceDescriptor
.
Tipo di dipendenza |
Dettagli |
---|---|
Crea il repository di configurazione |
Il repository a cui è stata eseguita la configurazione di compilazione (ad es. cloudbuild.yaml )
nel caso di build attivate.Può essere vuoto nel caso di una configurazione di compilazione che legge da un repository e viene fornita in linea, nel qual caso verrà omessa. |
Repository di codice sorgente |
Il repository da cui è stato estratto il codice sorgente da cui eseguire la creazione. Può essere uguale a buildConfigSource o diverso. Se è uguale a
buildConfigSource , il sourceToBuild viene omesso, ad esempio nelle compilazioni attivate da SCM.
Il campo sourceToBuild potrebbe essere vuoto se la build viene eseguita tramite
–no-source e verrà omesso. |
Ad esempio, le seguenti informazioni resolvedDependencies
contengono sia un valore buildConfigRepo sia un valore sourceRepo (che sono uguali) e 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 build che
ha eseguito l'operazione e ha 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 build.
invocationId visualizza 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. È progettata per contenere artefatti che non sono considerati l'output della build, ma che potrebbero utili per la risoluzione dei problemi o per 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 .
|