az acr task

Zarządzanie kolekcją kroków tworzenia, testowania i stosowania poprawek obrazów kontenerów przy użyciu rejestrów kontenerów platformy Azure oraz zarządzania nimi.

Polecenia

Nazwa Opis Typ Stan
az acr task cancel-run

Anuluj określony przebieg usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task create

Utwórz serię kroków tworzenia, testowania i tworzenia kontenerów poprawek systemu operacyjnego i struktury. Zadania obsługują wyzwalacze z zatwierdzeń usługi Git i aktualizacji obrazu podstawowego.

Podstawowe funkcje Ogólna dostępność
az acr task credential

Zarządzanie poświadczeniami zadania. Aby uzyskać więcej informacji, zobacz https://aka.ms/acr/tasks/cross-registry-authentication.

Podstawowe funkcje Ogólna dostępność
az acr task credential add

Dodaj do zadania niestandardowe poświadczenia logowania rejestru.

Podstawowe funkcje Ogólna dostępność
az acr task credential list

Wyświetl listę wszystkich poświadczeń rejestru niestandardowego dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task credential remove

Usuń poświadczenia dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task credential update

Zaktualizuj poświadczenia logowania rejestru dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task delete

Usuń zadanie z usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task identity

Tożsamości zarządzane dla zadania. Aby uzyskać więcej informacji, zobacz https://aka.ms/acr/tasks/task-create-managed-identity.

Podstawowe funkcje Ogólna dostępność
az acr task identity assign

Zaktualizuj tożsamość zarządzaną dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task identity remove

Usuwanie tożsamości zarządzanych dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task identity show

Wyświetl tożsamości zarządzane dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task list

Wyświetl listę zadań usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task list-runs

Wyświetl listę wszystkich wykonanych przebiegów dla usługi Azure Container Registry z możliwością filtrowania według określonego zadania.

Podstawowe funkcje Ogólna dostępność
az acr task logs

Pokaż dzienniki dla określonego przebiegu. Jeśli nie podano identyfikatora przebiegu, pokaż dzienniki dla ostatniego utworzonego przebiegu.

Podstawowe funkcje Ogólna dostępność
az acr task run

Ręcznie wyzwól zadanie, które w przeciwnym razie może oczekiwać na zatwierdzenia git lub wyzwalacze aktualizacji obrazu podstawowego.

Podstawowe funkcje Ogólna dostępność
az acr task show

Pobierz właściwości nazwanego zadania dla usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task show-run

Pobierz właściwości określonego przebiegu zadania usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task timer

Zarządzanie wyzwalaczami czasomierza dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task timer add

Dodaj wyzwalacz czasomierza do zadania.

Podstawowe funkcje Ogólna dostępność
az acr task timer list

Wyświetl listę wszystkich wyzwalaczy czasomierza dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task timer remove

Usuń wyzwalacz czasomierza z zadania.

Podstawowe funkcje Ogólna dostępność
az acr task timer update

Zaktualizuj wyzwalacz czasomierza dla zadania.

Podstawowe funkcje Ogólna dostępność
az acr task update

Aktualizowanie zadania dla usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność
az acr task update-run

Poprawianie właściwości przebiegu zadania usługi Azure Container Registry.

Podstawowe funkcje Ogólna dostępność

az acr task cancel-run

Anuluj określony przebieg usługi Azure Container Registry.

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

Przykłady

Anulowanie przebiegu

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

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

--run-id

Unikatowy identyfikator przebiegu.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task create

Utwórz serię kroków tworzenia, testowania i tworzenia kontenerów poprawek systemu operacyjnego i struktury. Zadania obsługują wyzwalacze z zatwierdzeń usługi Git i aktualizacji obrazu podstawowego.

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]

Przykłady

Utwórz zadanie bez lokalizacji źródłowej.

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

