az container

Verwalten sie Azure Container Instances.

Befehle

az container app

Befehle zum Verwalten Azure Container Instances App.

az container app up

Stellen Sie bereit, um Azure Container Instances GitHub Actions zu verwenden.

az container attach

Fügen Sie lokale Standardausgabe und Fehlerströme an einen Container in einer Containergruppe an. Dieser Befehl stellt Diagnoseinformationen während des Containerstarts bereit. Nachdem der Container gestartet wurde, werden STDOUT und STDERR auf Ihre lokale Konsole gestreamt.

az container create

Erstellen Sie eine Containergruppe.

az container delete

Löschen einer Containergruppe.

az container exec

Führen Sie einen Befehl aus einem ausgeführten Container einer Containergruppe aus.

az container export

Exportieren einer Containergruppe im Yaml-Format.

az container list

Listencontainergruppen.

az container logs

Untersuchen Sie die Protokolle für einen Container in einer Containergruppe.

az container restart

Startet alle Container in einer Containergruppe neu.

az container show

Rufen Sie die Details einer Containergruppe ab.

az container start

Startet alle Container in einer Containergruppe.

az container stop

Beendet alle Container in einer Containergruppe.

az container attach

Fügen Sie lokale Standardausgabe und Fehlerströme an einen Container in einer Containergruppe an. Dieser Befehl stellt Diagnoseinformationen während des Containerstarts bereit. Nachdem der Container gestartet wurde, werden STDOUT und STDERR auf Ihre lokale Konsole gestreamt.

az container attach [--container-name]
                    [--ids]
                    [--name]
                    [--resource-group]

Beispiele

Fügen Sie lokale Standardausgabe und Fehlerströme an einen Container in einer Containergruppe an. (automatisch generiert)

az container attach --name MyContainerGroup --resource-group MyResourceGroup

Optionale Parameter

--container-name

Der Zufügende Container. Wenn nicht angegeben, wird der erste Container in der Containergruppe ausgewählt.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container create

Erstellen Sie eine Containergruppe.

az container create --resource-group
                    [--acr-identity]
                    [--assign-identity]
                    [--azure-file-volume-account-key]
                    [--azure-file-volume-account-name]
                    [--azure-file-volume-mount-path]
                    [--azure-file-volume-share-name]
                    [--command-line]
                    [--cpu]
                    [--dns-name-label]
                    [--environment-variables]
                    [--file]
                    [--gitrepo-dir]
                    [--gitrepo-mount-path]
                    [--gitrepo-revision]
                    [--gitrepo-url]
                    [--image]
                    [--ip-address {Private, Public}]
                    [--location]
                    [--log-analytics-workspace]
                    [--log-analytics-workspace-key]
                    [--memory]
                    [--name]
                    [--no-wait]
                    [--os-type {Linux, Windows}]
                    [--ports]
                    [--protocol {TCP, UDP}]
                    [--registry-login-server]
                    [--registry-password]
                    [--registry-username]
                    [--restart-policy {Always, Never, OnFailure}]
                    [--role]
                    [--scope]
                    [--secrets]
                    [--secrets-mount-path]
                    [--secure-environment-variables]
                    [--subnet]
                    [--subnet-address-prefix]
                    [--vnet]
                    [--vnet-address-prefix]
                    [--vnet-name]
                    [--zone]

Beispiele

Erstellen Sie einen Container in einer Containergruppe mit 1 Kern und 1 Gb Arbeitsspeicher.

az container create -g MyResourceGroup --name myapp --image myimage:latest --cpu 1 --memory 1

Erstellen Sie einen Container in einer Containergruppe, die Windows ausführt, mit 2 Kernen und 3,5 Gb Arbeitsspeicher.

az container create -g MyResourceGroup --name mywinapp --image winappimage:latest --os-type Windows --cpu 2 --memory 3.5

Erstellen Sie einen Container in einer Containergruppe mit öffentlicher IP-Adresse, Ports und DNS-Namenbezeichnung.

az container create -g MyResourceGroup --name myapp --image myimage:latest --ports 80 443 --dns-name-label contoso

Erstellen Sie einen Container in einer Containergruppe, die ein Skript beim Start aufruft.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "/bin/sh -c '/path to/myscript.sh'"

Erstellen Sie einen Container in einer Containergruppe, die einen Befehl ausführt, und beenden Sie den Container danach.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "echo hello" --restart-policy Never

Erstellen Sie einen Container in einer Containergruppe mit Umgebungsvariablen.

az container create -g MyResourceGroup --name myapp --image myimage:latest --environment-variables key1=value1 key2=value2

Erstellen Sie einen Container in einer Containergruppe mithilfe des Containerimages aus Azure Container Registry.

az container create -g MyResourceGroup --name myapp --image myAcrRegistry.azurecr.io/myimage:latest --registry-password password

