Partager via

az aks draft

  • Référence

Remarque

Cette référence fait partie de l’extension aks-preview pour Azure CLI (version 2.61.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az aks draft . En savoir plus sur les extensions.

Commandes pour générer des fichiers de déploiement dans un répertoire de projet et déployer sur un cluster AKS.

Commandes

Nom Description Type État
az aks draft create

Générez un fichier Dockerfile et les fichiers de déploiement Kubernetes minimum requis (helm, kustomize, manifestes) pour votre répertoire de projet.

 Extension GA
az aks draft generate-workflow

Générez un flux de travail GitHub pour générer et déployer automatiquement sur AKS.

 Extension GA
az aks draft setup-gh

Configurez GitHub OIDC pour votre application.

 Extension GA
az aks draft up

Exécutez az aks draft setup-gh ensuite az aks draft generate-workflow.

 Extension GA
az aks draft update

Mettez à jour votre application pour qu’elle soit accessible à Internet.

 Extension GA

az aks draft create

Générez un fichier Dockerfile et les fichiers de déploiement Kubernetes minimum requis (helm, kustomize, manifestes) pour votre répertoire de projet.

az aks draft create [--app]
                    [--create-config]
                    [--deployment-only]
                    [--destination]
                    [--dockerfile-only]
                    [--language]
                    [--path]

Exemples

Invite à générer un fichier Dockerfile et des fichiers de déploiement dans le répertoire actif.

az aks draft create

Générez uniquement le fichier Dockerfile dans le répertoire actif.

az aks draft create --dockerfile-only=true

Générez uniquement les fichiers de déploiement dans le répertoire actif.

az aks draft create --deployment-only=true

Générez un fichier Dockerfile et un fichier de déploiement dans un projet Java avec un nom d’application dans un répertoire de projet spécifique.

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

Paramètres facultatifs

--app

Spécifiez le nom de la version helm.

--create-config

Spécifiez le chemin d’accès au fichier de configuration.

--deployment-only

Générez uniquement des fichiers de déploiement (helm, kustomize, manifestes) pour le déploiement Kubernetes.

--destination

Spécifiez le chemin d’accès au répertoire du projet (la valeur par défaut est .).

Valeur par défaut: .
--dockerfile-only

Générez uniquement le fichier Dockerfile pour le déploiement Kubernetes.

--language

Spécifiez le langage utilisé pour créer le déploiement Kubernetes.

--path

Téléchargez et utilisez automatiquement le fichier binaire Brouillon à l’emplacement spécifié.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks draft generate-workflow

Générez un flux de travail GitHub pour générer et déployer automatiquement sur AKS.

Avant d’exécuter cette commande, vérifiez que vous avez configuré GitHub OIDC pour votre application. Vous devez également créer un groupe de ressources, un registre de conteneurs et un cluster Kubernetes sur Azure et lier les trois ressources à l’aide az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>de .

az aks draft generate-workflow [--branch]
                               [--cluster-name]
                               [--container-name]
                               [--destination]
                               [--path]
                               [--registry-name]
                               [--resource-group]

Exemples

Invite à générer un flux de travail GitHub dans le répertoire actif.

az aks draft generate-workflow

Invite à générer un flux de travail GitHub dans un répertoire de projet spécifique.

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

Générez un flux de travail GitHub avec un groupe de ressources, un nom de cluster AKS, un nom de registre de conteneurs dans un répertoire de projet spécifique.

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

Générez un flux de travail GitHub qui se déploie à partir de la branche principale avec un groupe de ressources, un nom de cluster AKS, un nom de registre de conteneurs et un nom d’image conteneur dans un répertoire de projet spécifique.

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

Paramètres facultatifs

--branch

Spécifiez la branche GitHub à partir de laquelle déployer automatiquement.

--cluster-name

Spécifiez le nom du cluster AKS.

--container-name

Spécifiez le nom de l’image conteneur.

--destination

Spécifiez le chemin d’accès au répertoire du projet (la valeur par défaut est .).

--path

Téléchargez et utilisez automatiquement le fichier binaire Brouillon à l’emplacement spécifié.

--registry-name

Spécifiez le chemin d’accès au répertoire du projet.

--resource-group

Spécifiez le nom du groupe de ressources Azure.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks draft setup-gh

Configurez GitHub OIDC pour votre application.

az aks draft setup-gh [--app]
                      [--gh-repo]
                      [--path]
                      [--provider]
                      [--resource-group]
                      [--subscription-id]

Exemples

Invitez à configurer GitHub OIDC pour un dépôt.

az aks draft setup-gh

Configurez GitHub OIDC sur Azure pour un référentiel spécifique.

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

Configurez GitHub OIDC sur Azure avec l’ID d’abonnement et le groupe de ressources.

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

Configurez GitHub OIDC avec un nom d’application sur Azure avec l’ID d’abonnement et le groupe de ressources pour un référentiel spécifique.

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

Paramètres facultatifs

--app

Spécifiez le nom de l’application Azure Active Directory.

--gh-repo

Spécifiez le dépôt GitHub (organisation/repo_name).

--path

Téléchargez et utilisez automatiquement le fichier binaire Brouillon à l’emplacement spécifié.

--provider

Spécifiez le fournisseur de cloud (par défaut est Azure).

Valeur par défaut: azure
--resource-group

Spécifiez le nom du groupe de ressources Azure.

--subscription-id

Définissez l'ID d'abonnement Azure.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks draft up

Exécutez az aks draft setup-gh ensuite az aks draft generate-workflow.

Cette commande combine az aks draft setup-gh et az aks draft generate-workflow configure GitHub OIDC et génère un flux de travail GitHub pour la génération et le déploiement automatiques sur AKS. Avant d’exécuter cette commande, créez un groupe de ressources, un registre de conteneurs et un cluster Kubernetes sur Azure et liez les trois ressources à l’aide az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>de .

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

Exemples

Invitez à configurer gitHub OIDC, puis générez un flux de travail GitHub dans le répertoire actif.

az aks draft up

Invitez à configurer GitHub OIDC, puis générez un flux de travail GitHub dans un répertoire de projet spécifique.

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

Invitez à configurer GitHub OIDC pour un référentiel spécifique, puis générez un flux de travail GitHub dans un répertoire de projet spécifique.

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

Paramètres facultatifs

--app

Spécifiez le nom de l’application.

--branch

Spécifiez la branche GitHub à partir de laquelle déployer automatiquement.

--cluster-name

Spécifiez le nom du cluster AKS.

--container-name

Spécifiez le nom de l’image conteneur.

--destination

Spécifiez le chemin d’accès au répertoire du projet (la valeur par défaut est .).

--gh-repo

Spécifiez le dépôt GitHub (organisation/repo_name).

--path

Téléchargez et utilisez automatiquement le fichier binaire Brouillon à l’emplacement spécifié.

--provider

Spécifiez le fournisseur de cloud (par défaut est Azure).

Valeur par défaut: azure
--registry-name

Spécifiez le chemin d’accès au répertoire du projet.

--resource-group

Spécifiez le nom du groupe de ressources Azure.

--subscription-id

Définissez l'ID d'abonnement Azure.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az aks draft update

Mettez à jour votre application pour qu’elle soit accessible à Internet.

Cette commande met automatiquement à jour vos fichiers yaml si nécessaire afin que votre application puisse recevoir des demandes externes.

az aks draft update [--certificate]
                    [--destination]
                    [--host]
                    [--path]

Exemples

Invite à mettre à jour l’application pour qu’elle soit accessible à Internet.

az aks draft update

Invitez à mettre à jour l’application pour qu’elle soit accessible sur Internet dans un répertoire de projet spécifique.

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

Mettez à jour l’application pour qu’elle soit accessible par Internet avec un hôte de la ressource d’entrée et un certificat KeyVault dans un répertoire de projet spécifique.

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

Paramètres facultatifs

--certificate

Spécifiez l’URI du certificat KeyVault à présenter.

--destination

Spécifiez le chemin d’accès au répertoire du projet (la valeur par défaut est .).

--host

Spécifiez l’hôte de la ressource d’entrée.

--path

Téléchargez et utilisez automatiquement le fichier binaire Brouillon à l’emplacement spécifié.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.