Utwórz zadanie z definicją na podstawie standardowych danych wejściowych i z wyzwalaczem czasomierza, który uruchamia zadanie w górnej części każdej godziny przy użyciu domyślnej nazwy wyzwalacza. Polecenie "Ctrl + Z"(Windows) lub "Ctrl + D" (Linux) kończy strumień wejściowy.

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 * * *"

Utwórz zadanie systemu Linux z publicznego repozytorium GitHub, które kompiluje obraz hello-world bez wyzwalaczy i używa argumentu kompilacji.

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

Utwórz zadanie systemu Linux przy użyciu określonej gałęzi prywatnego repozytorium Usługi Azure DevOps, które kompiluje obraz hello-world w architekturze arm (wariant V7) i ma włączone wyzwalacze.

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

Utwórz zadanie systemu Linux na podstawie publicznego repozytorium GitHub, które kompiluje obraz hello-world z włączonym wyzwalaczem zatwierdzenia git i żądania ściągnięcia. Należy pamiętać, że to zadanie nie używa rejestru źródłowego (myregistry), więc możemy jawnie ustawić tryb uwierzytelniania jako Brak.

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

Utwórz zadanie systemu Windows z publicznego repozytorium GitHub, które kompiluje obraz narzędzia Azure Container Builder w architekturze Amd64 z włączonym tylko wyzwalaczem obrazu podstawowego.

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

Utwórz zadanie wieloetapowe systemu Linux z publicznego repozytorium GitHub z tożsamościami zarządzanymi przypisanymi przez system i przypisanymi przez użytkownika tożsamościami zarządzanymi oraz obrazem podstawowym, zatwierdzeniem git, żądaniem ściągnięcia i wyzwalaczami czasomierza, które uruchamiają zadanie w południe w poniedziałek do piątków z podaną nazwą wyzwalacza czasomierza.

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

Parametry wymagane

--name -n

Nazwa zadania.

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--agent-pool
Wersja zapoznawcza

Nazwa puli agentów.

--arg

Argument kompilacji w formacie "--arg name[=value]". Multiples obsługiwane przez przekazywanie "--arg" wiele razy.

--assign-identity

Przypisuje tożsamości zarządzane do zadania. Użyj polecenia "[system]", aby odwołać się do tożsamości przypisanej przez system lub identyfikatora zasobu w celu odwoływania się do tożsamości przypisanej przez użytkownika. Aby uzyskać więcej informacji, zobacz https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Tryb uwierzytelniania rejestru źródłowego.

akceptowane wartości: Default, None
--base-image-trigger-enabled

Wskazuje, czy wyzwalacz obrazu podstawowego jest włączony.

akceptowane wartości: false, true
wartość domyślna: True
--base-image-trigger-name

Nazwa wyzwalacza obrazu podstawowego.

wartość domyślna: defaultBaseimageTriggerName
--base-image-trigger-type

Typ wyzwalacza automatycznego aktualizacji zależności obrazu podstawowego.

akceptowane wartości: All, Runtime
wartość domyślna: Runtime
--cmd

