Megosztás a következőn keresztül:

az acr task

  • Referencia

A tárolólemezképek Azure Container Registries használatával történő javításához, teszteléséhez és operációsrendszer-keretrendszerhez kapcsolódó lépések gyűjteményének kezelése.

Parancsok

Name Description Típus Állapot
az acr task cancel-run

Az Azure Container Registry megadott futtatásának megszakítása.

 Alapvető FE
az acr task create

Hozzon létre egy sor lépést a tárolók létrehozásához, teszteléséhez és operációsrendszer-keretrendszer javításához. A feladatok támogatják a git-véglegesítések és az alaprendszerkép-frissítések eseményindítóit.

 Alapvető FE
az acr task credential

Feladat hitelesítő adatainak kezelése. További információ: https://aka.ms/acr/tasks/cross-registry-authentication.

 Alapvető FE
az acr task credential add

Adjon hozzá egy egyéni regisztrációs adatbázis bejelentkezési hitelesítő adatait a feladathoz.

 Alapvető FE
az acr task credential list

A feladathoz tartozó összes egyéni beállításjegyzék-hitelesítő adat listázása.

 Alapvető FE
az acr task credential remove

Feladat hitelesítő adatainak eltávolítása.

 Alapvető FE
az acr task credential update

Frissítse a beállításjegyzék bejelentkezési hitelesítő adatait egy feladathoz.

 Alapvető FE
az acr task delete

Tevékenység törlése egy Azure Container Registryből.

 Alapvető FE
az acr task identity

Felügyelt identitások a tevékenységhez. További információ: https://aka.ms/acr/tasks/task-create-managed-identity.

 Alapvető FE
az acr task identity assign

Egy feladat felügyelt identitásának frissítése.

 Alapvető FE
az acr task identity remove

Feladat felügyelt identitásainak eltávolítása.

 Alapvető FE
az acr task identity show

A feladat felügyelt identitásainak megjelenítése.

 Alapvető FE
az acr task list

Az Azure Container Registry feladatainak listázása.

 Alapvető FE
az acr task list-runs

Listázhatja az Azure Container Registry összes végrehajtott futtatását, és szűrhet egy adott tevékenység alapján.

 Alapvető FE
az acr task logs

Naplók megjelenítése egy adott futtatáshoz. Ha nincs megadva futtatási azonosító, az utolsó létrehozott futtatás naplóinak megjelenítése.

 Alapvető FE
az acr task run

Manuálisan aktiválhat egy olyan feladatot, amely egyébként a Git véglegesítésére vagy az alaprendszerkép-frissítés eseményindítóira vár.

 Alapvető FE
az acr task show

Az Azure Container Registry nevesített feladatának tulajdonságainak lekérése.

 Alapvető FE
az acr task show-run

Az Azure Container Registry-feladat megadott futtatásának tulajdonságainak lekérése.

 Alapvető FE
az acr task timer

Feladat időzítő eseményindítóinak kezelése.

 Alapvető FE
az acr task timer add

Időzítő eseményindító hozzáadása egy tevékenységhez.

 Alapvető FE
az acr task timer list

Egy tevékenység összes időzítő eseményindítójának listázása.

 Alapvető FE
az acr task timer remove

Időzítő eseményindító eltávolítása egy tevékenységből.

 Alapvető FE
az acr task timer update

Frissítse egy tevékenység időzítő eseményindítójának frissítését.

 Alapvető FE
az acr task update

Azure Container Registry-feladat frissítése.

 Alapvető FE
az acr task update-run

Egy Azure Container Registry-feladat futtatási tulajdonságainak javítása.

 Alapvető FE

az acr task cancel-run

Szerkesztés

Az Azure Container Registry megadott futtatásának megszakítása.

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

Példák

Futtatás megszakítása

az acr task cancel-run -r myregistry --run-id runId

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

--run-id

Az egyedi futtatási azonosító.

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task create

Szerkesztés

Hozzon létre egy sor lépést a tárolók létrehozásához, teszteléséhez és operációsrendszer-keretrendszer javításához. A feladatok támogatják a git-véglegesítések és az alaprendszerkép-frissítések eseményindítóit.

az acr task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Példák

Hozzon létre egy feladatot a forráshely nélkül.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

