Feedback

az acs

  • Referenz

Verwalten von Azure Container Services.

ACS wird am 31. Januar 2020 als eigenständiger Dienst eingestellt.

Falls Sie den Kubernetes-Orchestrator verwenden, migrieren Sie bitte bis spätestens 31. Januar 2020 zu Azure Kubernetes Service.

Befehle

az acs browse

Zeigen Sie das Dashboard für den Orchestrator eines Dienstcontainers in einem Webbrowser an.
az acs create

Erstellen Sie einen neuen Containerdienst.
az acs dcos

Befehle zum Verwalten eines DC/OS-orchestrierten Azure-Containerdiensts.
az acs dcos browse

Erstellt einen SSH-Tunnel zum Azure-Containerdienst und öffnet das Mesosphäre DC/OS-Dashboard im Browser.
az acs dcos install-cli

Laden Sie das Befehlszeilentool DC/OS für einen Cluster herunter, und installieren Sie es.
az acs delete

Löschen eines Containerdiensts.
az acs kubernetes

Befehle zum Verwalten eines kubernetes-orchestrierten Azure-Containerdiensts.
az acs kubernetes browse

Starten Sie einen Proxy, und durchsuchen Sie die Kubernetes-Web-UI.
az acs kubernetes get-credentials

Laden Sie Anmeldeinformationen herunter und installieren Sie sie, um auf einen Cluster zuzugreifen. Dieser Befehl erfordert denselben privaten Schlüssel, der zum Erstellen des Clusters verwendet wird.
az acs kubernetes install-cli

Laden Sie das Befehlszeilentool Kubernetes für einen Cluster herunter, und installieren Sie es.
az acs list

Containerdienste auflisten.
az acs list-locations

Listet Speicherorte auf, an denen sich der Azure Container Service in der Vorschau und in der Produktion befindet.
az acs scale

Ändern Sie die Anzahl des privaten Agents eines Containerdiensts.
az acs show

Zeigen Sie die Details für einen Containerdienst an.
az acs wait

Warten Sie, bis ein Containerdienst einen gewünschten Zustand erreicht.

az acs browse

Bearbeiten

Zeigen Sie das Dashboard für den Orchestrator eines Dienstcontainers in einem Webbrowser an.

az acs browse --name
              --resource-group
              [--disable-browser]
              [--ssh-key-file]

Beispiele

Zeigen Sie das Dashboard für den Orchestrator eines Dienstcontainers in einem Webbrowser an. (automatisch generiert)

az acs browse --name MyContainerService --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--resource-group -g

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

Optionale Parameter

--disable-browser

Öffnen Sie den Browser nach dem Öffnen eines Proxys auf der Clusterweb-Benutzeroberfläche nicht.

--ssh-key-file

Wenn sie einen Pfad zu einem SSH-Schlüssel festlegen, der verwendet werden soll, gilt nur für DCOS.

az acs create

Bearbeiten

Erstellen Sie einen neuen Containerdienst.

az acs create --name
              --resource-group
              [--admin-password]
              [--admin-username]
              [--agent-count]
              [--agent-osdisk-size]
              [--agent-ports]
              [--agent-profiles]
              [--agent-storage-profile {ManagedDisks, StorageAccount}]
              [--agent-vm-size]
              [--agent-vnet-subnet-id]
              [--api-version]
              [--client-secret]
              [--dns-prefix]
              [--generate-ssh-keys]
              [--location]
              [--master-count]
              [--master-first-consecutive-static-ip]
              [--master-osdisk-size]
              [--master-profile]
              [--master-storage-profile {ManagedDisks, StorageAccount}]
              [--master-vm-size]
              [--master-vnet-subnet-id]
              [--no-wait]
              [--orchestrator-type {Custom, DCOS, DockerCE, Kubernetes, Swarm}]
              [--orchestrator-version]
              [--service-principal]
              [--ssh-key-value]
              [--tags]
              [--validate]
              [--windows]

Beispiele

Erstellen Sie einen DCOS-Cluster mit einem vorhandenen SSH-Schlüssel.

az acs create --orchestrator-type DCOS -g MyResourceGroup -n MyContainerService \
  --ssh-key-value /path/to/publickey

Erstellen Sie einen DCOS-Cluster mit zwei Agentpools.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles '[ \
  { \
    "name": "agentpool1" \
  }, \
  { \
    "name": "agentpool2" \
  }]'

Erstellen Sie einen DCOS-Cluster, in dem der zweite Agentpool eine vmSize angegeben hat.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles '[ \
  { \
    "name": "agentpool1" \
  }, \
  { \
    "name": "agentpool2", \
    "vmSize": "Standard_D2" \
  }]'

Erstellen Sie einen DCOS-Cluster mit Agentprofilen, die aus einer Datei angegeben sind.

az acs create -g MyResourceGroup -n MyContainerService --agent-profiles MyAgentProfiles.json

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--resource-group -g

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

Optionale Parameter

--admin-password

Das Administratorkennwort für Windows-Knoten. Nur verfügbar, wenn --windows=true.

--admin-username -u

Benutzername für die virtuellen Linux-Computer.

Standardwert: azureuser
--agent-count

Legen Sie die Standardanzahl von Agents für die Agentpools fest.

Standardwert: 3
--agent-osdisk-size

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Legen Sie die Standarddatenträgergröße für Agentpool-Vms fest. Einheit in GB. Standard: Entsprechende vmsize disk size.

--agent-ports

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Legen Sie die Standardports fest, die für die Agentpools verfügbar gemacht werden. Nur für Nicht-Kubernetes verwendbar. Standard: 8080.4000.80.

--agent-profiles -a

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Die Datei- oder Wörterbuchdarstellung der Agentprofile. Beachten Sie, dass alle Agenteinstellungen überschreiben, sobald sie festgelegt wurden.

