Share via

az arcdata dc config

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione arcdata per l'interfaccia della riga di comando di Azure (versione 2.3.1 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az arcdata dc config . Altre informazioni sulle estensioni.

Comandi di configurazione.

Comandi

Nome Descrizione Tipo Stato
az arcdata dc config add

Aggiunge un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config init

Inizializzare un profilo di configurazione del controller dati che può essere usato con az arcdata dc create.

 Estensione Disponibilità generale
az arcdata dc config list

Elencare le opzioni del profilo di configurazione disponibili.

 Estensione Disponibilità generale
az arcdata dc config patch

Applicare patch a un file di configurazione basato su un file di patch JSON.

 Estensione Disponibilità generale
az arcdata dc config remove

Rimuove un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config replace

Sostituisce un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config show

Restituisce la configurazione della risorsa personalizzata del controller dati.

 Estensione Disponibilità generale

az arcdata dc config add

Aggiunge un valore per un percorso JSON in un file di configurazione.

Aggiungere il valore nel percorso json nel file di configurazione. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le virgozioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

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

Esempio

Aggiungere l'archiviazione del controller di dati.

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

Parametri necessari

--config-file -c
Deprecato

L'opzione '-c' è stata deprecata e verrà rimossa in una versione futura. Usare invece '-p'.

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

--json-values -j

Elenco di coppie chiave/valore di percorsi JSON dei valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' oppure fornire un percorso di file, ad esempio key=./values.json. Il comando add non supporta le istruzioni condizionali. Se il valore inline specificato è una coppia di valori chiave con "=" e "," caratteri di escape. Ad esempio, key1="key2=val2,key3=val3". Vedere http://jsonpatch.com/ per esempi dell'aspetto del percorso. Se si vuole accedere a una matrice, è necessario farlo indicando l'indice, ad esempio key.0=value.

--path -p

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config init

Inizializzare un profilo di configurazione del controller dati che può essere usato con az arcdata dc create.

Inizializzare un profilo di configurazione del controller dati che può essere usato con az arcdata dc create. È possibile indicare l'origine specifica del profilo di configurazione negli argomenti.

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

Esempio

Esperienza guidata di inizializzazione della configurazione del controller dati: si riceveranno le richieste per i valori necessari.

az arcdata dc config init

arcdata dc config init con argomenti, crea un profilo di configurazione di aks-dev-test in ./custom.

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

Parametri facoltativi

--force -f

Forza la sovrascrittura del file di destinazione.

--path -p

Percorso del file in cui si vuole inserire il profilo di configurazione. Il valore predefinito è /custom.

--source -s

Origine del profilo di configurazione: ['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-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

--target -t
Deprecato

L'opzione '-t' è stata deprecata e verrà rimossa in una versione futura. Usare invece '-p'.

Percorso del file in cui si vuole inserire il profilo di configurazione. Il valore predefinito è /custom.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config list

Elencare le opzioni del profilo di configurazione disponibili.

Elencare le opzioni del profilo di configurazione disponibili per l'uso in arcdata dc config init.

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

Esempio

Mostrare tutti i nomi dei profili di configurazione disponibili.

az arcdata dc config list

Mostrare il codice JSON di un profilo di configurazione specifico.

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

Parametri facoltativi

--config-profile -c

Profilo di configurazione predefinito: ['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-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config patch

Applicare patch a un file di configurazione basato su un file di patch JSON.

Applicare patch al file di configurazione in base al file patch specificato. Per http://jsonpatch.com/ una migliore comprensione del modo in cui devono essere composti i percorsi. L'operazione di sostituzione consente di usare istruzioni condizionali nel percorso grazie alla libreria jsonpath https://jsonpath.com/. Tutti i file JSON di patch devono iniziare con una chiave "patch" che abbia una matrice di patch con le relative informazioni per operazione (add, replace, remove), percorso e valore. L'operazione "remove" non richiede un valore, ma solo un percorso. Vedere gli esempi seguenti.

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

Esempio

Es. 1 - Sostituire la porta di un singolo endpoint (endpoint controller) con il file di patch.

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

Es. 2 - Sostituire l'archiviazione del controller dati con un file di patch.

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"}}]}

Parametri necessari

--config-file -c
Deprecato

L'opzione '-c' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--path'.

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

--patch-file -p

Percorso di un file JSON di patch basato sulla libreria jsonpatch: http://jsonpatch.com/. Il file JSON di patch deve iniziare con una chiave denominata "patch", il cui valore è una matrice di operazioni di patch da eseguire. Per il percorso di un'operazione di patch, è possibile usare la notazione con punto, ad esempio key1.key2, per la maggior parte delle operazioni. Se si vuole eseguire un'operazione di sostituzione e si sta sostituendo un valore in una matrice che richiede un'istruzione condizionale, usare la notazione jsonpath facendo iniziare il percorso con $. Ciò consentirà di eseguire un'istruzione condizionale, ad esempio $.key1.key2[?( @.key3=="someValue"].key4. Vedere gli esempi seguenti. Per altre informazioni sulle condizioni, vedere: https://jsonpath.com/.

--path

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config remove

Rimuove un valore per un percorso JSON in un file di configurazione.

Rimuovere il valore nel percorso json nel file di configurazione. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le virgozioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

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

Esempio

Es. 1 - Rimuovere l'archiviazione del controller dati.

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

Parametri necessari

--config-file -c
Deprecato

L'opzione '-c' è stata deprecata e verrà rimossa in una versione futura. Usare invece '-p'.

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

--json-path -j

Elenco di percorsi JSON basati sulla libreria jsonpatch che indica i valori da rimuovere, ad esempio: key1.subkey1,key2.subkey2. Il comando remove non supporta le istruzioni condizionali. Vedere http://jsonpatch.com/ per esempi dell'aspetto del percorso. Se si vuole accedere a una matrice, è necessario farlo indicando l'indice, ad esempio key.0=value.

--path -p

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config replace

Sostituisce un valore per un percorso JSON in un file di configurazione.

Sostituire il valore nel percorso json nel file config. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le virgozioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

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

Esempio

Es. 1 - Sostituire la porta di un singolo endpoint (endpoint controller dati).

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

Es. 2 - Sostituire l'archiviazione del controller dati.

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

Parametri necessari

--config-file -c
Deprecato

L'opzione '-c' è stata deprecata e verrà rimossa in una versione futura. Usare invece '-p'.

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

--json-values -j

Elenco di coppie chiave/valore di percorsi JSON dei valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' oppure fornire un percorso di file, ad esempio key=./values.json. Il comando replace supporta le condizionali tramite la libreria jsonpath. Per usarle, il percorso deve iniziare con $. Ciò consentirà di eseguire un'istruzione condizionale, ad esempio -j $.key1.key2[?( @.key3=="someValue"].key4=value. Se il valore inline specificato è una coppia di valori chiave con "=" e "," caratteri di escape. Ad esempio, key1="key2=val2,key3=val3". Vedere gli esempi seguenti. Per altre informazioni, vedere: https://jsonpath.com/.

--path -p

Percorso del file di configurazione del controller di dati della configurazione da impostare, ad esempio custom/control.json.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc config show

Restituisce la configurazione della risorsa personalizzata del controller dati.

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

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui è presente il controller dati.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.