Polecenia do wykonania. Obsługuje to również dodatkowe parametry uruchamiania platformy Docker (https://docs.docker.com/engine/reference/commandline/run/) lub nawet inne polecenia platformy Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Wskazuje, czy wyzwalacz zatwierdzenia kontroli źródła jest włączony.

akceptowane wartości: false, true
wartość domyślna: True
--context -c

Pełny adres URL repozytorium kodu źródłowego (wymaga sufiksu ".git" dla repozytorium github) lub zdalnego tarballa (np. "http://server/context.tar.gz") lub repozytorium artefaktu OCI w rejestrze kontenerów platformy Azure (np. "oci://myregistry.azurecr.io/myartifact:mytag"). Jeśli określono wartość "/dev/null", wartość zostanie ustawiona na Wartość Brak i zignorowana. Jest to argument wymagany, jeśli zadanie nie jest zadaniem systemowym.

--cpu

Konfiguracja procesora CPU pod względem liczby rdzeni wymaganych do uruchomienia.

wartość domyślna: 2
--file -f

Względna ścieżka pliku task/docker do folderu głównego kodu źródłowego. Pliki zadań muszą być sufiksem ".yaml" lub przesyłane potokowo ze standardowych danych wejściowych przy użyciu polecenia "-".

--git-access-token

Token dostępu używany do uzyskiwania dostępu do dostawcy kontroli źródła.

--image -t

Nazwa i tag obrazu przy użyciu formatu: '-t repo/image:tag'. Wiele tagów jest obsługiwanych przez przekazywanie -t wiele razy.

--is-system-task
Wersja zapoznawcza

Wskazuje, czy zasób zadania jest zadaniem systemowym. Nazwa zadania musi być "quicktask". Dotyczy tylko rejestru z włączonym kluczem cmK.

wartość domyślna: False
--log-template
Wersja zapoznawcza

Szablon repozytorium i tagu do uruchamiania artefaktu dziennika przy użyciu formatu "log/repo:tag" (np. "acr/logs:{.Run.ID}}"). Dotyczy tylko rejestru z włączonym kluczem cmK.

--no-cache

Wskazuje, czy pamięć podręczna obrazów jest włączona.

akceptowane wartości: false, true
wartość domyślna: False
--no-push

Wskazuje, czy skompilowany obraz powinien zostać wypchnięty do rejestru.

akceptowane wartości: false, true
wartość domyślna: False
--platform

Platforma, na której jest uruchamiana kompilacja/zadanie, np. "windows" i "linux". Gdy jest używany w poleceniach kompilacji, można go również określić w formacie "os/arch/variant" dla obrazu wynikowego. Np. linux/arm/v7. Części "arch" i "variant" są opcjonalne.

--pull-request-trigger-enabled

Wskazuje, czy wyzwalacz żądania ściągnięcia kontroli źródła jest włączony. Wyzwalacz jest domyślnie wyłączony.

akceptowane wartości: false, true
wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--schedule

Harmonogram wyzwalacza czasomierza reprezentowanego jako wyrażenie cron. Opcjonalnie można określić nazwę wyzwalacza przy użyciu --schedule name:schedule formatu. Multiples obsługiwane przez przekazywanie --schedule wiele razy.

--secret-arg

Argument kompilacji wpisu tajnego w formacie "--secret-arg name[=value]". Multiples obsługiwane przez przekazywanie --secret-arg wiele razy.

--set

Wartość zadania w formacie "--set name[=value]". Multiples obsługiwane przez przekazywanie --set wiele razy.

--set-secret

Wartość zadania tajnego w formacie "--set-secret name[=value]". Multiples obsługiwane przez przekazywanie --set-secret wiele razy.

--source-trigger-name

Nazwa wyzwalacza źródłowego.

wartość domyślna: defaultSourceTriggerName
--status

Bieżący stan zadania.

akceptowane wartości: Disabled, Enabled
wartość domyślna: Enabled
--target

Nazwa docelowego etapu kompilacji.

--timeout

Limit czasu w sekundach.

wartość domyślna: 3600
--update-trigger-endpoint
Wersja zapoznawcza

Pełny adres URL punktu końcowego do odbierania powiadomień wyzwalacza aktualizacji obrazu podstawowego.

--update-trigger-payload-type
Wersja zapoznawcza

Wskazuje, czy po wysłaniu powiadomienia należy uwzględnić metadane dotyczące wyzwalacza obrazu podstawowego w ładunku wraz z tokenem wyzwalacza aktualizacji.

akceptowane wartości: Default, Token
wartość domyślna: Default
--values

Ścieżka pliku wartości/parametrów zadania względem kontekstu źródłowego.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task delete

Usuń zadanie z usługi Azure Container Registry.

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

Przykłady

Usuń zadanie z usługi Azure Container Registry.

az acr task delete -n MyTask -r myregistry

Parametry wymagane

--name -n

Nazwa zadania.

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--yes -y

Nie monituj o potwierdzenie.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task list

Wyświetl listę zadań usługi Azure Container Registry.

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

Przykłady

Wyświetl listę zadań i pokaż wyniki w tabeli.

az acr task list -r myregistry -o table

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task list-runs

Wyświetl listę wszystkich wykonanych przebiegów dla usługi Azure Container Registry z możliwością filtrowania według określonego zadania.

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

Przykłady

Wyświetl listę wszystkich przebiegów dla rejestru i pokaż wyniki w tabeli.

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

Lista jest uruchamiana dla zadania i pokazuje wyniki w tabeli.

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

Wyświetl listę ostatnich 10 pomyślnych przebiegów dla rejestru i pokaż wyniki w tabeli.

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

Wyświetl listę wszystkich przebiegów, które utworzyły obraz "hello-world" dla rejestru i pokazują wyniki w tabeli.

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

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--image -t

Nazwa obrazu. Może zawierać tag w formacie "name:tag" lub skrót w formacie "name@digest".

--name -n

Nazwa zadania.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--run-status

Bieżący stan przebiegu.

akceptowane wartości: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Ogranicz liczbę najnowszych przebiegów w wynikach.

wartość domyślna: 15
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task logs

Pokaż dzienniki dla określonego przebiegu. Jeśli nie podano identyfikatora przebiegu, pokaż dzienniki dla ostatniego utworzonego przebiegu.

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

Przykłady

Pokaż dzienniki ostatniego utworzonego przebiegu w rejestrze.

az acr task logs -r myregistry

Pokaż dzienniki ostatniego utworzonego przebiegu w rejestrze odfiltrowane według zadania.

az acr task logs -r myregistry -n MyTask

Pokaż dzienniki dla określonego przebiegu.

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

Pokaż dzienniki ostatniego utworzonego przebiegu w rejestrze, który utworzył obraz "hello-world".

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

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--image -t

Nazwa obrazu. Może zawierać tag w formacie "name:tag" lub skrót w formacie "name@digest".

--name -n

Nazwa zadania.

--no-format

Wskazuje, czy dzienniki powinny być wyświetlane w formacie nieprzetworzonym.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--run-id

Unikatowy identyfikator przebiegu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task run

Ręcznie wyzwól zadanie, które w przeciwnym razie może oczekiwać na zatwierdzenia git lub wyzwalacze aktualizacji obrazu podstawowego.

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]

