Riferimenti ad Attività di Registro Azure Container: YAML

  • Articolo

La definizione di attività in più passaggi in Attività di Registro Azure Container offre una primitiva di calcolo specifica per contenitori e basata su compilazione, test e applicazione di patch sui contenitori. Questo articolo illustra i comandi, i parametri, le proprietà e la sintassi per i file YAML che definiscono le attività in più passaggi.

L'articolo contiene informazioni di riferimento per la creazione di file YAML di attività in più passaggi per Attività di Registro Azure Container. Per un'introduzione ad Attività di Registro Azure Container, vedere ACR Tasks overview (Panoramica di Attività di Registro Azure Container).

Formato del file acr-task.yaml

Attività di Registro Azure Container supporta la dichiarazione di attività in più passaggi nella sintassi YAML standard. Definire i passaggi di un'attività in un file YAML. È quindi possibile eseguire manualmente l'attività passando il file al comando az acr run . In alternativa, usare il file per creare un'attività con az acr task create automaticamente in un commit Git, in un aggiornamento dell'immagine di base o in una pianificazione. Sebbene questo articolo si riferisca a acr-task.yaml come file che contiene i passaggi, Attività di Registro Azure Container può usare qualsiasi nome di file valido con un'estensione supportata.

Le primitive acr-task.yaml di livello superiore sono le proprietà delle attività, i tipi di passaggi e le proprietà dei passaggi.

  • Le proprietà dell'attività si applicano a tutti i passaggi durante l'intera esecuzione dell'attività. Esistono diverse proprietà dell'attività globale, tra cui:
    • version
    • stepTimeout
    • workingDirectory
  • I tipi di passaggi di attività rappresentano i tipi di azioni che possono essere eseguite in un'attività. Sono presenti tre tipi di passaggi:
    • build
    • push
    • cmd
  • Le proprietà dei passaggi dell'attività sono parametri che si applicano a un singolo passaggio. Sono presenti diverse proprietà dei passaggi, tra cui:
    • startDelay
    • timeout
    • when
    • e altre ancora.

Di seguito viene indicato il formato di base di un file acr-task.yaml che contiene alcune proprietà comuni dei passaggi. Sebbene non sia una rappresentazione completa di tutte le proprietà dei passaggi disponibili o di tutti i possibili usi dei tipi di passaggi, l'esempio offre una panoramica generale del formato di file di base.

version: # acr-task.yaml format version.
stepTimeout: # Seconds each step may take.
steps: # A collection of image or container actions.
  - build: # Equivalent to "docker build," but in a multi-tenant environment
  - push: # Push a newly built or retagged image to a registry.
    when: # Step property that defines either parallel or dependent step execution.
  - cmd: # Executes a container, supports specifying an [ENTRYPOINT] and parameters.
    startDelay: # Step property that specifies the number of seconds to wait before starting execution.

Estensioni del nome di file di attività supportate

Per Attività di Registro Azure Container sono presenti diverse estensioni del nome di file, ad esempio .yaml, che viene elaborato come un file delle attività. Qualsiasi estensione non presente nell'elenco seguente viene considerata da Attività di Registro Azure Container come un file Docker: .yaml, .yml, .toml, .json, .sh, .bash, .zsh, .ps1, .ps, .cmd, .bat, .ts, .js, .php, .py, .rb, .lua

YAML è l'unico formato di file attualmente supportato da Attività di Registro Azure Container. Le altre estensioni del nome di file sono riservate per un possibile supporto futuro.

Eseguire le attività di esempio

Sono disponibili diversi file di attività di esempio a cui si fa riferimento nelle sezioni seguenti di questo articolo. Le attività di esempio si trovano in un repository GitHub pubblico, Azure-Samples/acr-tasks. È possibile eseguirle con il comando dell'interfaccia della riga di comando di Azure az acr run. I comandi di esempio sono analoghi ai seguenti:

az acr run -f build-push-hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

