Partager via

az arcdata dc config

  • Référence

Remarque

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

Commandes de configuration.

Commandes

Nom Description Type Statut
az arcdata dc config add

Ajoutez une valeur pour un chemin d’accès json dans un fichier de configuration.

 Extension GA
az arcdata dc config init

Initialisez un profil de configuration du contrôleur de données qui peut être utilisé avec az arcdata dc create.

 Extension GA
az arcdata dc config list

Répertoriez les choix de profils de configuration disponibles.

 Extension GA
az arcdata dc config patch

Corrigez un fichier de configuration basé sur un fichier patch json.

 Extension GA
az arcdata dc config remove

Supprimez une valeur pour un chemin d’accès json dans un fichier de configuration.

 Extension GA
az arcdata dc config replace

Remplacez une valeur pour un chemin d’accès json dans un fichier de configuration.

 Extension GA
az arcdata dc config show

Retournez la configuration de la ressource personnalisée du contrôleur de données.

 Extension GA

az arcdata dc config add

Ajoutez une valeur pour un chemin d’accès json dans un fichier de configuration.

Ajoutez la valeur au niveau du chemin d’accès json dans le fichier config. Tous les exemples ci-dessous sont fournis dans Bash. Si vous utilisez une autre ligne de commande, vous devrez peut-être échapper correctement. Vous pouvez également utiliser la fonctionnalité de fichier de correctif.

az arcdata dc config add --config-file
                         --json-values
                         --path

Exemples

Ajoutez un stockage du contrôleur de données.

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Paramètres obligatoires

--config-file -c
Déprécié

L’option '-c’a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « -p ».

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

--json-values -j

Liste de paires clé/valeur de chemins d’accès json aux valeurs : key1.subkey1=value1,key2.subkey2=value2. Vous pouvez fournir des valeurs json incluses, telles que : key='{"kind":"cluster","name":"test-cluster"}' ou fournir un chemin d'accès au fichier, tel que key=./values.json. La commande add ne prend PAS en charge les conditionnels. Si la valeur incluse que vous fournissez est une paire clé-valeur elle-même avec des caractères « = » et « , », mettez ces caractères dans une séquence d’échappement. Par exemple, key1="key2=val2,key3=val3". Consultez http://jsonpatch.com/ pour obtenir des exemples d’apparence de votre chemin d’accès. Si vous souhaitez accéder à un tableau, vous devez le faire en indiquant l’index, tel que key.0=value.

--path -p

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

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 arcdata dc config init

Initialisez un profil de configuration du contrôleur de données qui peut être utilisé avec az arcdata dc create.

Initialisez un profil de configuration du contrôleur de données qui peut être utilisé avec az arcdata dc create. La source spécifique du profil de configuration peut être spécifiée dans les arguments.

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

Exemples

Expérience d’initialisation de configuration du contrôleur de données guidée : vous serez invité à entrer les valeurs nécessaires.

az arcdata dc config init

La commande arcdata dc config init avec des arguments crée un profil de configuration aks-dev-test dans ./custom.

az arcdata dc config init --source azure-arc-kubeadm --path custom

Paramètres facultatifs

--force -f

Forcez le remplacement du fichier cible.

--path -p

Chemin de fichier de l’emplacement où vous souhaitez placer le profil de configuration. Il est défini par défaut sur /custom.

--source -s

Source du profil de configuration : ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', « azure-arc-aks-hci », « azure-arc-aks-premium-storage », « azure-arc-azure-openshift », « azure-arc-eks », « azure-arc-gke », « azure-arc-kubeadm », « azure-arc-kubeadm », « azure-arc-kubeadm-dev-test », « azure-arc-openshift », « azure-arc-unit-test ».

--target -t
Déprécié

L’option '-t’a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « -p ».

Chemin de fichier de l’emplacement où vous souhaitez placer le profil de configuration. Il est défini par défaut sur /custom.

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 arcdata dc config list

Répertoriez les choix de profils de configuration disponibles.

Répertorier les choix de profil de configuration disponibles à utiliser dans arcdata dc config init.

az arcdata dc config list [--config-profile]

Exemples

Affiche les noms de profils de configuration disponibles.

az arcdata dc config list

Affiche json d’un profil de configuration spécifique.

az arcdata dc config list --config-profile aks-dev-test

Paramètres facultatifs

--config-profile -c

Profil de configuration par défaut : ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', « azure-arc-aks-hci », « azure-arc-aks-premium-storage », « azure-arc-azure-openshift », « azure-arc-eks », « azure-arc-gke », « azure-arc-kubeadm », « azure-arc-kubeadm », « azure-arc-kubeadm-dev-test », « azure-arc-openshift », « azure-arc-unit-test ».

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 arcdata dc config patch

Corrigez un fichier de configuration basé sur un fichier patch json.