Przykłady

Wyzwalanie uruchomienia zadania.

az acr task run -n MyTask -r myregistry

Wyzwalanie uruchomienia zadania przez zastąpienie kontekstu i pliku przekazanego podczas tworzenia zadania za pomocą repozytorium zdalnego.

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

Wyzwalanie uruchomienia zadania przez zastąpienie kontekstu i pliku przekazanego podczas tworzenia zadania przy użyciu kontekstu lokalnego.

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

Wyzwalanie przebiegu zadania przez dodanie lub zastąpienie argumentów kompilacji ustawionych podczas tworzenia zadania.

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

Parametry wymagane

--name -n

Nazwa zadania.

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--agent-pool
Wersja zapoznawcza

Nazwa puli agentów.

--arg

Argument kompilacji w formacie "--arg name[=value]". Multiples obsługiwane przez przekazywanie "--arg" wiele razy.

--context -c

Pełny adres URL repozytorium kodu źródłowego (wymaga sufiksu ".git" dla repozytorium github) lub zdalnego tarballa (np. "http://server/context.tar.gz") lub repozytorium artefaktu OCI w rejestrze kontenerów platformy Azure (np. "oci://myregistry.azurecr.io/myartifact:mytag"). Jeśli określono wartość "/dev/null", wartość zostanie ustawiona na Wartość Brak i zignorowana. Jest to argument wymagany, jeśli zadanie nie jest zadaniem systemowym.

--file -f

Względna ścieżka pliku task/docker do folderu głównego kodu źródłowego. Pliki zadań muszą być sufiksem ".yaml" lub przesyłane potokowo ze standardowych danych wejściowych przy użyciu polecenia "-".

