az arcdata dc config

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

Comandi di configurazione.

Comandi

Nome	Descrizione	Tipo	Status
az arcdata dc config add	Aggiungere un valore per un percorso JSON in un file di configurazione.	Estensione	GA
az arcdata dc config init	Inizializzare un profilo di configurazione del controller dati che può essere usato con az arcdata dc create.	Estensione	GA
az arcdata dc config list	Elencare le opzioni del profilo di configurazione disponibili.	Estensione	GA
az arcdata dc config patch	Applicare patch a un file di configurazione basato su un file di patch JSON.	Estensione	GA
az arcdata dc config remove	Rimuovere un valore per un percorso JSON in un file di configurazione.	Estensione	GA
az arcdata dc config replace	Sostituire un valore per un percorso JSON in un file di configurazione.	Estensione	GA
az arcdata dc config show	Restituisce la configurazione della risorsa personalizzata del controller dati.	Estensione	GA

az arcdata dc config add

Aggiungere 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 sono riportati in 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 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 personalizzato/control.json.

--json-values -j

Elenco di coppie chiave-valore di percorsi JSON ai valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' o specificare 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 personalizzato/control.json.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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. L'origine specifica del profilo di configurazione può essere specificata negli argomenti.

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

Esempio

Esperienza di configurazione guidata del controller dati: si riceveranno 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

Forzare la sovrascrittura del file di destinazione.

--path -p

Percorso del file in cui si vuole posizionare il profilo di configurazione, per impostazione predefinita cwd/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 posizionare il profilo di configurazione, per impostazione predefinita cwd/custom.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az arcdata dc config list

Elencare le opzioni del profilo di configurazione disponibili.

Elencare le opzioni disponibili per il profilo di configurazione da usare in arcdata dc config init.

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

Esempio

Mostra tutti i nomi dei profili di configurazione disponibili.

az arcdata dc config list

Mostra 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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 una migliore comprensione del modo in cui devono essere composti i percorsi, consultare http://jsonpatch.com/. L'operazione di sostituzione può usare le condizioni nel percorso a causa della libreria jsonpath https://jsonpath.com/. Tutti i file JSON patch devono iniziare con una chiave di "patch" con una matrice di patch con il corrispondente op (aggiunta, sostituzione, rimozione), percorso e valore. L'op "remove" non richiede un valore, ma solo un percorso. Vedere gli esempi seguenti.

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

Esempio

Ex 1 : sostituire la porta di un singolo endpoint (endpoint del controller di dati) 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}]}

Ex 2 - Sostituire l'archiviazione del controller dati con il file 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 personalizzato/control.json.

--patch-file -p

Percorso di un file JSON patch basato sulla libreria jsonpatch: http://jsonpatch.com/. È necessario avviare il file JSON patch con una chiave denominata "patch", il cui valore è una matrice di operazioni patch che si intende eseguire. Per il percorso di un'operazione patch, è possibile usare la notazione punto, ad esempio key1.key2 per la maggior parte delle operazioni. Se si vuole eseguire un'operazione di sostituzione e si sostituisce un valore in una matrice che richiede un'istruzione condizionale, usare la notazione jsonpath iniziando 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 istruzioni condizionali, vedere: https://jsonpath.com/.

--path

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

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az arcdata dc config remove

Rimuovere 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 sono riportati in 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 patch.

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

Esempio

Ad esempio 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 personalizzato/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 personalizzato/control.json.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az arcdata dc config replace

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

Sostituire il valore nel percorso json nel file config. Tutti gli esempibelow vengono forniti in 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 patch.

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

Esempio

Ex 1 : sostituire la porta di un singolo endpoint (endpoint del controller di dati).

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

Ex 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 personalizzato/control.json.

--json-values -j

Elenco di coppie chiave-valore di percorsi JSON ai valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' o specificare un percorso di file, ad esempio key=./values.json. Il comando replace supporta le condizionali tramite la libreria jsonpath. Per usarlo, iniziare il percorso 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". Di seguito sono riportati esempi. Per altre informazioni, vedere: https://jsonpath.com/.

--path -p

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

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 di dati.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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