Tipo di build: build di Cloud Build v1

In questa pagina viene spiegato il tipo di build per Cloud Build.

Definizione di build

Parametri esterni

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

Campo	Tipo	Dettagli
buildConfigSource	oggetto	Percorso 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 gitFileSource per tutti gli altri tipi di trigger. Verrà impostato il valore buildConfigSource O buildConfig (nel caso della configurazione della build incorporata).
buildConfigSource.ref	string	Riferimento Git all'interno di buildConfigSource.repository da cui è stata letta la configurazione, come riferimento Git completo (a partire da refs/) o SHA del commit (esadecimale minuscolo). Una SHA del commit viene utilizzata solo se specificata nel trigger.
buildConfigSource.repository	string	URI HTTPS del repository Git contenente il file di configurazione della build, con protocollo https://. Questo sarà preceduto da un prefisso git+ per garantire 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 Esclusivamente con pathAutodetect. Esattamente uno di questi campi deve essere impostato su un valore non predefinito.
buildConfigSource.pathAutoDetect	boolean	Se true, path è stato rilevato automaticamente, corrispondente all'opzione di rilevamento automatico in BuildTrigger. Il valore False è considerato equivalente a non impostato; Cloud Build utilizza invece path se il rilevamento automatico non è abilitato. In esclusiva con path. Esattamente uno di questi campi DEVE essere impostato su un valore non predefinito.
sourceToBuild	oggetto	Codice sorgente che è stato esaminato e creato. Normalmente è uguale a buildConfigSource; differisce 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 verificato, come riferimento git completo (che inizia con refs/) o SHA di commit (esadecimale minuscolo). Una SHA del commit viene utilizzata solo se specificata nel trigger.
sourceToBuild.repository	string	URI HTTPS del repository Git che è stato sottoposto al check-out, con protocollo https://. Verrà preceduto dal prefisso git+.
sourceToBuild.dir	string	directory all'interno del commit in cui eseguire la build, senza una barra finale. Può essere vuoto, non impostato.
buildConfig	string	Quando viene fornita una configurazione di build incorporata, ad esempio in una build inviata manualmente, vengono registrate le seguenti informazioni. - passaggi - opzioni di build (ad es. variabili di ambiente, volumi, dettagli del pool di worker, machineType, dettagli dei log) - sostituzioni Se la configurazione di build è stata letta da un repository, viene registrata nella sezione buildConfigSource e la configurazione di compilazione in linea viene omessa. Queste informazioni vengono archiviate come stringa JSON serializzata codificata in Base64.
sostituzioni	mappa<string,string></string,string>	Mappa di (stringa -> stringa) contenente le sostituzioni da eseguire sulla risorsa Build. Contiene solo le sostituzioni "runtime" o "indipendenti" che non sono registrate nella configurazione della build, ovvero trasmesse da un trigger o un flag dell'interfaccia a riga di comando gcloud. Questo record non include le sostituzioni predefinite fornite dal sistema perché sono considerate internalParameters. Le sostituzioni vengono visualizzate in questo campo a prescindere dal fatto che vi si faccia riferimento o che vengano utilizzate nella configurazione della build.

Parametri interni

La tabella seguente mostra i parametri interni impostati da Cloud Build per la build, a meno che tu non li sovrascriva. Per ulteriori informazioni, consulta la sezione sulle sostituzioni predefinite.

Campo	Dettagli
triggerUri	URI della risorsa del trigger che ha richiamato questa build, in questo caso il nome completo della risorsa. Se la build 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 e BUILD_ID. Se sovrascrivi una delle sostituzioni predefinite di Cloud Build, le sostituzioni non verranno visualizzate qui. I tuoi valori saranno elencati invece in externalParameters.substitutions.

Dipendenze risolte

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

ResolvedDependencies è conforme alla specifica ResourceDescriptor.

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

Ad esempio, le seguenti informazioni resolvedDependencies contengono sia buildConfigRepo sia sourceRepo (che sono uguali) e un'immagine del passaggio di 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	Dettagli
builder	Contiene un sottocampo id che identifica la piattaforma di build che ha eseguito l'operazione e ha completato questa provenienza. Contiene anche il livello SLSA. Il valore previsto di id è https://cloudbuild.googleapis.com/GoogleHostedWorker.
metadati	Metadati aggiuntivi su questa specifica esecuzione della build. 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 relativi all'inizio e al completamento della build.
sottoprodotti	Non ancora in uso. Progettato per contenere artefatti aggiuntivi che non sono considerati l'output della build, 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 e BUILD_ID. Se sovrascrivi una delle sostituzioni predefinite di Cloud Build, le sostituzioni non verranno visualizzate qui. I tuoi valori saranno elencati invece in externalParameters.substitutions.