La formattazione dei comandi di esempio presuppone che sia stato configurato un registro contenitori predefinito nell'interfaccia della riga di comando di Azure e di conseguenza il parametro --registry viene omesso. Per configurare un Registro di sistema predefinito, usare il comando az config con il set comando, che accetta una defaults.acr=REGISTRY_NAME coppia di valori chiave.

Per configurare ad esempio l'interfaccia della riga di comando di Azure con un registro contenitori predefinito denominato "myregistry", vedere l'esempio seguente:

az config set defaults.acr=myregistry

Proprietà delle attività

Le proprietà dell'attività vengono in genere visualizzate nella parte superiore di un acr-task.yaml file e sono proprietà globali che si applicano durante l'esecuzione completa dei passaggi attività. Alcune proprietà globali possono essere sostituite all'interno di un singolo passaggio.

Proprietà Type Facoltativo Descrizione Override supportato Valore predefinito
version string Sì Versione del file acr-task.yaml come analizzato dal servizio Attività di Registro Azure Container. Attività di Registro Azure Container cerca di mantenere la compatibilità con le versioni precedenti e questo valore consente di mantenere la compatibilità in una versione definita. Se non specificato, il valore predefinito viene impostato sulla versione più recente. No nessuno
stepTimeout intero (secondi) Sì Numero massimo di secondi per l'esecuzione di un passaggio. Se la stepTimeout proprietà viene specificata in un'attività, imposta la proprietà predefinita timeout di tutti i passaggi. Se la proprietà viene specificata in un passaggio, esegue l'override della timeoutstepTimeout proprietà fornita dall'attività.

La somma dei valori di timeout del passaggio per un'attività deve essere uguale al valore della proprietà di esecuzione timeout dell'attività, ad esempio impostata passando --timeout al az acr task create comando. Se il valore di esecuzione timeout delle attività è più piccolo, è necessario priorità.		 Sì 600 (10 minuti)
workingDirectory string Sì Directory di lavoro del contenitore durante il runtime. Se la proprietà viene specificata in un'attività, imposta la proprietà predefinita workingDirectory di tutti i passaggi. Se specificato in un passaggio, esegue l'override della proprietà fornita dall'attività. Sì c:\workspace in Windows o /workspace in Linux
env [stringa, stringa, ...] Sì Matrice di stringhe in key=value formato che definiscono le variabili di ambiente per l'attività. Se la proprietà viene specificata in un'attività, imposta la proprietà predefinita env di tutti i passaggi. Se specificato in un passaggio, esegue l'override di eventuali variabili di ambiente ereditate dall'attività. Sì Nessuno
secrets [segreto, segreto, ...] Sì Matrice di oggetti segreti . No nessuno
networks [rete, rete, ...] Sì Matrice di oggetti di rete . No nessuno
volumes [volume, volume, ...] Sì Matrice di oggetti volume . Specifica i volumi con contenuto di origine da montare in un passaggio. No nessuno

secret

L'oggetto segreto ha le proprietà seguenti.

Proprietà Type Facoltativo Descrizione Valore predefinito
id string No Identificatore del segreto. Nessuno
keyvault string Sì URL del segreto di Azure Key Vault. Nessuno
clientID string Sì ID client dell'identità gestita assegnata dall'utente per le risorse di Azure. Nessuno

network

L'oggetto di rete ha le proprietà seguenti.

Proprietà Type Facoltativo Descrizione Valore predefinito
name string No Nome della rete. Nessuno
driver string Sì Driver per gestire la rete. Nessuno
ipv6 bool Sì Indica se la rete IPv6 è abilitata. false
skipCreation bool Sì Se ignorare la creazione di rete. false
isDefault bool Sì Indica se la rete è una rete predefinita fornita con Registro Azure Container. false

volume

L'oggetto volume ha le proprietà seguenti.

Proprietà Type Facoltativo Descrizione Valore predefinito
name string No Nome del volume da montare. Può contenere solo caratteri alfanumerici, '-' e '_'. Nessuno
secret map[string]string No Ogni chiave della mappa è il nome di un file creato e popolato nel volume. Ogni valore è la versione stringa del segreto. I valori dei segreti devono essere codificati in Base64. Nessuno