--log-template
Wersja zapoznawcza

Szablon repozytorium i tagu do uruchamiania artefaktu dziennika przy użyciu formatu "log/repo:tag" (np. "acr/logs:{.Run.ID}}"). Dotyczy tylko rejestru z włączonym kluczem cmK.

--no-format

Wskazuje, czy dzienniki powinny być wyświetlane w formacie nieprzetworzonym.

wartość domyślna: False
--no-logs

Nie pokazuj dzienników po pomyślnym kolejce kompilacji.

wartość domyślna: False
--no-wait

Nie czekaj na ukończenie przebiegu i wróć natychmiast po kolejce przebiegu.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--secret-arg

Argument kompilacji wpisu tajnego w formacie "--secret-arg name[=value]". Multiples obsługiwane przez przekazywanie --secret-arg wiele razy.

--set

Wartość zadania w formacie "--set name[=value]". Multiples obsługiwane przez przekazywanie --set wiele razy.

--set-secret

Wartość zadania tajnego w formacie "--set-secret name[=value]". Multiples obsługiwane przez przekazywanie --set-secret wiele razy.

--target

Nazwa docelowego etapu kompilacji.

--update-trigger-token
Wersja zapoznawcza

Ładunek, który zostanie przekazany z powrotem wraz z powiadomieniem wyzwalacza obrazu podstawowego.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task show

Pobierz właściwości nazwanego zadania dla usługi Azure Container Registry.

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

Przykłady

Pobierz właściwości zadania, wyświetlając wyniki w tabeli.

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

Pobierz właściwości zadania, w tym bezpieczne właściwości.

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

Parametry wymagane

--name -n

Nazwa zadania.

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--with-secure-properties

Wskazuje, czy powinny zostać zwrócone bezpieczne właściwości zadania.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task show-run

Pobierz właściwości określonego przebiegu zadania usługi Azure Container Registry.

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

Przykłady

Pobierz szczegóły przebiegu, wyświetlając wyniki w tabeli.

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

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

--run-id

Unikatowy identyfikator przebiegu.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task update

Aktualizowanie zadania dla usługi Azure Container Registry.

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]

Przykłady

Aktualizacja aktualizacji obrazu podstawowego w celu wyzwolenia wszystkich zależnych obrazów wieloetapowego pliku dockerfile oraz stanu zadania w usłudze Azure Container Registry.

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

Zaktualizuj platformę dla kroku kompilacji zadania do systemu Windows (wersja wstępna systemu Linux).

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

Zaktualizuj wyzwalacze i kontekst zadania dla usługi Azure Container Registry.

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

Aktualizowanie zadania dla usługi Azure Container Registry. (automatycznie wygenerowane)

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

Parametry wymagane

--name -n

Nazwa zadania.

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

Parametry opcjonalne

--agent-pool
Wersja zapoznawcza

Nazwa puli agentów.

--arg

Argument kompilacji w formacie "--arg name[=value]". Multiples obsługiwane przez przekazywanie "--arg" wiele razy.

--auth-mode

Tryb uwierzytelniania rejestru źródłowego.

akceptowane wartości: Default, None
--base-image-trigger-enabled

Wskazuje, czy wyzwalacz obrazu podstawowego jest włączony.

akceptowane wartości: false, true
--base-image-trigger-type

Typ wyzwalacza automatycznego aktualizacji zależności obrazu podstawowego.

akceptowane wartości: All, Runtime
--cmd

