az connectedk8s

Référence

Remarque

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

Commandes pour gérer les clusters Kubernetes connectés.

Commandes

Nom	Description	Type	État
az connectedk8s connect	Intégrez un cluster Kubernetes connecté à Azure.	Extension	GA
az connectedk8s delete	Supprimez un cluster Kubernetes connecté avec les agents de cluster connectés.	Extension	GA
az connectedk8s disable-features	Désactive les fonctionnalités sélectives sur le cluster connecté.	Extension	Aperçu
az connectedk8s enable-features	Active les fonctionnalités sélectives sur le cluster connecté.	Extension	Aperçu
az connectedk8s list	Répertorier les clusters Kubernetes connectés.	Extension	GA
az connectedk8s proxy	Obtenez l’accès à un cluster Kubernetes connecté.	Extension	GA
az connectedk8s show	Afficher les détails d’un cluster Kubernetes connecté.	Extension	GA
az connectedk8s troubleshoot	Effectuez des vérifications de diagnostic sur un cluster Kubernetes avec Arc.	Extension	Aperçu
az connectedk8s update	Mettez à jour les propriétés du cluster Kubernetes intégré arc.	Extension	GA
az connectedk8s upgrade	Mettez à niveau atomiquement les agents intégrés vers la version spécifique ou la dernière version par défaut.	Extension	GA

az connectedk8s connect

Intégrez un cluster Kubernetes connecté à Azure.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi {false, true}]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Exemples

Intégrez un cluster Kubernetes connecté avec la configuration kube par défaut et le contexte kube.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Intégrez un cluster Kubernetes connecté avec la configuration kube et le contexte kube par défaut et désactivez la mise à niveau automatique des agents arc.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

Intégrez un cluster Kubernetes connecté en spécifiant kubeconfig et kubecontext.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Intégrez un cluster Kubernetes connecté en spécifiant le proxy https, le proxy http, aucun paramètre de proxy.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Intégrez un cluster Kubernetes connecté en spécifiant le proxy https, le proxy http, aucun proxy avec les paramètres de certificat.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Intégrez un cluster Kubernetes connecté avec la fonctionnalité liaison privée activée en spécifiant les paramètres de liaison privée.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

Intégrez un cluster Kubernetes connecté avec un délai d’expiration d’intégration personnalisé.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

Intégrez un cluster Kubernetes connecté avec l’émetteur oidc et le webhook d’identité de charge de travail activé.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Intégrez un cluster Kubernetes connecté avec l’émetteur oidc activé à l’aide d’une URL d’émetteur auto-hébergée pour le cluster de cloud public.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Paramètres obligatoires

--name -n

Nom du cluster connecté.

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

--azure-hybrid-benefit

Indicateur pour activer/désactiver la fonctionnalité Azure Hybrid Benefit.

Valeurs acceptées: False, NotApplicable, True

--container-log-path

Remplacez le chemin d’accès du journal de conteneur par défaut pour activer la journalisation fluent-bit.

--correlation-id

Guid utilisé pour suivre en interne la source de l’intégration du cluster. Veuillez ne pas le modifier, sauf indication contraire.

--custom-ca-cert --proxy-cert

Chemin d’accès au fichier de certificat pour le proxy ou l’autorité de certification personnalisée.

--custom-locations-oid

OID de l’application « emplacements personnalisés ».

--disable-auto-upgrade

Indicateur pour désactiver la mise à niveau automatique des agents arc.

Valeur par défaut: False

--distribution

Distribution Kubernetes qui s’exécutera sur ce cluster connecté.

Valeurs acceptées: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

Valeur par défaut: generic

--distribution-version

Version de distribution Kubernetes du cluster connecté.

--enable-oidc-issuer

Préversion

Activez la création de l’URL de l’émetteur OIDC utilisée pour l’identité de charge de travail.

Valeurs acceptées: false, true

Valeur par défaut: False

--enable-private-link

Préversion

Indicateur pour activer/désactiver la prise en charge des liaisons privées sur une ressource de cluster connectée. Valeurs autorisées : false, true.

Valeurs acceptées: false, true

--enable-wi --enable-workload-identity

Préversion

Activez le webhook d’identité de charge de travail.

Valeurs acceptées: false, true

Valeur par défaut: False

--infrastructure

Infrastructure sur laquelle le cluster Kubernetes représenté par ce cluster connecté s’exécute.

Valeurs acceptées: LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server

Valeur par défaut: generic

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--no-wait

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

Valeur par défaut: False

--onboarding-timeout

Temps nécessaire (en secondes) pour que les pods arc-agent soient installés sur le cluster Kubernetes. Remplacez cette valeur si les contraintes matérielles/réseau sur votre cluster nécessitent plus de temps pour installer les pods arc-agent.