Tipi di passaggi delle attività

Attività di Registro Azure Container supporta tre tipi di passaggi. Ogni tipo di passaggio supporta diverse proprietà, indicate in dettaglio nella sezione per ogni tipo.

Tipo di passaggio Descrizione
build Compila un'immagine del contenitore con la sintassi docker build nota.
push Esegue un'operazione docker push delle immagini compilate o contrassegnate nuovamente in un registro contenitori. Sono supportati Registro Azure Container, altri registri privati e l'hub Docker.
cmd Esegue un contenitore come un comando con parametri passati all'elemento [ENTRYPOINT] del contenitore. Il cmd tipo di passaggio supporta parametri come env, detache altre opzioni di comando note docker run , abilitando il test unità e funzionale con l'esecuzione simultanea del contenitore.

build

Compila un'immagine del contenitore. Il tipo di passaggio build rappresenta uno strumento multi-tenant sicuro per l'esecuzione di docker build nel cloud come primitiva di prima classe.

Sintassi: build

version: v1.1.0
steps:
  - [build]: -t [imageName]:[tag] -f [Dockerfile] [context]
    [property]: [value]

Eseguire il comando az acr runper ottenere la versione di Docker.

az acr run -r $ACR_NAME --cmd "docker version" /dev/null

Aggiungere la variabile di ambiente nel file yaml per abilitare DOCKER_BUILDKIT=1buildkit e usare secret con buildkit.

Il tipo di passaggio build supporta i parametri nella tabella seguente. Il tipo di passaggio build supporta anche tutte le opzioni di compilazione del comando docker build, ad esempio --build-arg, per impostare le variabili in fase di compilazione.

Parametro Description Facoltativo
-t | --image Definisce il percorso completo image:tag dell'immagine compilata.

Poiché le immagini possono essere usate per le convalide di attività interne, ad esempio test funzionali, non tutte le immagini richiedono l'operazione push in un registro contenitori. Per creare un'istanza di un'immagine nell'esecuzione di un'attività, tuttavia, è necessario che all'immagine sia associato un nome di riferimento.

A differenza di az acr build, l'esecuzione di Attività del Registro Azure Container non fornisce il comportamento push predefinito. Con Attività di Registro Azure Container, lo scenario predefinito presuppone la possibilità di compilare e di convalidare un'immagine e quindi di eseguirne il push. Per informazioni su come eseguire il push facoltativo di immagini compilate, vedere push.		 Sì
-f | --file Specifica l'elemento Dockerfile passato a docker build. Se non specificato, viene usato il valore predefinito Dockerfile nella directory radice del contesto. Per specificare un Dockerfile, passare il nome file relativo alla radice del contesto. Sì
context Directory radice passata a docker build. La directory radice di ogni attività è impostata su un oggetto condiviso workingDirectory e include la radice della directory clonata Git associata. No

Proprietà: build

Il tipo di passaggio build supporta le proprietà seguenti. Per informazioni dettagliate su queste proprietà, vedere la sezione Proprietà passaggio attività di questo articolo.

Proprietà Tipo Necessario
detach bool Facoltativo
disableWorkingDirectoryOverride bool Facoltativo
entryPoint string Facoltativo
env [stringa, stringa, ...] Facoltativo
expose [stringa, stringa, ...] Facoltativo
id string Facoltativo
ignoreErrors bool Facoltativo
isolation string Facoltativo
keep bool Facoltativo
network object Facoltativo
ports [stringa, stringa, ...] Facoltativo
pull bool Facoltativo
repeat INT Facoltativo
retries INT Facoltativo
retryDelay intero (secondi) Facoltativo
secret object Facoltativo
startDelay intero (secondi) Facoltativo
timeout intero (secondi) Facoltativo
volumeMount object Facoltativo
when [stringa, stringa, ...] Facoltativo
workingDirectory string Facoltativo

