Tipo di build: Google Builder

Questa pagina illustra il tipo di build SLSA V1.0. per Google Builder.

Parametri esterni

La tabella seguente mostra i tipi di parametri esterni che possono essere utilizzati in una definizione di PipelineRun e Attività del flusso di lavoro. Salvo diversa indicazione tutti i parametri sono obbligatori.

Campo	Tipo	Dettagli
runSpec	oggetto	La specifica PipelineRun completa.
buildConfigSource	oggetto	La specifica buildConfigSource completa.

Specifica PipelineRun

Campo	Tipo	Dettagli
pipelineRef/taskRef	oggetto	Località da cui è stata letta pipelineSpec/taskSpec. Questo campo viene compilato solo se è stato fatto riferimento a pipelineSpec da un'origine remota. Valore predefinito: null
pipelineSpec/taskSpec	oggetto	Specifica della pipeline/dell'attività in linea, non recuperata da un'origine remota utilizzando pipelineRef/taskRef. [Facoltativo].
parametri	[object]	Mappa dei nomi e dei valori dei parametri forniti alla pipeline. Valori può essere stringa, array o tipo di oggetto. Valore predefinito: null Nota: in caso di flusso di lavoro attivato, questo campo conterrà anche alcuni parametri forniti dal sistema di attivazione di Cloud Build, oltre ai parametri configurati dall'utente nella definizione del flusso di lavoro.
spazi di lavoro	[object]	Le aree di lavoro contengono un insieme di associazioni di aree di lavoro che devono corrispondere con quelli dichiarati nella pipeline. Valore predefinito: null
timeouts/timeout	oggetto	Tempo dopo il quale la pipeline va in timeout. È possibile definire i timeout per pipeline, attività e infine. Sono correlati dalla formula Timeouts.pipeline Timeouts.tasks + Timeouts.finally.

Specifica buildConfigSource

Campo	Tipo	Dettagli
ref	oggetto	Può corrispondere a uno dei seguenti: Il riferimento Git. Ad esempio, sha di commit: sha1:563f0... Il digest dell'immagine. Ad esempio: sha256:91fbe...
repository	string	L'URI del repository git o l'URI del repository di immagini
percorso	string	Il percorso nel repository Git o il nome della risorsa nell'immagine gruppo.

Parametri interni

I parametri interni vengono forniti dal generatore per il processo di compilazione.

Campo	Tipo	Dettagli
tekton-pipelines-feature-flags	oggetto	Flag della funzionalità di configurazione Tekton utilizzati per la build. Si tratta di configurate dal generatore e sono utili per la riproducibilità.
systemParameters	oggetto	Un elenco di coppie di nomi e valori per le sostituzioni di sistema predefinite fornite da GCB.

Dipendenze risolte

Il campo resolvedDependencies deve contenere voci che identificano il riferimento risolto corrispondente a externalParameters.configRef. Si tratta del riferimento alla pipeline, nel caso di una specifica di PipelineRun, o al riferimento all'attività, nel caso di una specifica di TaskRun.

Le dipendenze risolte possono contenere elementi aggiuntivi che sono input per la compilazione, utilizzando il campo name per indicare il tipo di elemento:

• Per le pipeline remote, usa name: pipeline.
• Per le attività da remoto, utilizza name: pipelineTask.
• Per un riferimento risolto a un passaggio o a un'immagine container collaterale, name è facoltativo. Nel caso del campo digest, anche se l'immagine è a cui fa riferimento il tag, deve essere incluso il digest dell'immagine.
• Per gli altri artefatti di input utilizzati per la build, come il codice sorgente, usa name: inputs/result. Gli indicatori di tipo vengono utilizzati per i risultati dell'attività.

L'esempio seguente contiene informazioni su tutti i tipi di dependencies:

"resolvedDependencies": [
  {
    "name": "pipeline",
    "uri": "git+https://github.com/octocat/hello-world.git",
    "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  },
  {
  "name": "pipelineTask",
  "uri": "git+https://github.com/octocat/hello-world.git",
  "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  },
  {
  "uri": "gcr.io/tekton-releases/github.com/tektoncd/pipeline/cmd/git-init",
  "digest": {
    "sha256": "28ff94e63e4058afc3f15b4c11c08cf3b54fa91faa646a4bbac90380cd7158df"},
  },
  {
  "name": "inputs/result",
  "uri": "git+https://github.com/octocat/hello-world.git",
  "digest": {"sha1": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d"},
  }
]

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 è uno dei seguenti: https://cloudbuild.googleapis.com/GoogleBuilder. Questo l'ID generatore indica un valore SLSA L2 creare. https://cloudbuild.googleapis.com/GoogleIsolatedBuilder. Questo ID del creatore indica una build SLSA L3.
metadati	Metadati aggiuntivi su questa particolare esecuzione della build. invocationId visualizza l'URL della build, ad esempio https://cloudbuild.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/pipelineRuns/BUILD_ID. I campi startedOn e finishedOn contengono gli indicatori orari di inizio e completamento della build.
sottoprodotti	Un oggetto results. Contiene i TaskRunResults prodotti da PipelineRun. I contenuti sono codificati in Base64.