Hozzon létre egy feladatot a standard bemenet definíciójával és egy időzítő eseményindítóval, amely minden óra tetején futtatja a feladatot az alapértelmezett eseményindító nevével. A "Ctrl + Z" (Windows) vagy a "Ctrl + D" (Linux) megszakítja a bemeneti streamet.

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

Hozzon létre egy Linux-feladatot egy nyilvános GitHub-adattárból, amely triggerek nélkül hozza létre a hello-world rendszerképet, és egy buildargumentumot használ.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Linux-feladat létrehozása egy privát Azure DevOps-adattár egy adott ágával, amely létrehozza a hello-world rendszerképet az Arm-architektúrán (V7-változat), és engedélyezve vannak az eseményindítók.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

Hozzon létre egy Linux-feladatot egy nyilvános GitHub-adattárból, amely létrehozza a hello-world rendszerképet egy git véglegesítési és lekéréses kérelem eseményindítójának engedélyezésével. Vegye figyelembe, hogy ez a feladat nem használja a Forrásregisztrációs adatbázist (myregistry), így explicit módon beállíthatjuk a hitelesítési módot Nincs értékként.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

Hozzon létre egy Windows-feladatot egy nyilvános GitHub-adattárból, amely az Azure Container Builder rendszerképét amd64-architektúrára építi, és csak az alaprendszerkép-eseményindító engedélyezve van.

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

Linuxos többlépéses feladat létrehozása nyilvános GitHub-adattárból rendszer által hozzárendelt és felhasználó által hozzárendelt felügyelt identitásokkal, valamint alaprendszerképekkel, git véglegesítéssel, lekéréses kérelemmel és időzítő triggerekkel, amelyek hétfőn déltől péntekig futtatják a feladatot az időzítő eseményindítójának nevével.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Kötelező paraméterek

--name -n

A feladat neve.

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--agent-pool
Előnézet

Az ügynökkészlet neve.

--arg

Argumentum összeállítása "--arg name[=value]" formátumban. A többszörösöket a "--arg name[=value]" többszöri átadásával támogatjuk. FONTOS: Ez a paraméter nem tartalmazhat jelszavakat, hozzáférési jogkivonatokat vagy bizalmas információkat. Ez a paraméterérték hibakeresési célokból látható lesz az ACR-csapat számára.

--assign-identity

Felügyelt identitásokat rendel a feladathoz. A(z) "[system]" használatával a rendszer által hozzárendelt identitásra vagy erőforrás-azonosítóra hivatkozva hivatkozhat egy felhasználó által hozzárendelt identitásra. További információ: https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

A forrásregisztrációs adatbázis hitelesítési módja.

Elfogadott értékek: Default, None
--base-image-trigger-enabled

Azt jelzi, hogy az alaprendszerkép-eseményindító engedélyezve van-e.

Elfogadott értékek: false, true
Alapértelmezett érték: True
--base-image-trigger-name

Az alaprendszerkép-eseményindító neve.

Alapértelmezett érték: defaultBaseimageTriggerName
--base-image-trigger-type

Az alaprendszerkép-függőségi frissítések automatikus eseményindítójának típusa.

Elfogadott értékek: All, Runtime
Alapértelmezett érték: Runtime
--cmd