Esempi: build

Compilare un'immagine - contesto nella directory radice

az acr run -f build-hello-world.yaml https://github.com/AzureCR/acr-tasks-sample.git

version: v1.1.0
steps:
  - build: -t $Registry/hello-world -f hello-world.dockerfile .

Compilare un'immagine - contesto nella sottodirectory

version: v1.1.0
steps:
  - build: -t $Registry/hello-world -f hello-world.dockerfile ./subDirectory

push

Esegue il push di una o più immagini compilate o contrassegnate nuovamente in un registro contenitori. Supporta il push in registri privati, ad esempio in Registro Azure Container o nell'hub Docker pubblico.

Sintassi: push

Il tipo di passaggio push supporta una raccolta di immagini. La sintassi delle raccolte YAML supporta formati annidati e inline. L'esecuzione del push di una singola immagine è in genere rappresentato usando la sintassi inline:

version: v1.1.0
steps:
  # Inline YAML collection syntax
  - push: ["$Registry/hello-world:$ID"]

Per migliorare la leggibilità, usare la sintassi annidata quando si esegue il push di più immagini:

version: v1.1.0
steps:
  # Nested YAML collection syntax
  - push:
    - $Registry/hello-world:$ID
    - $Registry/hello-world:latest

Proprietà: push

Il tipo di passaggio push supporta le proprietà seguenti. Per informazioni dettagliate su queste proprietà, vedere la sezione Proprietà passaggio attività di questo articolo.

Proprietà Type Necessario
env [stringa, stringa, ...] Facoltativo
id string Facoltativo
ignoreErrors bool Facoltativo
startDelay intero (secondi) Facoltativo
timeout intero (secondi) Facoltativo
when [stringa, stringa, ...] Facoltativo

Esempi: push

Eseguire il push di più immagini

az acr run -f build-push-hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  - build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .
  - push: 
    - $Registry/hello-world:$ID

Compilare, eseguire il push ed eseguire

az acr run -f build-run-hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  - build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .
  - push:
    - $Registry/hello-world:$ID
  - cmd: $Registry/hello-world:$ID

cmd

Il tipo di passaggio cmd esegue un contenitore.

Sintassi: cmd

version: v1.1.0
steps:
  - [cmd]: [containerImage]:[tag (optional)] [cmdParameters to the image]

Proprietà: cmd

Il tipo di passaggio cmd supporta le proprietà seguenti:

Proprietà Type Necessario
detach bool Facoltativo
disableWorkingDirectoryOverride bool Facoltativo
entryPoint string Facoltativo
env [stringa, stringa, ...] Facoltativo
expose [stringa, stringa, ...] Facoltativo
id string Facoltativo
ignoreErrors bool Facoltativo
isolation string Facoltativo
keep bool Facoltativo
network object Facoltativo
ports [stringa, stringa, ...] Facoltativo
pull bool Facoltativo
repeat INT Facoltativo
retries INT Facoltativo
retryDelay intero (secondi) Facoltativo
secret object Facoltativo
startDelay intero (secondi) Facoltativo
timeout intero (secondi) Facoltativo
volumeMount object Facoltativo
when [stringa, stringa, ...] Facoltativo
workingDirectory string Facoltativo

I dettagli di tali proprietà sono descritti nella sezione Proprietà dei passaggi delle attività di questo articolo.

Esempi: cmd

Eseguire l'immagine hello-world

Questo comando esegue il file di attività hello-world.yaml, che fa riferimento all'immagine hello-world nell'hub Docker.

az acr run -f hello-world.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  - cmd: mcr.microsoft.com/hello-world

Eseguire l'immagine bash e il comando echo "hello world"

Questo comando esegue il file di attività bash-echo.yaml, che fa riferimento all'immagine bash nell'hub Docker.

az acr run -f bash-echo.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  - cmd: bash echo hello world

Applicare il tag all'immagine bash specifica

Per eseguire una versione di immagine specifica, indicare il tag in cmd.