--agent-storage-profile

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Legen Sie das Standardspeicherprofil für Agentpools fest. Standard: variiert je nach Orchestrator.

Zulässige Werte: ManagedDisks, StorageAccount
--agent-vm-size

Legen Sie die Standardgröße für Agentpool-Vms fest.

Standardwert: Standard_D2_v2
--agent-vnet-subnet-id

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Legen Sie die standardmäßige benutzerdefinierte vnet-Subnetz-ID für Agentpools fest. Der Hinweis-Agent muss dasselbe vnet verwenden, wenn der Mastersatz festgelegt ist. Standard: "".

--api-version

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Verwenden Sie die API-Version von ACS, um az acs-Vorgänge auszuführen. Verfügbare Optionen: 2017-01-31, 2017-07-01. Standard: die neueste Version für den Speicherort.

--client-secret

Dem Dienstprinzipal zugeordnetes Geheimnis Dieses Argument ist erforderlich, wenn --service-principal angegeben wird.

--dns-prefix -d

Legt das Präfix "Domänenname" für den Cluster fest. Die Verkettung des Domänennamens und der regionalisierten DNS-Zone bilden den vollqualifizierten Domänennamen, der der öffentlichen IP-Adresse zugeordnet ist.

--generate-ssh-keys

Erstellen der Dateien für öffentliche und private SSH-Schlüssel, sofern diese fehlen.

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

--master-count

Die Anzahl der Master für den Cluster.

Standardwert: 1
--master-first-consecutive-static-ip

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Die erste aufeinander folgende Ip-Adresse, die zum Angeben statischer IP-Block verwendet wird.

Standardwert: 10.240.255.5
--master-osdisk-size

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Die Datenträgergröße für Masterpool-Vms. Einheit in GB. Standard: Entsprechende vmsize disk size.

--master-profile -m

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Die Datei- oder Wörterbuchdarstellung des Masterprofils. Beachten Sie, dass alle Mastereinstellungen überschreiben, sobald sie festgelegt wurden.

--master-storage-profile

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Standard: variiert je nach Orchestrator.

Zulässige Werte: ManagedDisks, StorageAccount
--master-vm-size

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2.

Standardwert: Standard_D2_v2
--master-vnet-subnet-id

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Die benutzerdefinierte vnet-Subnetz-ID. Der Hinweis-Agent muss dasselbe vnet verwenden, wenn der Mastersatz festgelegt ist. Standard: "".

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--orchestrator-type -t

Der Typ des Orchestrators, der zum Verwalten der Anwendungen im Cluster verwendet wird.

Zulässige Werte: Custom, DCOS, DockerCE, Kubernetes, Swarm
Standardwert: DCOS
--orchestrator-version

Feature in vorschau, nur in kanadacentral, canadaeast, centralindia, koreasouth, koreacentral, southindia, uksouth, ukwest, westcentralus, westindia, westus2. Verwenden Sie Orchestrator-Version, um die semantische Version für Ihre Auswahl an Orchestrator anzugeben.

--service-principal

Dienstprinzipal für die Authentifizierung bei Azure-APIs

--ssh-key-value

Konfigurieren Sie alle Linux-Computer mit der öffentlichen SSH RSA-Zeichenfolge. Ihr Schlüssel sollte drei Teile enthalten, z. B. "ssh-rsa AAAAB... schnippeln... UcyupgH azureuser@linuxvm.

Standardwert: ~\.ssh\id_rsa.pub
--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--validate

Generieren und überprüfen Sie die ARM-Vorlage, ohne Ressourcen zu erstellen.

--windows

Wenn true, legen Sie den Standardmäßigen osType von Agentpools auf Windows fest.

az acs delete

Bearbeiten

Löschen eines Containerdiensts.

az acs delete --name
              --resource-group
              [--yes]

Beispiele

Löschen eines Containerdiensts. (automatisch generiert)

az acs delete --name MyContainerService --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--resource-group -g

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

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

az acs list

Bearbeiten

Containerdienste auflisten.

az acs list [--resource-group]

Optionale Parameter

--resource-group -g

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

az acs list-locations

Bearbeiten

Listet Speicherorte auf, an denen sich der Azure Container Service in der Vorschau und in der Produktion befindet.

az acs list-locations

az acs scale

Bearbeiten

Ändern Sie die Anzahl des privaten Agents eines Containerdiensts.

az acs scale --name
             --new-agent-count
             --resource-group

Beispiele

Ändern Sie die Anzahl des privaten Agents eines Containerdiensts. (automatisch generiert)

az acs scale --name MyContainerService --new-agent-count 10 --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--new-agent-count

Die Anzahl der Agents für den Containerdienst.

--resource-group -g

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

az acs show

Bearbeiten

Zeigen Sie die Details für einen Containerdienst an.

az acs show --name
            --resource-group

Beispiele

Zeigen Sie die Details für einen Containerdienst an. (automatisch generiert)

az acs show --name MyContainerService --resource-group MyResourceGroup

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--resource-group -g

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

az acs wait

Bearbeiten

Warten Sie, bis ein Containerdienst einen gewünschten Zustand erreicht.

Wenn ein Vorgang auf einem Containerdienst unterbrochen wurde oder mit --no-waitdiesem gestartet wurde, verwenden Sie diesen Befehl, um auf den Abschluss zu warten.

az acs wait --name
            --resource-group
            [--created]
            [--custom]
            [--deleted]
            [--exists]
            [--interval]
            [--timeout]
            [--updated]

Erforderliche Parameter

--name -n

Name des Containerdiensts. Sie können die Standardeinstellung mithilfe von az configure --defaults acs=<name>.

--resource-group -g

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

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.