Freigeben über

az aks draft

Note

Diese Referenz ist Teil der erweiterung aks-preview für die Azure CLI (Version 2.73.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az-Entwurf-Befehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Befehle zum Erstellen von Bereitstellungsdateien in einem Projektverzeichnis und Bereitstellen in einem AKS-Cluster.

Befehle

Name Beschreibung Typ Status
az aks draft create

Generieren Sie eine Dockerfile-Datei und die mindestens erforderlichen Kubernetes-Bereitstellungsdateien (Helm, Kustomize, Manifeste) für Ihr Projektverzeichnis.

 Extension GA
az aks draft generate-workflow

Generieren Sie einen GitHub Workflow für den automatischen Build und die Bereitstellung in AKS.

 Extension GA
az aks draft setup-gh

Richten Sie GitHub OIDC für Ihre Anwendung ein.

 Extension GA
az aks draft up

Führen Sie az aks draft setup-gh dann az aks draft generate-workflowaus.

 Extension GA
az aks draft update

Aktualisieren Sie Ihre Anwendung so, dass auf das Internet zugegriffen werden kann.

 Extension GA

az aks draft create

Generieren Sie eine Dockerfile-Datei und die mindestens erforderlichen Kubernetes-Bereitstellungsdateien (Helm, Kustomize, Manifeste) für Ihr Projektverzeichnis.

az aks draft create [--acquire-policy-token]
                    [--app]
                    [--change-reference]
                    [--create-config]
                    [--deployment-only]
                    [--destination]
                    [--dockerfile-only]
                    [--language]
                    [--path]

Beispiele

Aufforderung zum Generieren einer Dockerfile- und Bereitstellungsdateien im aktuellen Verzeichnis.

az aks draft create

Generieren Sie nur die Dockerfile im aktuellen Verzeichnis.

az aks draft create --dockerfile-only=true

Generieren Sie nur die Bereitstellungsdateien im aktuellen Verzeichnis.

az aks draft create --deployment-only=true

Generieren Sie eine Dockerfile-Datei und eine Bereitstellungsdatei in einem Java Projekt mit einem App-Namen in einem bestimmten Projektverzeichnis.

az aks draft create --language=java --app=some_app --destination=/projects/some_project

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--app

Geben Sie den Namen der Steuerversion an.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--create-config

Geben Sie den Pfad zur Konfigurationsdatei an.

--deployment-only

Generieren Sie nur Bereitstellungsdateien (Helm, Kustomize, Manifeste) für die Kubernetes-Bereitstellung.

--destination

Geben Sie den Pfad zum Projektverzeichnis an (Standard ist .).

Eigenschaft Wert
Standardwert: .
--dockerfile-only

Generieren Sie Dockerfile nur für die Kubernetes-Bereitstellung.

--language

Geben Sie die Sprache an, die zum Erstellen der Kubernetes-Bereitstellung verwendet wird.

--path

Automatisches Herunterladen und Verwenden der Draft-Binärdatei am angegebenen Speicherort.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks draft generate-workflow

Generieren Sie einen GitHub Workflow für den automatischen Build und die Bereitstellung in AKS.

Stellen Sie vor dem Ausführen dieses Befehls sicher, dass Sie GitHub OIDC für Ihre Anwendung eingerichtet haben. Sie müssen auch eine Ressourcengruppe, eine Containerregistrierung und einen Kubernetes-Cluster auf Azure erstellen und die drei Ressourcen mithilfe von az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name> verknüpfen.

az aks draft generate-workflow [--acquire-policy-token]
                               [--branch]
                               [--change-reference]
                               [--cluster-name]
                               [--container-name]
                               [--destination]
                               [--path]
                               [--registry-name]
                               [--resource-group]

Beispiele

Aufforderung zum Generieren eines GitHub Workflows im aktuellen Verzeichnis.

az aks draft generate-workflow

Aufforderung zum Generieren eines GitHub Workflows in einem bestimmten Projektverzeichnis.

az aks draft generate-workflow --destination=/projects/some_project

Generieren Sie einen GitHub Workflow mit einer Ressourcengruppe, einem AKS-Clusternamen, einem Containerregistrierungsnamen in einem bestimmten Projektverzeichnis.

az aks draft generate-workflow --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --destination=/projects/some_project

Generieren Sie einen GitHub Workflow, der aus der Hauptverzweigung mit einer Ressourcengruppe, einem AKS-Clusternamen, einem Containerregistrierungsnamen und einem Containerimagenamen in einem bestimmten Projektverzeichnis bereitgestellt wird.

az aks draft generate-workflow --branch=main --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --container-name=some_image --destination=/projects/some_project

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--branch

Geben Sie den GitHub Branch an, von dem automatisch bereitgestellt werden soll.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--cluster-name

Geben Sie den Namen des AKS-Clusters an.

--container-name

Geben Sie den Namen des Containerimages an.

--destination

Geben Sie den Pfad zum Projektverzeichnis an (Standard ist .).

--path

Automatisches Herunterladen und Verwenden der Draft-Binärdatei am angegebenen Speicherort.

--registry-name

Geben Sie den Pfad zum Projektverzeichnis an.

--resource-group

Geben Sie den Namen der Azure Ressourcengruppe an.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks draft setup-gh

Richten Sie GitHub OIDC für Ihre Anwendung ein.

az aks draft setup-gh [--acquire-policy-token]
                      [--app]
                      [--change-reference]
                      [--gh-repo]
                      [--path]
                      [--provider]
                      [--resource-group]
                      [--subscription-id]

Beispiele

Aufforderung zum Einrichten des GitHub OIDC für ein Repository.

az aks draft setup-gh

Richten Sie die GitHub OIDC auf Azure für ein bestimmtes Repository ein.

az aks draft setup-gh --provider=azure --gh-repo=some_organization/some_repo

Richten Sie die GitHub OIDC auf Azure mit Abonnement-ID und Ressourcengruppe ein.

az aks draft setup-gh --provider=azure --subscription-id=some_subscription --resource-group=some_rg

Richten Sie das GitHub OIDC mit einem Anwendungsnamen auf Azure mit Abonnement-ID und Ressourcengruppe für ein bestimmtes Repository ein.

az aks draft setup-gh --app=some_app --provider=azure --subscription-id=some_subscription --resource-group=some_rg --gh-repo=some_organization/some_repo

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--app

Geben Sie den namen des Azure Active Directory applicaton an.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--gh-repo

Geben Sie das GitHub Repository (Organisation/repo_name) an.

--path

Automatisches Herunterladen und Verwenden der Draft-Binärdatei am angegebenen Speicherort.

--provider

Geben Sie den Cloudanbieter an (Standard ist Azure).

Eigenschaft Wert
Standardwert: azure
--resource-group

Geben Sie den Namen der Azure Ressourcengruppe an.

--subscription-id

Geben Sie die Azure Abonnement-ID an.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks draft up

Führen Sie az aks draft setup-gh dann az aks draft generate-workflowaus.

Dieser Befehl kombiniert az aks draft setup-gh und az aks draft generate-workflow, um GitHub OIDC einzurichten und einen GitHub Workflow für die automatische Erstellung und Bereitstellung in AKS zu generieren. Erstellen Sie vor dem Ausführen dieses Befehls eine Ressourcengruppe, eine Containerregistrierung und einen Kubernetes-Cluster auf Azure, und verknüpfen Sie die drei Ressourcen mithilfe von az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>.

az aks draft up [--acquire-policy-token]
                [--app]
                [--branch]
                [--change-reference]
                [--cluster-name]
                [--container-name]
                [--destination]
                [--gh-repo]
                [--path]
                [--provider]
                [--registry-name]
                [--resource-group]
                [--subscription-id]

Beispiele

Fordern Sie auf, die GitHub OIDC einzurichten, und generieren Sie dann einen GitHub Workflow im aktuellen Verzeichnis.

az aks draft up

Fordern Sie auf, die GitHub OIDC einzurichten, und generieren Sie dann einen GitHub Workflow in einem bestimmten Projektverzeichnis.

az aks draft up --destination=/projects/some_project

Fordern Sie auf, die GitHub OIDC für ein bestimmtes Repository einzurichten, und generieren Sie dann einen GitHub Workflow in einem bestimmten Projektverzeichnis.

az aks draft up --gh-repo=some_organization/some_repo --destination=/projects/some_project

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--app

Geben Sie den Namen der Anwendung an.

--branch

Geben Sie den GitHub Branch an, von dem automatisch bereitgestellt werden soll.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--cluster-name

Geben Sie den Namen des AKS-Clusters an.

--container-name

Geben Sie den Namen des Containerimages an.

--destination

Geben Sie den Pfad zum Projektverzeichnis an (Standard ist .).

--gh-repo

Geben Sie das GitHub Repository (Organisation/repo_name) an.

--path

Automatisches Herunterladen und Verwenden der Draft-Binärdatei am angegebenen Speicherort.

--provider

Geben Sie den Cloudanbieter an (Standard ist Azure).

Eigenschaft Wert
Standardwert: azure
--registry-name

Geben Sie den Pfad zum Projektverzeichnis an.

--resource-group

Geben Sie den Namen der Azure Ressourcengruppe an.

--subscription-id

Geben Sie die Azure Abonnement-ID an.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks draft update

Aktualisieren Sie Ihre Anwendung so, dass auf das Internet zugegriffen werden kann.

Mit diesem Befehl werden Ihre Yaml-Dateien bei Bedarf automatisch aktualisiert, sodass Ihre Anwendung externe Anforderungen empfangen kann.

az aks draft update [--acquire-policy-token]
                    [--certificate]
                    [--change-reference]
                    [--destination]
                    [--host]
                    [--path]

Beispiele

Fordern Sie auf, die Anwendung so zu aktualisieren, dass sie auf das Internet zugreifen kann.

az aks draft update

Fordern Sie auf, die Anwendung auf das Internet in einem bestimmten Projektverzeichnis zu aktualisieren.

az aks draft update --destination=/projects/some_project

Aktualisieren Sie die Anwendung so, dass auf das Internet zugegriffen werden kann, mit einem Host der Eingangsressource und einem Keyvault-Zertifikat in einem bestimmten Projektverzeichnis.

az aks draft update --host=some_host --certificate=some_certificate --destination=/projects/some_project

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--certificate

Geben Sie den URI des zu präsentierenden Keyvault-Zertifikats an.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--destination

Geben Sie den Pfad zum Projektverzeichnis an (Standard ist .).

--host

Geben Sie den Host der Eingangsressource an.

--path

Automatisches Herunterladen und Verwenden der Draft-Binärdatei am angegebenen Speicherort.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False