Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creare un documento di YAML flusso di lavoro

Il documento di definizione del YAML formato configura le fasi di input, output e workflow per le fasi di creazione e test del processo di creazione dell'immagine. È possibile iniziare da modelli che includono passaggi standardizzati oppure iniziare da zero per definire il proprio flusso di lavoro. Sia che utilizzi un modello o inizi da zero, puoi personalizzare il flusso di lavoro in base alle tue esigenze.

Struttura di un documento di YAML flusso di lavoro

Il documento del YAML flusso di lavoro utilizzato da Image Builder per eseguire le azioni di creazione e test delle immagini è strutturato come segue.

Identificazione del documento di workflow

Identifica in modo univoco il flusso di lavoro. Questa sezione può includere i seguenti attributi.

Esempio

---
name: sample-test-image
description: Workflow for a sample image, with extra configuration options exposed through workflow parameters.
schemaVersion: 1.0

Parametri di input del documento del workflow

Questa parte del documento del flusso di lavoro definisce i parametri di input che il chiamante può specificare. Se non disponi di parametri, puoi omettere questa sezione. Se specificate dei parametri, ogni parametro può includere i seguenti attributi.

Esempio

Specificate il parametro nel documento del flusso di lavoro.

parameters:
  - name: waitForActionAtEnd
    type: boolean
    default: true
    description: "Wait for an external action at the end of the workflow"

Utilizzate il valore del parametro nel documento del flusso di lavoro.

$.parameters.waitForActionAtEnd

Fasi del documento del workflow

Speciifica fino a 15 azioni in fasi per il flusso di lavoro. Le fasi vengono eseguite nell'ordine in cui sono definite nel documento del flusso di lavoro. In caso di errore, il rollback viene eseguito in ordine inverso, iniziando dal passaggio non riuscito e procedendo a ritroso rispetto ai passaggi precedenti.

Ogni passaggio può fare riferimento all'output di qualsiasi azione del passaggio precedente. Questa operazione è nota come concatenamento o riferimento. Per fare riferimento all'output di un'azione precedente, puoi usare un JSONPath selettore. Per esempio:

$.stepOutputs.step-name.output-name

Per ulteriori informazioni, consulta Utilizzate le variabili dinamiche nel documento del flusso di lavoro.

Ogni passaggio può includere i seguenti attributi.

Esempio

steps:
  - name: LaunchTestInstance
    action: LaunchInstance
    onFailure: Abort
    inputs:
      waitFor: "ssmAgent"

  - name: ApplyTestComponents
    action: ExecuteComponents
    onFailure: Abort
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: TerminateTestInstance
    action: TerminateInstance
    onFailure: Continue
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

  - name: WaitForActionAtEnd
    action: WaitForAction
    if:
      booleanEquals: true
      value: "$.parameters.waitForActionAtEnd"

Output dei documenti del flusso di lavoro

Definisce gli output per il flusso di lavoro. Ogni output è una coppia di valori chiave che specifica il nome dell'output e il valore. È possibile utilizzare gli output per esportare dati in fase di esecuzione che i flussi di lavoro successivi possono utilizzare. Questa sezione è facoltativa.

Ogni output definito include i seguenti attributi.

Esempio

Create un ID dell'immagine di output per il documento del flusso di lavoro con l'output del createProdImage passaggio.

outputs:
  - name: 'outputImageId'
    value: '$.stepOutputs.createProdImage.imageId'

Fate riferimento all'output del flusso di lavoro nel flusso di lavoro successivo.

$.workflowOutputs.outputImageId