az aks addon

Remarque

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

Commandes permettant de gérer et d’afficher des conditions de complément uniques.

Commandes

Nom Description Type Statut
az aks addon disable

Désactivez un module complémentaire Kubernetes activé dans un cluster.

Extension GA
az aks addon enable

Activez un module complémentaire Kubernetes.

Extension GA
az aks addon list

Répertoriez l’état de tous les compléments Kubernetes dans un cluster donné.

Extension GA
az aks addon list-available

Répertorier les compléments Kubernetes disponibles.

Extension GA
az aks addon show

Afficher l’état et la configuration d’un module complémentaire Kubernetes activé dans un cluster donné.

Extension GA
az aks addon update

Mettez à jour un module complémentaire Kubernetes déjà activé.

Extension GA

az aks addon disable

Désactivez un module complémentaire Kubernetes activé dans un cluster.

az aks addon disable --addon
                     --name
                     --resource-group
                     [--no-wait]

Exemples

Désactivez le module complémentaire « surveillance ».

az aks addon disable -g myResourceGroup -n myAKSCluster -a monitoring

Paramètres obligatoires

--addon -a

Spécifiez le module complémentaire Kubernetes à désactiver.

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
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 addon enable

Activez un module complémentaire Kubernetes.

Ces compléments sont disponibles : http_application_routing : configurer l’entrée avec la création automatique du nom DNS public. surveillance : activez la surveillance Log Analytics. Utilise l’espace de travail par défaut Log Analytics s’il en existe, sinon en crée un. Spécifiez « --workspace-resource-id » pour utiliser un espace de travail existant. Si le module complémentaire de surveillance est activé, l’argument --no-wait n’a aucun effet sur le nœud virtuel . Activez le nœud virtuel AKS. Nécessite que --subnet-name fournisse le nom d’un sous-réseau existant à utiliser pour le nœud virtuel. azure-policy : activez Azure Policy. Le module complémentaire Azure Policy pour AKS permet des mises en œuvre à grande échelle et des protections sur vos clusters de manière centralisée et cohérente. En savoir plus sur aka.ms/aks/policy. ingress-appgw : activez le module complémentaire Application Gateway Ingress Controller (PRÉVERSION). open-service-mesh - activer le module complémentaire Open Service Mesh (PRÉVERSION). gitops - activer GitOps (PRÉVERSION). azure-keyvault-secrets-provider : activez le module complémentaire du fournisseur de secrets Azure Keyvault. web_application_routing - activer le module complémentaire de routage des applications web (PRÉVERSION). Spécifiez « --dns-zone-resource-id » pour configurer DNS.

az aks addon enable --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Exemples

Activez un module complémentaire Kubernetes. (généré automatiquement)

az aks addon enable --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Activez le module complémentaire ingress-appgw avec le préfixe de sous-réseau.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Activez le module complémentaire open-service-mesh.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup -a open-service-mesh

Paramètres obligatoires

--addon -a

Spécifiez le module complémentaire Kubernetes à activer.

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--appgw-id

ID de ressource d’une passerelle Application Gateway existante à utiliser avec AGIC. Utiliser avec un complément d’entrée-azure.

--appgw-name

Nom de la passerelle d’application à créer/utiliser dans le groupe de ressources de nœud. Utiliser avec un complément d’entrée-azure.

--appgw-subnet-cidr

CIDR de sous-réseau à utiliser pour un nouveau sous-réseau créé pour déployer Application Gateway. Utiliser avec un complément d’entrée-azure.

--appgw-subnet-id

ID de ressource d’un sous-réseau existant utilisé pour déployer Application Gateway. Utiliser avec un complément d’entrée-azure.

--appgw-watch-namespace

Spécifiez l’espace de noms, à surveiller par AGIC. Il peut être une valeur de chaîne unique ou une liste d’espaces de noms séparés par des virgules. Utiliser avec un complément d’entrée-azure.

--data-collection-settings
Préversion

Chemin d’accès au fichier JSON contenant les paramètres de collecte de données pour le module complémentaire Surveillance.

--dns-zone-resource-ids
Préversion

Liste séparée par des virgules des ID de ressource de la ressource de zone DNS à utiliser avec le module complémentaire web_application_routing.

--enable-msi-auth-for-monitoring
Préversion

Envoyez des données de surveillance à Log Analytics à l’aide de l’identité affectée par le cluster (au lieu de la clé partagée de l’espace de travail Log Analytics).

valeurs acceptées: false, true
valeur par défaut: True
--enable-secret-rotation

