Freigeben über

az aks draft

Note

Diese Referenz ist Teil der Aks-Preview-Erweiterung 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 [--app]
                    [--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.

--app

Geben Sie den Namen der Steuerversion an.

--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 in Azure erstellen und die drei Ressourcen mithilfe az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>von Azure verknüpfen.

az aks draft generate-workflow [--branch]
                               [--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.

--branch

Geben Sie die GitHub-Verzweigung an, aus der automatisch bereitgestellt werden soll.

--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 [--app]
                      [--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 gitHub OIDC in Azure für ein bestimmtes Repository ein.

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

Richten Sie 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 gitHub OIDC mit einem Anwendungsnamen in 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.

--app

Geben Sie den Namen der Azure Active Directory-Applicaton an.

--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 richtet GitHub OIDC ein und generiert einen GitHub-Workflow für den automatischen Build und die Bereitstellung in AKS. Erstellen Sie vor dem Ausführen dieses Befehls eine Ressourcengruppe, eine Containerregistrierung und einen Kubernetes-Cluster in 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 [--app]
                [--branch]
                [--cluster-name]
                [--container-name]
                [--destination]
                [--gh-repo]
                [--path]
                [--provider]
                [--registry-name]
                [--resource-group]
                [--subscription-id]

Beispiele

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

az aks draft up

Fordern Sie auf, 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, 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.

--app

Geben Sie den Namen der Anwendung an.

--branch

Geben Sie die GitHub-Verzweigung an, aus der automatisch bereitgestellt werden soll.

--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 [--certificate]
                    [--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.

--certificate

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

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