Corrigez le fichier config en fonction du fichier patch donné. Consultez http://jsonpatch.com/ pour mieux comprendre comment les chemins d’accès doivent être composés. L’opération de remplacement peut utiliser des conditions dans son chemin d’accès en raison de la bibliothèque jsonpath https://jsonpath.com/. Tous les fichiers json des correctifs doivent commencer par une clé « correctif » qui contient un tableau de correctifs avec les opérations (ajouter, remplacer, supprimer), le chemin d’accès et la valeur correspondants. L’opération « supprimer » ne requiert pas de valeur, juste un chemin d’accès. Considérons les exemples ci-dessous.

az arcdata dc config patch --config-file
                           --patch-file
                           --path

Exemples

Exemple 1 : remplacez le port d’un point de terminaison unique (point de terminaison du contrôleur de données) par un fichier correctif.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

Exemple 2 : remplacez un stockage du contrôleur de données par un fichier correctif.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Paramètres obligatoires

--config-file -c
Déprécié

L’option '-c’a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --path ».

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

--patch-file -p

Chemin d'accès à un fichier json du correctif basé sur la bibliothèque jsonpatch : http://jsonpatch.com/. Vous devez démarrer votre fichier json du correctif par une clé appelée « correctif », dont la valeur est un tableau d’opérations PATCH que vous envisagez de créer. Pour le chemin d’accès d’une opération PATCH, vous pouvez utiliser la notation, telle que key1.key2 pour la plupart des opérations. Si vous souhaitez effectuer une opération de remplacement et que vous remplacez une valeur dans un tableau qui requiert une condition, utilisez la notation jsonpath en commençant votre chemin d’accès par un $. Cela vous permettra d’effectuer une opération conditionnelle telle que $.key1.key2[ ?( @.key3=="someValue"].key4. Considérons les exemples ci-dessous. Pour obtenir de l’aide supplémentaire sur les conditionnels, consultez : https://jsonpath.com/.

--path

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

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 arcdata dc config remove

Supprimez une valeur pour un chemin d’accès json dans un fichier de configuration.

Supprimez la valeur au niveau du chemin d’accès json dans le fichier config. Tous les exemples ci-dessous sont fournis dans Bash. Si vous utilisez une autre ligne de commande, vous devrez peut-être échapper correctement. Vous pouvez également utiliser la fonctionnalité de fichier de correctif.

az arcdata dc config remove --config-file
                            --json-path
                            --path

Exemples

Exemple 1 : supprimez un stockage du contrôleur de données.

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

Paramètres obligatoires

--config-file -c
Déprécié

L’option '-c’a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « -p ».

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

--json-path -j

Une liste de chemins d’accès json basés sur la bibliothèque jsonpatch qui indique les valeurs que vous souhaitez supprimer, par exemple : key1.subkey1,key2.subkey2. La commande remove ne prend pas en charge les conditions. Consultez http://jsonpatch.com/ pour obtenir des exemples d’apparence de votre chemin d’accès. Si vous souhaitez accéder à un tableau, vous devez le faire en indiquant l’index, tel que key.0=value.

--path -p

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

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 arcdata dc config replace

Remplacez une valeur pour un chemin d’accès json dans un fichier de configuration.

Remplacez la valeur au niveau du chemin d’accès json dans le fichier config. Tous les exemples ci-dessous sont fournis dans Bash. Si vous utilisez une autre ligne de commande, vous devrez peut-être échapper correctement. Vous pouvez également utiliser la fonctionnalité de fichier de correctif.

az arcdata dc config replace --config-file
                             --json-values
                             --path

Exemples

Exemple 1 : remplacez le port d’un point de terminaison unique (point de terminaison du contrôleur de données).

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Exemple 2 : remplacez un stockage du contrôleur de données.

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Paramètres obligatoires

--config-file -c
Déprécié

L’option '-c’a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « -p ».

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

--json-values -j

Liste de paires clé/valeur de chemins d’accès json aux valeurs : key1.subkey1=value1,key2.subkey2=value2. Vous pouvez fournir des valeurs json incluses, telles que : key='{"kind":"cluster","name":"test-cluster"}' ou fournir un chemin d'accès au fichier, tel que key=./values.json. La commande replace prend en charge les conditionnels dans la bibliothèque jsonpath. Pour ce faire, démarrez votre chemin d’accès par un $. Cela vous permettra d’effectuer une opération conditionnelle telle que -j $.key1.key2[ ?( @.key3=="someValue"].key4=value. Si la valeur incluse que vous fournissez est une paire clé-valeur elle-même avec des caractères « = » et « , », mettez ces caractères dans une séquence d’échappement. Par exemple, key1="key2=val2,key3=val3". Consultez les exemples ci-dessous. Pour obtenir de l’aide supplémentaire, consultez : https://jsonpath.com/.

--path -p

Chemin du fichier de configuration du contrôleur de données de la configuration que vous souhaitez définir, c’est-à-dire custom/control.json.

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 arcdata dc config show

Retournez la configuration de la ressource personnalisée du contrôleur de données.

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

Paramètres facultatifs

--k8s-namespace -k

Espace de noms Kubernetes dans lequel le contrôleur de données existe.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

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.