Questo comando esegue il file di attività bash-echo-3.yaml, che fa riferimento all'immagine bash:3.0 nell'hub Docker.

az acr run -f bash-echo-3.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  - cmd: bash:3.0 echo hello world

Eseguire immagini personalizzate

Il tipo di passaggio cmd fa riferimento alle immagini usando il formato docker run standard. Le immagini non precedute da un registro contenitori vengono considerate come provenienti da docker.io. L'esempio precedente potrebbe essere ugualmente rappresentato come:

version: v1.1.0
steps:
  - cmd: docker.io/bash:3.0 echo hello world

Usando la convenzione di riferimento dell'immagine standarddocker run, cmd è possibile eseguire immagini da qualsiasi registro privato o dal Docker Hub pubblico. Se si fa riferimento a immagini nello stesso registro contenitori in cui è in esecuzione Attività di Registro Azure Container, non è necessario specificare alcuna credenziale di registro.

  • Eseguire un'immagine da un registro Azure Container. Nell'esempio seguente si presuppone che sia presente un Registro di sistema denominato myregistrye un'immagine myimage:mytagpersonalizzata.

    version: v1.1.0
steps:
    - cmd: myregistry.azurecr.io/myimage:mytag

  • Generalizzare il riferimento al Registro di sistema con una variabile di esecuzione o un alias

    Invece di scrivere il nome del Registro di sistema in un acr-task.yaml file, è possibile renderlo più portatile usando una variabile oun alias Run. La Run.Registry variabile o $Registry l'alias si espande in fase di esecuzione al nome del Registro di sistema in cui viene eseguita l'attività.

    Ad esempio, per generalizzare l'attività precedente in modo che funzioni in qualsiasi Registro Azure Container, fare riferimento alla variabile $Registry nel nome dell'immagine:

    version: v1.1.0
steps:
  - cmd: $Registry/myimage:mytag

Accedere ai volumi segreti

La volumes proprietà consente di specificare volumi e relativi contenuti segreti per build e cmd passaggi in un'attività. All'interno di ogni passaggio, una proprietà facoltativa volumeMounts elenca i volumi e i percorsi del contenitore corrispondenti da montare nel contenitore in quel passaggio. I segreti vengono forniti come file nel percorso di montaggio di ogni volume.

Eseguire un'attività e montare due segreti in un passaggio: uno archiviato in un insieme di credenziali delle chiavi e uno specificato nella riga di comando:

az acr run -f mounts-secrets.yaml --set-secret mysecret=abcdefg123456 https://github.com/Azure-Samples/acr-tasks.git

# This template demonstrates mounting a custom volume into a container at a CMD step
secrets:
  - id: sampleSecret
    keyvault: https://myacbvault2.vault.azure.net/secrets/SampleSecret # Replace with valid keyvault with access

volumes:
  - name: mysecrets
    secret:
      mysecret1: {{.Secrets.sampleSecret | b64enc}}
      mysecret2: {{.Values.mysecret | b64enc}}

steps:
  - cmd: bash cat /run/test/mysecret1 /run/test/mysecret2
    volumeMounts:
      - name: mysecrets
        mountPath: /run/test

Proprietà dei passaggi delle attività

Ogni tipo di passaggio supporta diverse proprietà appropriate per il tipo stesso. La tabella seguente definisce tutte le proprietà disponibili per un passaggio. Non tutti i tipi di passaggi supportano tutte le proprietà. Per visualizzare le proprietà disponibili per ogni tipo di passaggio, vedere le sezioni d riferimento al tipo di passaggio cmd, build e push.

