az connectedk8s

Note

Cette référence fait partie de l’extension connectedk8s pour Azure CLI (version 2.70.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az connectedk8s . Apprenez-en davantage 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	Preview
az connectedk8s enable-features	Active les fonctionnalités sélectives sur le cluster connecté.	Extension	Preview
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	Preview
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.

Le cluster Kubernetes à intégrer en tant que cluster connecté doit être le cluster par défaut dans kubeconfig. Exécutez kubectl config get-contexts pour confirmer le nom du contexte cible. Définissez ensuite le contexte par défaut sur le cluster approprié en exécutant kubectl config use-context target-cluster-name.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config --configuration-settings]
                        [--config-protected --config-protected-settings]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert --proxy-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 --enable-workload-identity {false, true}]
                        [--gateway-resource-id]
                        [--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 --private-link-scope-resource-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

Intégrer un cluster Kubernetes connecté avec la fonctionnalité de passerelle Azure activée.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

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 à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--azure-hybrid-benefit

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

Propriété	Valeur
Valeurs acceptées:	False, NotApplicable, True

--config --configuration-settings

Préversion

Paramètres de configuration en tant que paire clé=valeur. Répétez le paramètre pour chaque paramètre. N’utilisez pas cette option pour les secrets, car cette valeur est retournée en réponse.

--config-protected --config-protected-settings

Préversion

Paramètres protégés de configuration en tant que paire clé=valeur. Répétez le paramètre pour chaque paramètre. Seule la clé est retournée en réponse, la valeur n’est pas.

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

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--custom-locations-oid

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

--disable-auto-upgrade

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

Propriété	Valeur
Valeur par défaut:	False

--distribution

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

Propriété	Valeur
Valeur par défaut:	generic
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 la fédération des identités de charge de travail.

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

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

Propriété	Valeur
Groupe de paramètres:	PrivateLink Arguments
Valeurs acceptées:	false, true

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

Préversion

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

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

--gateway-resource-id

Préversion

ArmID de la ressource De passerelle Arc.

Propriété	Valeur
Groupe de paramètres:	Gateway Arguments

--infrastructure

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

Propriété

Valeur

Valeur par défaut:

generic

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

--kube-config

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

--kube-context

Contexte Kubconfig à partir de l’ordinateur actuel.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--no-wait

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

Propriété	Valeur
Groupe de paramètres:	Timeout Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Timeout Arguments
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é.

Propriété	Valeur
Groupe de paramètres:	PrivateLink Arguments

--proxy-http

URL du proxy Http à utiliser.

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--proxy-https

URL du proxy Https à utiliser.

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--proxy-skip-range

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

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--self-hosted-issuer

Préversion

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

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments

--skip-ssl-verification

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

Propriété	Valeur
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

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--force

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

Propriété	Valeur
Valeur par défaut:	False

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--skip-ssl-verification

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

Propriété	Valeur
Valeur par défaut:	False

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--yes -y

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az connectedk8s disable-features

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et 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.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--skip-ssl-verification

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

Propriété	Valeur
Valeur par défaut:	False

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--yes -y

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az connectedk8s enable-features

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et 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.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--custom-locations-oid

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

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Azure RBAC Arguments

--skip-ssl-verification

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

Propriété	Valeur
Valeur par défaut:	False

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

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

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--kube-context

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

--name -n

Nom du cluster connecté.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--port

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

Propriété	Valeur
Valeur par défaut:	47011

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--token

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

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--name -n

Nom du cluster connecté.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az connectedk8s troubleshoot

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et 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 à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété	Valeur
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 la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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}]
                       [--config --configuration-settings]
                       [--config-protected --config-protected-settings]
                       [--container-log-path]
                       [--custom-ca-cert --proxy-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi --disable-workload-identity {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 --enable-workload-identity {false, true}]
                       [--gateway-resource-id]
                       [--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

Mettez à jour un cluster Kubernetes connecté avec la fonctionnalité de passerelle Azure activée.

az connectedk8s update -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Désactivez la fonctionnalité de passerelle Azure sur un cluster Kubernetes connecté.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété	Valeur
Valeurs acceptées:	false, true

--azure-hybrid-benefit

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

Propriété	Valeur
Valeurs acceptées:	False, NotApplicable, True

--config --configuration-settings

Préversion

--config-protected --config-protected-settings

Préversion

Paramètres protégés de configuration en tant que paire clé=valeur. Répétez le paramètre pour chaque paramètre. Seule la clé est retournée en réponse, la valeur n’est pas.

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

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--disable-gateway

Préversion

Indicateur pour désactiver la passerelle Arc.

Propriété	Valeur
Groupe de paramètres:	Gateway Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

--disable-proxy

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

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments
Valeur par défaut:	False

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

Préversion

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

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments
Valeurs acceptées:	false, true

--distribution

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

Propriété	Valeur
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 la fédération des identités de charge de travail.

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments
Valeurs acceptées:	false, true

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

Préversion

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

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments
Valeurs acceptées:	false, true

--gateway-resource-id

Préversion

ArmID de la ressource De passerelle Arc.

Propriété	Valeur
Groupe de paramètres:	Gateway Arguments

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--proxy-http

URL du proxy Http à utiliser.

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--proxy-https

URL du proxy Https à utiliser.

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--proxy-skip-range

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

Propriété	Valeur
Groupe de paramètres:	Proxy Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--self-hosted-issuer

Préversion

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

Propriété	Valeur
Groupe de paramètres:	Workload Identity Arguments

--skip-ssl-verification

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

Propriété	Valeur
Valeur par défaut:	False

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--tags

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

--yes -y

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--agent-version

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

--ids

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

--skip-ssl-verification

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

Propriété	Valeur
Valeur par défaut:	False

--subscription

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

Propriété	Valeur
Groupe de paramètres:	Resource Id Arguments

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

Propriété	Valeur
Valeur par défaut:	600

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

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

--query

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

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

Commentaires

Cette page a-t-elle été utile ?

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

Commentaires