Activez la rotation des secrets. Utiliser avec le module complémentaire azure-keyvault-secrets-provider.

valeur par défaut: False
--enable-sgxquotehelper

Activez l’assistance de devis SGX pour le module complémentaire confcom.

valeur par défaut: False
--enable-syslog
Préversion

Activez la collecte de données syslog pour le module complémentaire Surveillance.

valeurs acceptées: false, true
valeur par défaut: False
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--rotation-poll-interval

Définir l’intervalle d’interrogation de rotation. Utiliser avec le module complémentaire azure-keyvault-secrets-provider.

--subnet-name -s

Nom du sous-réseau du nœud virtuel à utiliser.

--workspace-resource-id

ID de ressource d’un espace de travail Log Analytics existant à utiliser pour stocker les données de supervision.

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

Répertoriez l’état de tous les compléments Kubernetes dans un cluster donné.

az aks addon list --name
                  --resource-group

Paramètres obligatoires

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 addon list-available

Répertorier les compléments Kubernetes disponibles.

az aks addon list-available
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 addon show

Afficher l’état et la configuration d’un module complémentaire Kubernetes activé dans un cluster donné.

az aks addon show --addon
                  --name
                  --resource-group

Exemples

Afficher la configuration du module complémentaire « surveillance ».

az aks addon show -g myResourceGroup -n myAKSCluster -a monitoring

Paramètres obligatoires

--addon -a

Spécifiez le module complémentaire Kubernetes.

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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

Mettez à jour un module complémentaire Kubernetes déjà activé.

az aks addon update --addon
                    --name
                    --resource-group
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Exemples

Mettez à jour un module complémentaire Kubernetes. (généré automatiquement)

az aks addon update --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Mettez à jour le complément ingress-appgw avec le préfixe de sous-réseau.

az aks addon update --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Mettez à jour le module complémentaire de surveillance avec l’ID de ressource de l’espace de travail.

az aks addon update -g $rg -n $cn -a monitoring --workspace-resource-id=/subscriptions/0000000-00000000-00000-000-000/resourcegroups/myresourcegroup/providers/microsoft.operationalinsights/workspaces/defaultlaworkspace

Paramètres obligatoires

--addon -a

Spécifiez le module complémentaire Kubernetes à mettre à jour.

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--appgw-id

ID de ressource d’une passerelle Application Gateway existante à utiliser avec AGIC. Utiliser avec un complément d’entrée-azure.

--appgw-name

Nom de la passerelle d’application à créer/utiliser dans le groupe de ressources de nœud. Utiliser avec un complément d’entrée-azure.

--appgw-subnet-cidr

CIDR de sous-réseau à utiliser pour un nouveau sous-réseau créé pour déployer Application Gateway. Utiliser avec un complément d’entrée-azure.

--appgw-subnet-id

ID de ressource d’un sous-réseau existant utilisé pour déployer Application Gateway. Utiliser avec un complément d’entrée-azure.

--appgw-watch-namespace

Spécifiez l’espace de noms, à surveiller par AGIC. Il peut être une valeur de chaîne unique ou une liste d’espaces de noms séparés par des virgules. Utiliser avec un complément d’entrée-azure.

--data-collection-settings
Préversion

Chemin d’accès au fichier JSON contenant les paramètres de collecte de données pour le module complémentaire Surveillance.

--dns-zone-resource-ids
Préversion

Liste séparée par des virgules des ID de ressource de la ressource de zone DNS à utiliser avec le module complémentaire web_application_routing.

--enable-msi-auth-for-monitoring
Préversion

Envoyez des données de surveillance à Log Analytics à l’aide de l’identité affectée par le cluster (au lieu de la clé partagée de l’espace de travail Log Analytics).

valeurs acceptées: false, true
--enable-secret-rotation

Activez la rotation des secrets. Utiliser avec le module complémentaire azure-keyvault-secrets-provider.

valeur par défaut: False
--enable-sgxquotehelper

Activez l’assistance de devis SGX pour le module complémentaire confcom.

valeur par défaut: False
--enable-syslog
Préversion

Activez la collecte de données syslog pour le module complémentaire Surveillance.

valeurs acceptées: false, true
valeur par défaut: False
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--rotation-poll-interval

Définir l’intervalle d’interrogation de rotation. Utiliser avec le module complémentaire azure-keyvault-secrets-provider.

--subnet-name -s

Nom du sous-réseau du nœud virtuel à utiliser.

--workspace-resource-id

ID de ressource d’un espace de travail Log Analytics existant à utiliser pour stocker les données de supervision.

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.