Polecenia do wykonania. Obsługuje to również dodatkowe parametry uruchamiania platformy Docker (https://docs.docker.com/engine/reference/commandline/run/) lub nawet inne polecenia platformy Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Wskazuje, czy wyzwalacz zatwierdzenia kontroli źródła jest włączony.

akceptowane wartości: false, true
--context -c

Pełny adres URL repozytorium kodu źródłowego (wymaga sufiksu ".git" dla repozytorium github) lub zdalnego tarballa (np. "http://server/context.tar.gz") lub repozytorium artefaktu OCI w rejestrze kontenerów platformy Azure (np. "oci://myregistry.azurecr.io/myartifact:mytag"). Jeśli określono wartość "/dev/null", wartość zostanie ustawiona na Wartość Brak i zignorowana. Jest to argument wymagany, jeśli zadanie nie jest zadaniem systemowym.

--cpu

Konfiguracja procesora CPU pod względem liczby rdzeni wymaganych do uruchomienia.

--file -f

Względna ścieżka pliku task/docker do folderu głównego kodu źródłowego. Pliki zadań muszą być sufiksem ".yaml" lub przesyłane potokowo ze standardowych danych wejściowych przy użyciu polecenia "-".

--git-access-token

Token dostępu używany do uzyskiwania dostępu do dostawcy kontroli źródła.

--image -t

Nazwa i tag obrazu przy użyciu formatu: '-t repo/image:tag'. Wiele tagów jest obsługiwanych przez przekazywanie -t wiele razy.

--log-template
Wersja zapoznawcza

Szablon repozytorium i tagu do uruchamiania artefaktu dziennika przy użyciu formatu "log/repo:tag" (np. "acr/logs:{.Run.ID}}"). Dotyczy tylko rejestru z włączonym kluczem cmK.

--no-cache

Wskazuje, czy pamięć podręczna obrazów jest włączona.

akceptowane wartości: false, true
--no-push

Wskazuje, czy skompilowany obraz powinien zostać wypchnięty do rejestru.

akceptowane wartości: false, true
--platform

Platforma, na której jest uruchamiana kompilacja/zadanie, np. "windows" i "linux". Gdy jest używany w poleceniach kompilacji, można go również określić w formacie "os/arch/variant" dla obrazu wynikowego. Np. linux/arm/v7. Części "arch" i "variant" są opcjonalne.

--pull-request-trigger-enabled

Wskazuje, czy wyzwalacz żądania ściągnięcia kontroli źródła jest włączony. Wyzwalacz jest domyślnie wyłączony.

akceptowane wartości: false, true
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--secret-arg

Argument kompilacji wpisu tajnego w formacie "--secret-arg name[=value]". Multiples obsługiwane przez przekazywanie --secret-arg wiele razy.

--set

Wartość zadania w formacie "--set name[=value]". Multiples obsługiwane przez przekazywanie --set wiele razy.

--set-secret

Wartość zadania tajnego w formacie "--set-secret name[=value]". Multiples obsługiwane przez przekazywanie --set-secret wiele razy.

--status

Bieżący stan zadania.

akceptowane wartości: Disabled, Enabled
--target

Nazwa docelowego etapu kompilacji.

--timeout

Limit czasu w sekundach.

--update-trigger-endpoint
Wersja zapoznawcza

Pełny adres URL punktu końcowego do odbierania powiadomień wyzwalacza aktualizacji obrazu podstawowego.

--update-trigger-payload-type
Wersja zapoznawcza

Wskazuje, czy po wysłaniu powiadomienia należy uwzględnić metadane dotyczące wyzwalacza obrazu podstawowego w ładunku wraz z tokenem wyzwalacza aktualizacji.

akceptowane wartości: Default, Token
--values

Ścieżka pliku wartości/parametrów zadania względem kontekstu źródłowego.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az acr task update-run

Poprawianie właściwości przebiegu zadania usługi Azure Container Registry.

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

Przykłady

Zaktualizuj istniejący przebieg do zarchiwizowania.

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

Parametry wymagane

--registry -r

Nazwa rejestru kontenerów. Należy go określić w małych literach. Domyślną nazwę rejestru można skonfigurować przy użyciu polecenia az configure --defaults acr=<registry name>.

--run-id

Unikatowy identyfikator przebiegu.

Parametry opcjonalne

--no-archive

Wskazuje, czy przebieg powinien być zarchiwizowany.

akceptowane wartości: false, true
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.