Végrehajtandó parancsok. Ez további Docker-futtatási paramétereket (https://docs.docker.com/engine/reference/commandline/run/) vagy akár más docker-parancsokat (https://docs.docker.com/engine/reference/commandline/docker/) is támogat.

--commit-trigger-enabled

Azt jelzi, hogy a forrásvezérlő véglegesítési eseményindítója engedélyezve van-e.

Elfogadott értékek: false, true
Alapértelmezett érték: True
--context -c

A forráskód-adattár teljes URL-címe (github-adattárhoz a ".git" utótag szükséges) vagy egy távoli tarball (pl. ""http://server/context.tar.gz), vagy egy OCI-összetevő adattára egy Azure-tárolóregisztrációs adatbázisban (pl. "oci://myregistry.azurecr.io/myartifact:mytag"). Ha a "/dev/null" érték meg van adva, az érték Nincs értékre lesz állítva, és figyelmen kívül lesz hagyva. Ez kötelező argumentum, ha a tevékenység nem rendszerfeladat.

--cpu

A processzorkonfiguráció a futtatáshoz szükséges magok számát tekintve.

Alapértelmezett érték: 2
--file -f

A feladat/docker fájl relatív elérési útja a forráskód gyökérmappájába. A feladatfájlokat a ".yaml" utótaggal kell utótaggal elválasztani, vagy a standard bemenetből a "-" használatával kell beszúrni.

--git-access-token

A forrásvezérlő szolgáltatóhoz való hozzáféréshez használt hozzáférési jogkivonat.

--image -t

A kép neve és címkéje a következő formátumban: '-t repo/image:tag'. A -t többszöri átadásával több címke is támogatott.

--is-system-task
Előnézet

Azt jelzi, hogy a tevékenységerőforrás rendszerfeladat-e. A feladat nevének "gyorsfeladatnak" kell lennie. Csak a CMK-kompatibilis beállításjegyzékre alkalmazható.

Alapértelmezett érték: False
--log-template
Előnézet

A naplóösszetevő futtatásához használt adattár és címkesablon a következő formátumban: "log/repo:tag" (pl. "acr/logs:{.Run.ID}}"). Csak a CMK-kompatibilis beállításjegyzékre alkalmazható.

--no-cache

Azt jelzi, hogy a képgyorsítótár engedélyezve van-e.

Elfogadott értékek: false, true
Alapértelmezett érték: False
--no-push

Azt jelzi, hogy a létrehozott rendszerképet le kell-e küldeni a beállításjegyzékbe.

Elfogadott értékek: false, true
Alapértelmezett érték: False
--platform

A platform, ahol a build/feladat fut, pl. "windows" és "linux". Ha buildparancsokban használják, az "os/arch/variant" formátumban is megadható az eredményként kapott képhez. Pl.: linux/arm/v7. Az "arch" és a "variant" részek nem kötelezőek.

--pull-request-trigger-enabled

Azt jelzi, hogy engedélyezve van-e a forrásvezérlő lekéréses kérelem eseményindítója. Az eseményindító alapértelmezés szerint le van tiltva.

Elfogadott értékek: false, true
Alapértelmezett érték: False
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--schedule

A cron kifejezésként ábrázolt időzítő-eseményindító ütemezése. A választható eseményindító neve formátummal --schedule name:schedule adható meg. A többszörösök többszöri ütemezésének átadásával támogatottak.

--secret-arg

Titkos kód összeállítási argumentuma "--secret-arg name[=value]" formátumban. A többszörösöket a "--secret-arg name[=value]" többszöri átadásával támogatjuk. Ez a paraméterérték nem jelenik meg az ACR-csapat számára, és alkalmasabb bizalmas információkhoz.

--set

Tevékenységérték "--set name[=value]" formátumban. Többszörösek, amelyeket többször is megadhat.

--set-secret

Titkos feladat értéke "--set-secret name[=value]" formátumban. Többszörösök, amelyeket a --set-secret többszöri átadásával támogat.

--source-trigger-name

A forrásindító neve.

Alapértelmezett érték: defaultSourceTriggerName
--status

A tevékenység aktuális állapota.

Elfogadott értékek: Disabled, Enabled
Alapértelmezett érték: Enabled
--target

A cél buildelési szakaszának neve.

--timeout

Az időtúllépés másodpercben.

Alapértelmezett érték: 3600
--update-trigger-endpoint
Előnézet

A végpont teljes URL-címe az alaprendszerkép-frissítés eseményindító értesítéseinek fogadásához.

--update-trigger-payload-type
Előnézet

Azt jelzi, hogy az alaprendszerkép-eseményindító metaadatait a frissítési eseményindító jogkivonatával együtt adja-e hozzá a hasznos adatokhoz az értesítés küldésekor.

Elfogadott értékek: Default, Token
Alapértelmezett érték: Default
--values

A tevékenységértékek/paraméterek fájl elérési útja a forráskörnyezethez viszonyítva.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task delete

Szerkesztés

Tevékenység törlése egy Azure Container Registryből.

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

Példák

Tevékenység törlése egy Azure Container Registryből.

az acr task delete -n MyTask -r myregistry

Kötelező paraméterek

--name -n

A feladat neve.

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--yes -y

Ne kérje a megerősítést.

Alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task list

Szerkesztés

Az Azure Container Registry feladatainak listázása.

az acr task list --registry
                 [--resource-group]

Példák

Feladatok listázása és az eredmények megjelenítése egy táblában.

az acr task list -r myregistry -o table

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task list-runs

Szerkesztés

Listázhatja az Azure Container Registry összes végrehajtott futtatását, és szűrhet egy adott tevékenység alapján.

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

Példák

Listázz egy beállításjegyzék összes futtatását, és jelenítsd meg az eredményeket egy táblában.

az acr task list-runs -r myregistry -o table

A lista egy tevékenységhez fut, és megjeleníti az eredményeket egy táblában.

az acr task list-runs -r myregistry -n MyTask -o table

Sorolja fel a beállításjegyzék legutóbbi 10 sikeres futását, és jelenítse meg az eredményeket egy táblában.

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

Sorolja fel azokat a futtatásokat, amelyek létrehozták a "hello-world" rendszerképet egy beállításjegyzékhez, és megjelenítik az eredményeket egy táblában.

az acr task list-runs -r myregistry --image hello-world -o table

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--image -t

A kép neve. Tartalmazhat egy címkét a "name:tag" formátumban vagy a "name@digest" formátumban.

--name -n

A feladat neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--run-status

A futtatás aktuális állapota.

Elfogadott értékek: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Korlátozza a legutóbbi futtatások számát az eredményekben.

Alapértelmezett érték: 15
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task logs

Szerkesztés

Naplók megjelenítése egy adott futtatáshoz. Ha nincs megadva futtatási azonosító, az utolsó létrehozott futtatás naplóinak megjelenítése.

az acr task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

Példák

Az utolsó létrehozott futtatás naplóinak megjelenítése a beállításjegyzékben.

az acr task logs -r myregistry

A beállításjegyzékben legutóbb létrehozott futtatás naplóinak megjelenítése tevékenység szerint szűrve.

az acr task logs -r myregistry -n MyTask

Naplók megjelenítése egy adott futtatáshoz.

az acr task logs -r myregistry --run-id runId

Az utolsó létrehozott futtatás naplóinak megjelenítése a "hello-world" lemezképet létrehozó beállításjegyzékben.

az acr task logs -r myregistry --image hello-world

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--image -t

A kép neve. Tartalmazhat egy címkét a "name:tag" formátumban vagy a "name@digest" formátumban.

--name -n

A feladat neve.

--no-format

Azt jelzi, hogy a naplók nyers formátumban jelenjenek-e meg.

Alapértelmezett érték: False
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--run-id

Az egyedi futtatási azonosító.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task run

Szerkesztés

Manuálisan aktiválhat egy olyan feladatot, amely egyébként a Git véglegesítésére vagy az alaprendszerkép-frissítés eseményindítóira vár.

az acr task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

Példák

Tevékenységfuttatás aktiválása.

az acr task run -n MyTask -r myregistry

A feladat futtatásához felül kell bírálni a távoli tárházzal rendelkező Feladat létrehozása során átadott környezetet és fájlt.

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

Tevékenység aktiválása a helyi környezettel való létrehozás során átadott környezet és fájl felülírásával.

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

Tevékenység futtatásának aktiválása a Feladat létrehozása során beállított buildargumentumok hozzáadásával vagy felülírásával.

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Kötelező paraméterek

--name -n

A feladat neve.

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--agent-pool
Előnézet

Az ügynökkészlet neve.

--arg

Argumentum összeállítása "--arg name[=value]" formátumban. A többszörösöket a "--arg name[=value]" többszöri átadásával támogatjuk. FONTOS: Ez a paraméter nem tartalmazhat jelszavakat, hozzáférési jogkivonatokat vagy bizalmas információkat. Ez a paraméterérték hibakeresési célokból látható lesz az ACR-csapat számára.

--context -c

A forráskód-adattár teljes URL-címe (github-adattárhoz a ".git" utótag szükséges) vagy egy távoli tarball (pl. ""http://server/context.tar.gz), vagy egy OCI-összetevő adattára egy Azure-tárolóregisztrációs adatbázisban (pl. "oci://myregistry.azurecr.io/myartifact:mytag"). Ha a "/dev/null" érték meg van adva, az érték Nincs értékre lesz állítva, és figyelmen kívül lesz hagyva. Ez kötelező argumentum, ha a tevékenység nem rendszerfeladat.

--file -f

A feladat/docker fájl relatív elérési útja a forráskód gyökérmappájába. A feladatfájlokat a ".yaml" utótaggal kell utótaggal elválasztani, vagy a standard bemenetből a "-" használatával kell beszúrni.

--log-template
Előnézet

A naplóösszetevő futtatásához használt adattár és címkesablon a következő formátumban: "log/repo:tag" (pl. "acr/logs:{.Run.ID}}"). Csak a CMK-kompatibilis beállításjegyzékre alkalmazható.

--no-format

Azt jelzi, hogy a naplók nyers formátumban jelenjenek-e meg.

Alapértelmezett érték: False
--no-logs

A build sikeres sorban állása után ne jelenjenek meg naplók.

Alapértelmezett érték: False
--no-wait

Ne várja meg, amíg a futtatás befejeződik, és a futtatás sorba helyezése után azonnal visszatér.

Alapértelmezett érték: False
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--secret-arg

Titkos kód összeállítási argumentuma "--secret-arg name[=value]" formátumban. A többszörösöket a "--secret-arg name[=value]" többszöri átadásával támogatjuk. Ez a paraméterérték nem jelenik meg az ACR-csapat számára, és alkalmasabb bizalmas információkhoz.

--set

Tevékenységérték "--set name[=value]" formátumban. Többszörösek, amelyeket többször is megadhat.

--set-secret

Titkos feladat értéke "--set-secret name[=value]" formátumban. Többszörösök, amelyeket a --set-secret többszöri átadásával támogat.

--target

A cél buildelési szakaszának neve.

--update-trigger-token
Előnézet

A rendszerkép-eseményindító értesítésével együtt visszaadott hasznos adat.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task show

Szerkesztés

Az Azure Container Registry nevesített feladatának tulajdonságainak lekérése.

az acr task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

Példák

Lekérheti egy tevékenység tulajdonságait, és megjelenítheti az eredményeket egy táblában.

az acr task show -n MyTask -r myregistry -o table

Lekérheti egy feladat tulajdonságait, beleértve a biztonságos tulajdonságokat is.

az acr task show -n MyTask -r myregistry --with-secure-properties

Kötelező paraméterek

--name -n

A feladat neve.

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--with-secure-properties

Azt jelzi, hogy a feladat biztonságos tulajdonságait vissza kell-e adni.

Alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task show-run

Szerkesztés

Az Azure Container Registry-feladat megadott futtatásának tulajdonságainak lekérése.

az acr task show-run --registry
                     --run-id
                     [--resource-group]

Példák

Lekérheti a futtatás részleteit, és megjelenítheti az eredményeket egy táblában.

az acr task show-run -r myregistry --run-id runId -o table

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

--run-id

Az egyedi futtatási azonosító.

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task update

Szerkesztés

Azure Container Registry-feladat frissítése.

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Példák

Frissítse az alaprendszerkép-frissítéseket, hogy aktiválja a többfázisú dockerfile összes függő lemezképét, valamint egy feladat állapotát egy Azure Container Registryben.

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

Frissítse a platformot a feladat buildelési lépéséhez Windowsra (linux előtti).

az acr task update -n MyTask -r myregistry --platform Windows

Az Azure Container Registry eseményindítóinak és környezetének frissítése.

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

Azure Container Registry-feladat frissítése. (automatikusan létrehozott)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

Kötelező paraméterek

--name -n

A feladat neve.

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

Opcionális paraméterek

--agent-pool
Előnézet

Az ügynökkészlet neve.

--arg

Argumentum összeállítása "--arg name[=value]" formátumban. A többszörösöket a "--arg name[=value]" többszöri átadásával támogatjuk. FONTOS: Ez a paraméter nem tartalmazhat jelszavakat, hozzáférési jogkivonatokat vagy bizalmas információkat. Ez a paraméterérték hibakeresési célokból látható lesz az ACR-csapat számára.

--auth-mode

A forrásregisztrációs adatbázis hitelesítési módja.

Elfogadott értékek: Default, None
--base-image-trigger-enabled

Azt jelzi, hogy az alaprendszerkép-eseményindító engedélyezve van-e.

Elfogadott értékek: false, true
--base-image-trigger-type

Az alaprendszerkép-függőségi frissítések automatikus eseményindítójának típusa.

Elfogadott értékek: All, Runtime
--cmd

Végrehajtandó parancsok. Ez további Docker-futtatási paramétereket (https://docs.docker.com/engine/reference/commandline/run/) vagy akár más docker-parancsokat (https://docs.docker.com/engine/reference/commandline/docker/) is támogat.

--commit-trigger-enabled

Azt jelzi, hogy a forrásvezérlő véglegesítési eseményindítója engedélyezve van-e.

Elfogadott értékek: false, true
--context -c

A forráskód-adattár teljes URL-címe (github-adattárhoz a ".git" utótag szükséges) vagy egy távoli tarball (pl. ""http://server/context.tar.gz), vagy egy OCI-összetevő adattára egy Azure-tárolóregisztrációs adatbázisban (pl. "oci://myregistry.azurecr.io/myartifact:mytag"). Ha a "/dev/null" érték meg van adva, az érték Nincs értékre lesz állítva, és figyelmen kívül lesz hagyva. Ez kötelező argumentum, ha a tevékenység nem rendszerfeladat.

--cpu

A processzorkonfiguráció a futtatáshoz szükséges magok számát tekintve.

--file -f

A feladat/docker fájl relatív elérési útja a forráskód gyökérmappájába. A feladatfájlokat a ".yaml" utótaggal kell utótaggal elválasztani, vagy a standard bemenetből a "-" használatával kell beszúrni.

--git-access-token

A forrásvezérlő szolgáltatóhoz való hozzáféréshez használt hozzáférési jogkivonat.

--image -t

A kép neve és címkéje a következő formátumban: '-t repo/image:tag'. A -t többszöri átadásával több címke is támogatott.

--log-template
Előnézet

A naplóösszetevő futtatásához használt adattár és címkesablon a következő formátumban: "log/repo:tag" (pl. "acr/logs:{.Run.ID}}"). Csak a CMK-kompatibilis beállításjegyzékre alkalmazható.

--no-cache

Azt jelzi, hogy a képgyorsítótár engedélyezve van-e.

Elfogadott értékek: false, true
--no-push

Azt jelzi, hogy a létrehozott rendszerképet le kell-e küldeni a beállításjegyzékbe.

Elfogadott értékek: false, true
--platform

A platform, ahol a build/feladat fut, pl. "windows" és "linux". Ha buildparancsokban használják, az "os/arch/variant" formátumban is megadható az eredményként kapott képhez. Pl.: linux/arm/v7. Az "arch" és a "variant" részek nem kötelezőek.

--pull-request-trigger-enabled

Azt jelzi, hogy engedélyezve van-e a forrásvezérlő lekéréses kérelem eseményindítója. Az eseményindító alapértelmezés szerint le van tiltva.

Elfogadott értékek: false, true
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--secret-arg

Titkos kód összeállítási argumentuma "--secret-arg name[=value]" formátumban. A többszörösöket a "--secret-arg name[=value]" többszöri átadásával támogatjuk. Ez a paraméterérték nem jelenik meg az ACR-csapat számára, és alkalmasabb bizalmas információkhoz.

--set

Tevékenységérték "--set name[=value]" formátumban. Többszörösek, amelyeket többször is megadhat.

--set-secret

Titkos feladat értéke "--set-secret name[=value]" formátumban. Többszörösök, amelyeket a --set-secret többszöri átadásával támogat.

--status

A tevékenység aktuális állapota.

Elfogadott értékek: Disabled, Enabled
--target

A cél buildelési szakaszának neve.

--timeout

Az időtúllépés másodpercben.

--update-trigger-endpoint
Előnézet

A végpont teljes URL-címe az alaprendszerkép-frissítés eseményindító értesítéseinek fogadásához.

--update-trigger-payload-type
Előnézet

Azt jelzi, hogy az alaprendszerkép-eseményindító metaadatait a frissítési eseményindító jogkivonatával együtt adja-e hozzá a hasznos adatokhoz az értesítés küldésekor.

Elfogadott értékek: Default, Token
--values

A tevékenységértékek/paraméterek fájl elérési útja a forráskörnyezethez viszonyítva.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az acr task update-run

Szerkesztés

Egy Azure Container Registry-feladat futtatási tulajdonságainak javítása.

az acr task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

Példák

Meglévő futtatás frissítése archiválásra.

az acr task update-run -r myregistry --run-id runId --no-archive false

Kötelező paraméterek

--registry -r

A tárolóregisztrációs adatbázis neve. Ezt kisbetűben kell megadni. Az alapértelmezett beállításjegyzék-nevet a következővel az configure --defaults acr=<registry name>konfigurálhatja: .

--run-id

Az egyedi futtatási azonosító.

Opcionális paraméterek

--no-archive

Azt jelzi, hogy a futtatás archiválva legyen-e.

Elfogadott értékek: false, true
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
Alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.