Valeur par défaut: 1200

--pls-arm-id --private-link-scope-resource-id

Préversion

ID de ressource ARM de la ressource d’étendue de liaison privée à laquelle ce cluster connecté est associé.

--proxy-http

URL du proxy Http à utiliser.

--proxy-https

URL du proxy Https à utiliser.

--proxy-skip-range

Liste des URL/CIDR pour lesquelles le proxy ne doit pas être utilisé.

--self-hosted-issuer

Préversion

URL de l’émetteur auto-hébergé pour les clusters de cloud public - AKS, GKE, EKS.

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--yes -y

Ne pas demander de confirmation.

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

Supprimez un cluster Kubernetes connecté avec les agents de cluster connectés.

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

Exemples

Supprimez un cluster Kubernetes connecté et des agents de cluster connectés avec kubeconfig et kubecontext par défaut.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Supprimez un cluster Kubernetes connecté en spécifiant le kubeconfig et kubecontext pour la suppression des agents de cluster connectés.

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Paramètres facultatifs

--force

Forcez la suppression pour supprimer toutes les ressources azure-arc du cluster.

Valeur par défaut: False

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--name -n

Nom du cluster connecté.

--no-wait

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

Valeur par défaut: False

--resource-group -g

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

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--subscription

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

--yes -y

Ne pas demander de confirmation.

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 connectedk8s disable-features

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Désactive les fonctionnalités sélectives sur le cluster connecté.

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

Exemples

Désactive la fonctionnalité azure-rbac.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

Désactivez plusieurs fonctionnalités.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

Paramètres obligatoires

--features

Liste séparée par l’espace des fonctionnalités que vous souhaitez désactiver.

Valeurs acceptées: azure-rbac, cluster-connect, custom-locations

Paramètres facultatifs

--ids

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--name -n

Nom du cluster connecté.

--resource-group -g

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

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--subscription

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

--yes -y

Ne pas demander de confirmation.

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 connectedk8s enable-features

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Active les fonctionnalités sélectives sur le cluster connecté.

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

Exemples

Active la fonctionnalité Cluster-Connect.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Activer la fonctionnalité RBAC Azure.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

Activez plusieurs fonctionnalités.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

Paramètres obligatoires

--features

Liste séparée par l’espace des fonctionnalités que vous souhaitez activer.

Valeurs acceptées: azure-rbac, cluster-connect, custom-locations

Paramètres facultatifs

--custom-locations-oid

OID de l’application « emplacements personnalisés ».

--ids

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--name -n

Nom du cluster connecté.

--resource-group -g

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

--skip-azure-rbac-list

Liste séparée par des virgules des noms d’utilisateur/e-mail/oid. Azure RBAC sera ignoré pour ces utilisateurs. Spécifiez lors de l’activation d’azure-rbac.

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--subscription

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

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

Répertorier les clusters Kubernetes connectés.

az connectedk8s list [--resource-group]

Exemples

Répertoriez tous les clusters Kubernetes connectés dans un groupe de ressources.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Répertoriez tous les clusters Kubernetes connectés dans un abonnement.

az connectedk8s list --subscription subscriptionName

Paramètres facultatifs

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

Obtenez l’accès à un cluster Kubernetes connecté.

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

Exemples

Obtenez l’accès à un cluster Kubernetes connecté.

az connectedk8s proxy -n clusterName -g resourceGroupName

Obtenir l’accès à un cluster Kubernetes connecté avec un port personnalisé

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

Obtenir l’accès à un cluster Kubernetes connecté avec un jeton de compte de service

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

Obtenir l’accès à un cluster Kubernetes connecté en spécifiant l’emplacement kubeconfig personnalisé

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

Obtenir l’accès à un cluster Kubernetes connecté en spécifiant un contexte personnalisé

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

Paramètres facultatifs

--file -f

Fichier de configuration Kubernetes à mettre à jour. S’il n’est pas fourni, met à jour le fichier « ~/.kube/config ». Utilisez « - » pour imprimer YAML sur stdout à la place.

Valeur par défaut: ~\.kube\config

--ids

--kube-context

Si elle est spécifiée, remplacez le nom de contexte par défaut.

--name -n

Nom du cluster connecté.

--port

Port utilisé pour accéder au cluster connecté.

Valeur par défaut: 47011

--resource-group -g

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

--subscription

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

--token

Jeton de compte de service à utiliser pour s’authentifier auprès du cluster Kubernetes.

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

Afficher les détails d’un cluster Kubernetes connecté.

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Exemples

Afficher les détails d’un cluster Kubernetes connecté

az connectedk8s show -g resourceGroupName -n connectedClusterName

Paramètres facultatifs

--ids

--name -n