Proprietà Type Facoltativo Descrizione Valore predefinito
detach bool Sì Indica se il contenitore deve essere disconnesso durante l'esecuzione. false
disableWorkingDirectoryOverride bool Sì Se disabilitare la workingDirectory funzionalità di override. Usare questa combinazione con workingDirectory per avere il controllo completo sulla directory di lavoro del contenitore. false
entryPoint string Sì Esegue l'override dell'elemento [ENTRYPOINT] di un contenitore del passaggio. Nessuno
env [stringa, stringa, ...] Sì Matrice di stringhe in formato key=value che definiscono le variabili di ambiente per il passaggio. Nessuno
expose [stringa, stringa, ...] Sì Matrice di porte esposte dal contenitore. Nessuno
id string Sì Identifica in modo univoco il passaggio nell'attività. Altri passaggi nell'attività possono fare riferimento all'elemento id del passaggio, ad esempio per il controllo delle dipendenze con when.

id è anche il nome del contenitore in esecuzione. I processi in esecuzione in altri contenitori nell'attività, ad esempio, possono fare riferimento all'elemento id come nome host DNS o per accedervi con l'elemento [id] dei log di Docker.		 acb_step_%d, dove %d è l'indice basato su 0 del passaggio superiore nel file YAML
ignoreErrors bool Sì Se contrassegnare il passaggio come riuscito indipendentemente dal fatto che si sia verificato un errore durante l'esecuzione del contenitore. false
isolation string Sì Livello di isolamento del contenitore. default
keep bool Sì Indica se il contenitore del passaggio deve essere mantenuto dopo l'esecuzione. false
network object Sì Identifica una rete in cui viene eseguito il contenitore. Nessuno
ports [stringa, stringa, ...] Sì Matrice di porte pubblicate dal contenitore all'host. Nessuno
pull bool Sì Se forzare un pull del contenitore prima di eseguirlo per impedire qualsiasi comportamento di memorizzazione nella cache. false
privileged bool Sì Indica se eseguire il contenitore in modalità con privilegi. false
repeat INT Sì Numero di tentativi per ripetere l'esecuzione di un contenitore. 0
retries INT Sì Numero di tentativi da tentare se un contenitore non riesce l'esecuzione. Viene eseguito un nuovo tentativo solo se il codice di uscita di un contenitore è diverso da zero. 0
retryDelay intero (secondi) Sì Ritardo in secondi tra i tentativi di esecuzione di un contenitore. 0
secret object Sì Identifica un segreto di Azure Key Vault o un'identità gestita per le risorse di Azure. Nessuno
startDelay intero (secondi) Sì Numero di secondi per ritardare l'esecuzione di un contenitore. 0
timeout intero (secondi) Sì Numero massimo di secondi per l'esecuzione di un passaggio prima che venga terminato. 600
when [stringa, stringa, ...] Sì Configura la dipendenza di un passaggio in uno o più passaggi nell'attività. Nessuno
user string Sì Nome utente o UID di un contenitore Nessuno
workingDirectory string Sì Imposta la directory di lavoro per un passaggio. Per impostazione predefinita, Attività di Registro Azure Container crea una directory radice come directory di lavoro. Se la compilazione prevede diversi passaggi, tuttavia, i passaggi precedenti possono condividere artefatti con quelli successivi specificando la stessa directory di lavoro. c:\workspace in Windows o /workspace in Linux

volumeMount

L'oggetto volumeMount ha le proprietà seguenti.

Proprietà Type Facoltativo Descrizione Valore predefinito
name string No Nome del volume da montare. Deve corrispondere esattamente al nome di una volumes proprietà. Nessuno
mountPath string no Percorso assoluto per montare i file nel contenitore. Nessuno

Esempi: proprietà dei passaggi delle attività

Esempio: id

Compilare due immagini, creando un'istanza di un'immagine di test funzionale. Ogni passaggio è identificato da un elemento id univoco, a cui altri passaggi nell'attività fanno riferimento nella proprietà when.

az acr run -f when-parallel-dependent.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  # build website and func-test images, concurrently
  - id: build-hello-world
    build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .
    when: ["-"]
  - id: build-hello-world-test
    build: -t hello-world-test -f hello-world.dockerfile .
    when: ["-"]
  # run built images to be tested
  - id: hello-world
    cmd: $Registry/hello-world:$ID
    when: ["build-hello-world"]
  - id: func-tests
    cmd: hello-world-test
    env:
      - TEST_TARGET_URL=hello-world
    when: ["hello-world"]
  # push hello-world if func-tests are successful  
  - push: ["$Registry/hello-world:$ID"]
    when: ["func-tests"]