Erstellen Sie einen Container in einer Containergruppe, die eine Azure-Dateifreigabe als Volume angibt.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/azfile/myfile" --azure-file-volume-share-name myshare --azure-file-volume-account-name mystorageaccount --azure-file-volume-account-key mystoragekey --azure-file-volume-mount-path /mnt/azfile

Erstellen Sie einen Container in einer Containergruppe, die ein Git-Repo als Volume angibt.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/gitrepo" --gitrepo-url https://github.com/user/myrepo.git --gitrepo-dir ./dir1 --gitrepo-mount-path /mnt/gitrepo

Erstellen Sie einen Container in einer Containergruppe mithilfe einer Yaml-Datei.

az container create -g MyResourceGroup -f containerGroup.yaml

Erstellen Sie eine Containergruppe mithilfe von Log Analytics aus einem Arbeitsbereichsnamen.

az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace

Erstellen Sie eine Containergruppe mit einer system zugewiesenen Identität.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity

Erstellen Sie eine Containergruppe mit einer system zugewiesenen Identität. Die Gruppe verfügt über eine Rolle "Mitwirkende" mit Zugriff auf ein Speicherkonto.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1

Erstellen Sie eine Containergruppe mit einer benutzer zugewiesenen Identität.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity  /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

Erstellen Sie eine Containergruppe mit system- und benutzer zugewiesener Identität.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity [system] /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--acr-identity

Die Identität mit Zugriff auf die Containerregistrierung.

--assign-identity