Nom du cluster connecté.

--resource-group -g

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

--subscription

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

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

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Effectuez des vérifications de diagnostic sur un cluster Kubernetes avec Arc.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

Exemples

Effectuez des vérifications de diagnostic sur un cluster Kubernetes avec Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Paramètres obligatoires

--name -n

Nom du cluster connecté.

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

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubeconfig de l’ordinateur actuel.

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

Mettez à jour les propriétés du cluster Kubernetes intégré arc.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-proxy]
                       [--disable-wi {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi {false, true}]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

Exemples

Mettre à jour les valeurs du proxy pour les agents

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Désactiver les paramètres de proxy pour les agents

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

Désactiver la mise à niveau automatique des agents

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

Mettez à jour un cluster Kubernetes connecté avec l’émetteur oidc et le webhook d’identité de charge de travail activé.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Mettez à jour un cluster Kubernetes connecté avec l’émetteur oidc activé à l’aide d’une URL d’émetteur auto-hébergée pour le cluster de cloud public.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Désactivez le webhook d’identité de charge de travail sur un cluster Kubernetes connecté.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

Paramètres facultatifs

--auto-upgrade

Indicateur pour activer/désactiver la mise à niveau automatique des agents arc. Par défaut, la mise à niveau automatique des agents est activée.

Valeurs acceptées: false, true

--azure-hybrid-benefit

Indicateur pour activer/désactiver la fonctionnalité Azure Hybrid Benefit.

Valeurs acceptées: False, NotApplicable, True

--container-log-path

Remplacez le chemin d’accès du journal de conteneur par défaut pour activer la journalisation fluent-bit.

--custom-ca-cert --proxy-cert

Chemin d’accès au fichier de certificat pour le proxy ou l’autorité de certification personnalisée.

--disable-proxy

Désactive les paramètres de proxy pour les agents.

Valeur par défaut: False

--disable-wi --disable-workload-identity

Préversion

Désactivez le webhook d’identité de charge de travail.

Valeurs acceptées: false, true

--distribution

Distribution Kubernetes qui s’exécutera sur ce cluster connecté.

Valeurs acceptées: aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

--distribution-version

Version de distribution Kubernetes du cluster connecté.

--enable-oidc-issuer

Préversion

Activez la création de l’URL de l’émetteur OIDC utilisée pour l’identité de charge de travail.

Valeurs acceptées: false, true

--enable-wi --enable-workload-identity

Préversion

Activez le webhook d’identité de charge de travail.

Valeurs acceptées: false, true

--ids

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--name -n

Nom du cluster connecté.

--proxy-http

URL du proxy Http à utiliser.

--proxy-https

URL du proxy Https à utiliser.

--proxy-skip-range

Liste des URL/CIDR pour lesquelles le proxy ne doit pas être utilisé.

--resource-group -g

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

--self-hosted-issuer

Préversion

URL de l’émetteur auto-hébergé pour les clusters de cloud public - AKS, GKE, EKS.

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--subscription

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

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--yes -y

Ne pas demander de confirmation.

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

Mettez à niveau atomiquement les agents intégrés vers la version spécifique ou la dernière version par défaut.

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

Exemples

Mettre à niveau les agents vers la dernière version

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Mettre à niveau les agents vers une version spécifique

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

Mettez à niveau les agents avec un délai d’expiration de mise à niveau personnalisé.

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

Paramètres facultatifs

--agent-version

Version de l’agent pour mettre à jour les graphiques Helm vers.

--ids

--kube-config

Chemin d’accès au fichier de configuration kube.

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--name -n

Nom du cluster connecté.

--resource-group -g

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

--skip-ssl-verification

Ignorez la vérification SSL pour toute connexion de cluster.

Valeur par défaut: False

--subscription

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

--upgrade-timeout

Temps nécessaire (en secondes) pour que les pods arc-agent soient mis à niveau sur le cluster Kubernetes. Remplacez cette valeur si les contraintes matérielles/réseau sur votre cluster nécessitent plus de temps pour mettre à niveau les pods arc-agent.

Valeur par défaut: 600

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.

Partager via

az connectedk8s

Commandes

az connectedk8s connect

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedk8s delete

Exemples

Paramètres facultatifs

az connectedk8s disable-features

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedk8s enable-features

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedk8s list

Exemples

Paramètres facultatifs

az connectedk8s proxy

Exemples

Paramètres facultatifs

az connectedk8s show

Exemples

Paramètres facultatifs

az connectedk8s troubleshoot

Exemples

Paramètres obligatoires

Paramètres facultatifs

az connectedk8s update

Exemples

Paramètres facultatifs

az connectedk8s upgrade

Exemples

Paramètres facultatifs

Ressources supplémentaires