Esempio: when

La proprietà when specifica la dipendenza di un passaggio in altri passaggi nell'attività. Supporta due valori di parametro:

  • when: ["-"] - Indica che in altri passaggi non è presente alcuna dipendenza. Un passaggio con la specifica when: ["-"] inizia immediatamente l'esecuzione e consente l'esecuzione simultanea dei passaggi.
  • when: ["id1", "id2"] - Indica che il passaggio dipende dai passaggi con id "id1" e id "id2". Questo passaggio non viene eseguito fino a quando i passaggi "id1" e "id2" non sono completati.

Se when non è specificato in un passaggio, quest'ultimo dipende dal completamento di quello precedente nel file acr-task.yaml.

Esecuzione sequenziale di passaggi senza when:

az acr run -f when-sequential-default.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
    - cmd: bash echo one
    - cmd: bash echo two
    - cmd: bash echo three

Esecuzione sequenziale di passaggi con when:

az acr run -f when-sequential-id.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
    - id: step1
      cmd: bash echo one
    - id: step2
      cmd: bash echo two
      when: ["step1"]
    - id: step3
      cmd: bash echo three
      when: ["step2"]

Compilazione di immagini parallele:

az acr run -f when-parallel.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  # build website and func-test images, concurrently
  - id: build-hello-world
    build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .
    when: ["-"]
  - id: build-hello-world-test
    build: -t hello-world-test -f hello-world.dockerfile .
    when: ["-"]

Compilazione di immagini in parallelo e test di dipendenza:

az acr run -f when-parallel-dependent.yaml https://github.com/Azure-Samples/acr-tasks.git

version: v1.1.0
steps:
  # build website and func-test images, concurrently
  - id: build-hello-world
    build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .
    when: ["-"]
  - id: build-hello-world-test
    build: -t hello-world-test -f hello-world.dockerfile .
    when: ["-"]
  # run built images to be tested
  - id: hello-world
    cmd: $Registry/hello-world:$ID
    when: ["build-hello-world"]
  - id: func-tests
    cmd: hello-world-test
    env:
      - TEST_TARGET_URL=hello-world
    when: ["hello-world"]
  # push hello-world if func-tests are successful  
  - push: ["$Registry/hello-world:$ID"]
    when: ["func-tests"]

Variabili di esecuzione

Attività di Registro Azure Container contiene un set predefinito di variabili disponibili per i passaggi delle attività quando vengono eseguiti. A tali variabili è possibile accedere usando il formato {{.Run.VariableName}}, dove l'elemento VariableName è uno dei seguenti:

  • Run.ID
  • Run.SharedVolume
  • Run.Registry
  • Run.RegistryName
  • Run.Date
  • Run.OS
  • Run.Architecture
  • Run.Commit
  • Run.Branch
  • Run.TaskName

I nomi delle variabili sono in genere autoesplicativi. Per le variabili di uso comune, seguire i dettagli. A partire dalla versione v1.1.0YAML, è possibile usare un alias attività abbreviato e predefinito al posto della maggior parte delle variabili di esecuzione. Ad esempio, al posto di {{.Run.Registry}}, usare l'alias $Registry .

Run.ID

Ogni esecuzione in base a run, through az acr runo trigger di attività create tramite az acr task create, ha un ID univoco. che rappresenta l'esecuzione corrente.

La variabile viene usata in genere per assegnare univocamente un tag a un'immagine:

version: v1.1.0
steps:
    - build: -t $Registry/hello-world:$ID .

Run.SharedVolume

Identificatore univoco per un volume condiviso accessibile da tutti i passaggi dell'attività. Il volume viene montato c:\workspace in In Windows o /workspace in Linux.

Run.Registry

