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