Leerzeichentrennte Liste der zugewiesenen Identitäten. Zugewiesene Identitäten sind entweder Benutzer zugewiesene Identitäten (Ressourcen-IDs) und /oder die system zugewiesene Identität ([System]'). Weitere Informationen finden Sie unter Beispielen.

--azure-file-volume-account-key

Der Zugriffsschlüssel des Speicherkontos, der für den Zugriff auf die Azure File-Freigabe verwendet wird.

--azure-file-volume-account-name

Der Name des Speicherkontos, das die Azure File-Freigabe enthält.

--azure-file-volume-mount-path

Der Pfad im Container, in dem das Azure-Dateivolume bereitgestellt werden soll. Darf kein Doppelpunkt ':' enthalten.

--azure-file-volume-share-name

Der Name der als Volume bereitzustellenden Azure File-Freigabe.

--command-line

Die Befehlszeile, die ausgeführt werden soll, wenn der Container gestartet wird, z. B. "/bin/bash -c myscript.sh".

--cpu

Die erforderliche Anzahl von CPU-Kernen der Container, genau auf einen Dezimalplatz.

Standardwert: 1
--dns-name-label

Die DNS-Namebezeichnung für die Containergruppe mit öffentlicher IP.

--environment-variables -e

Eine Liste der Umgebungsvariablen für den Container. Leerzeichentrennte Werte im Format 'key=value'.

--file -f

Der Pfad zur Eingabedatei.

--gitrepo-dir

Der Zielverzeichnispfad im Git-Repository. Darf ".." nicht enthalten.

Standardwert: .
--gitrepo-mount-path

Der Pfad innerhalb des Containers, in dem das Git-Repo-Volume bereitgestellt werden soll. Darf kein Doppelpunkt ':' enthalten.

--gitrepo-revision

Der Commit-Hash für die angegebene Überarbeitung.

--gitrepo-url

Die URL eines Git-Repositorys, das als Volume bereitgestellt werden soll.

--image

Der Containerimagename.

--ip-address

Der IP-Adressentyp der Containergruppe.

Zulässige Werte: Private, Public
--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--log-analytics-workspace

Der Name oder die ID des Log Analytics-Arbeitsbereichs. Verwenden Sie das aktuelle Abonnement oder das Kennzeichen "-Abonnement", um das gewünschte Abonnement festzulegen.

--log-analytics-workspace-key

Der Arbeitsbereichsschlüssel "Log Analytics".

--memory

Der erforderliche Speicher der Container in GB, genau an einer Dezimalstelle.

Standardwert: 1.5
--name -n

Der Name der Containergruppe.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--os-type

Der Betriebssystemtyp der Container.

Zulässige Werte: Linux, Windows
Standardwert: Linux
--ports

Eine Liste der zu öffnenden Ports. Leerzeichentrennte Liste der Ports.

Standardwert: [80]
--protocol

Das zu verwendende Netzwerkprotokoll.

Zulässige Werte: TCP, UDP
--registry-login-server

Der Anmeldeserver für containerimages.

--registry-password

Das Kennwort zum Anmelden des Containerimageregistrierungsservers.

--registry-username

Der Benutzername zum Anmelden des Containerimageregistrierungsservers.

--restart-policy

Neustartrichtlinie für alle Container innerhalb der Containergruppe.

Zulässige Werte: Always, Never, OnFailure
Standardwert: Always
--role

Der Rollenname oder die ID der zugewiesenen Systemidentität hat.

Standardwert: Contributor
--scope

Bereich, auf den die vom System zugewiesene Identität zugreifen kann.

--secrets

Leerzeichen getrennte Schlüssel im Format "key=value".

--secrets-mount-path

Der Pfad innerhalb des Containers, in dem das geheime Volume bereitgestellt werden soll. Darf keinen Doppelpunkt ':' enthalten.

--secure-environment-variables

Eine Liste der Variablen für sichere Umgebung für den Container. Leerzeichentrennte Werte im Format "key=value".

--subnet

Der Name des Subnetzs beim Erstellen eines neuen VNET oder verweisen auf eine vorhandene. Kann auch auf ein vorhandenes Subnetz nach ID verweisen.

--subnet-address-prefix

Das Subnetz-IP-Adresspräfix, das beim Erstellen eines neuen VNET im CIDR-Format verwendet werden soll.

Standardwert: 10.0.0.0/24
--vnet

Der Name des VNET beim Erstellen eines neuen oder verweisen auf ein vorhandenes. Kann auch auf ein vorhandenes vnet nach ID verweisen. Dies ermöglicht die Verwendung von vnets aus anderen Ressourcengruppen.

--vnet-address-prefix

Das IP-Adresspräfix, das beim Erstellen eines neuen VNET im CIDR-Format verwendet werden soll.

Standardwert: 10.0.0.0/16
--vnet-name

Der Name des VNET beim Erstellen eines neuen oder verweisen auf ein vorhandenes.

--zone

Die Zone, in der die Containergruppe platziert werden soll.

az container delete

Löschen einer Containergruppe.

az container delete [--ids]
                    [--name]
                    [--resource-group]
                    [--yes]

Beispiele

Löschen einer Containergruppe. (automatisch generiert)

az container delete --name MyContainerGroup --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

az container exec

Führen Sie einen Befehl aus einem ausgeführten Container einer Containergruppe aus.

Der am häufigsten verwendete Anwendungsfall besteht darin, eine interaktive Bash-Shell zu öffnen. Siehe folgende Beispiele.

az container exec --exec-command
                  [--container-name]
                  [--ids]
                  [--name]
                  [--resource-group]

Beispiele

Streamen Sie eine Shell aus einem nginx-Container.

az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"

Erforderliche Parameter

--exec-command

Der Befehl, der innerhalb des Containers ausgeführt werden soll.

Optionale Parameter

--container-name

Der Containername, in dem der Befehl ausgeführt werden soll. Kann für Containergruppen mit nur einem Container nicht angegeben werden.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container export

Exportieren einer Containergruppe im Yaml-Format.

az container export --file
                    [--ids]
                    [--name]
                    [--resource-group]

Beispiele

Exportieren einer Containergruppe in yaml.

az container export -g MyResourceGroup --name mynginx -f output.yaml

Erforderliche Parameter

--file -f

Der Dateipfad zum Exportieren der Containergruppe.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container list

Containergruppen auflisten.

az container list [--resource-group]

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container logs

Untersuchen Sie die Protokolle für einen Container in einer Containergruppe.

az container logs [--container-name]
                  [--follow]
                  [--ids]
                  [--name]
                  [--resource-group]

Beispiele

Untersuchen Sie die Protokolle für einen Container in einer Containergruppe. (automatisch generiert)

az container logs --name MyContainerGroup --resource-group MyResourceGroup

Optionale Parameter

--container-name

Der Containername, der die Protokolle abhält. Wenn nicht angegeben, wird der erste Container in der Containergruppe ausgewählt.

--follow

Geben Sie an, dass die Tailing-Protokolle gestreamt werden.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container restart

Startet alle Container in einer Containergruppe neu.

Startet alle Container in einer Containergruppe neu. Wenn das Containerimage Über Updates verfügt, wird ein neues Image heruntergeladen.

az container restart --name
                     --resource-group
                     [--no-wait]

Erforderliche Parameter

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az container show

Rufen Sie die Details einer Containergruppe ab.

az container show [--ids]
                  [--name]
                  [--resource-group]

Beispiele

Rufen Sie die Details einer Containergruppe ab. (automatisch generiert)

az container show --name MyContainerGroup --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az container start

Startet alle Container in einer Containergruppe.

Startet alle Container in einer Containergruppe. Berechnete Ressourcen werden zugewiesen, und die Abrechnung wird gestartet.

az container start --name
                   --resource-group
                   [--no-wait]

Erforderliche Parameter

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

az container stop

Stoppt alle Container in einer Containergruppe.

Stoppt alle Container in einer Containergruppe. Die Zuordnung von Computeressourcen wird aufgehoben, und die Berechnung von Gebühren wird beendet.

az container stop --name
                  --resource-group

Erforderliche Parameter

--name -n

Der Name der Containergruppe.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.