Nome completo del server del registro contenitori usato in genere per fare riferimento in modo generico al registro contenitori in cui l'attività è in esecuzione.

version: v1.1.0
steps:
  - build: -t $Registry/hello-world:$ID .

Run.RegistryName

Nome del registro contenitori. In genere usata nei passaggi delle attività che non richiedono un nome di server completo, cmd ad esempio i passaggi che eseguono i comandi dell'interfaccia della riga di comando di Azure nei registri.

version 1.1.0
steps:
# List repositories in registry
- cmd: az login --identity
- cmd: az acr repository list --name $RegistryName

Run.Date

Ora UTC corrente in cui l'esecuzione è stata avviata.

Run.Commit

Per un'attività attivata da un commit in un repository GitHub, l'identificatore di commit.

Run.Branch

Per un'attività attivata da un commit in un repository GitHub, il nome del ramo.

Alias

A partire da v1.1.0, ACR Tasks supporta gli alias disponibili per i passaggi delle attività quando vengono eseguiti. Gli alias sono simili al concetto agli alias (tasti di scelta rapida dei comandi) supportati in bash e in alcune altre shell dei comandi.

Con un alias, è possibile avviare qualsiasi comando o gruppo di comandi (incluse opzioni e nomi file) immettendo una singola parola.

Attività del Registro Azure Container supporta diversi alias predefiniti e anche alias personalizzati creati.

Alias predefiniti

Gli alias attività seguenti sono disponibili per l'uso al posto delle variabili di esecuzione:

Alias Variabile di esecuzione
ID Run.ID
SharedVolume Run.SharedVolume
Registry Run.Registry
RegistryName Run.RegistryName
Date Run.Date
OS Run.OS
Architecture Run.Architecture
Commit Run.Commit
Branch Run.Branch

Nei passaggi delle attività precedere un alias con la $ direttiva, come in questo esempio:

version: v1.1.0
steps:
  - build: -t $Registry/hello-world:$ID -f hello-world.dockerfile .

Alias di immagine

Ognuno degli alias seguenti punta a un'immagine stabile in Microsoft Container Registry (MCR). È possibile fare riferimento a ognuno di essi nella cmd sezione di un file di attività senza usare una direttiva.

Alias Immagine
acr mcr.microsoft.com/acr/acr-cli:0.5
az mcr.microsoft.com/acr/azure-cli:7ee1d7f
bash mcr.microsoft.com/acr/bash:7ee1d7f
curl mcr.microsoft.com/acr/curl:7ee1d7f

L'attività di esempio seguente usa diversi alias per eliminare i tag di immagine precedenti a 7 giorni nel repository samples/hello-world nel Registro di sistema di esecuzione:

version: v1.1.0
steps:
  - cmd: acr tag list --registry $RegistryName --repository samples/hello-world
  - cmd: acr purge --registry $RegistryName --filter samples/hello-world:.* --ago 7d

Alias personalizzato

Definire un alias personalizzato nel file YAML e usarlo come illustrato nell'esempio seguente. Un alias può contenere solo caratteri alfanumerici. La direttiva predefinita per espandere un alias è il $ carattere.

version: v1.1.0
alias:
  values:
    repo: myrepo
steps:
  - build: -t $Registry/$repo/hello-world:$ID -f Dockerfile .

È possibile collegare un file YAML remoto o locale per le definizioni di alias personalizzate. Nell'esempio seguente viene collegato un file YAML nell'archiviazione BLOB di Azure:

version: v1.1.0
alias:
  src:  # link to local or remote custom alias files
    - 'https://link/to/blob/remoteAliases.yml?readSasToken'
[...]

Passaggi successivi

Per una panoramica delle attività in più passaggi, vedere Run multi-step build, test, and patch tasks in ACR Tasks (Eseguire attività di compilazione, test e applicazione di patch in più passaggi in Attività di Registro Azure Container).

Per le compilazioni in un singolo passaggio, vedere ACR Tasks overview (Panoramica di Attività di Registro Azure Container).