az arcdata dc config

Nota:

Esta referencia forma parte de la extensión arcdata para la CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az arcdata dc config . Obtenga más información sobre las extensiones.

Comandos de configuración.

Comandos

Nombre	Description	Tipo	Estado
az arcdata dc config add	Agrega un valor a una ruta de acceso json en un archivo de configuración.	Extensión	GA
az arcdata dc config init	Inicializa un perfil de configuración de controlador de datos que puede usarse con az arcdata dc create.	Extensión	GA
az arcdata dc config list	Muestra las opciones de perfil de configuración disponibles.	Extensión	GA
az arcdata dc config patch	Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.	Extensión	GA
az arcdata dc config remove	Quita un valor de una ruta de acceso json en un archivo de configuración.	Extensión	GA
az arcdata dc config replace	Reemplaza un valor de una ruta de acceso json en un archivo de configuración.	Extensión	GA
az arcdata dc config show	Devuelve la configuración del recurso personalizado del controlador de datos.	Extensión	GA

az arcdata dc config add

Agrega un valor a una ruta de acceso json en un archivo de configuración.

Agrega el valor a la ruta de acceso JSON del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comquotaciones correctamente. Como alternativa, puede usar la función del archivo de revisión.

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

Ejemplos

Incorporación de almacenamiento del controlador de datos.

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

Parámetros requeridos

--config-file -c

Obsoleto

La opción "-c" está en desuso y se quitará en una versión futura. Use '-p' en su lugar.

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

--json-values -j

Lista de pares de clave y valor de rutas json a valores: clave1.subclave1=valor1,clave2.subclave2=valor2. Puede proporcionar valores json insertados (como key='{"kind":"cluster","name":"test-cluster"}'), o bien puede especificar una ruta de archivo (por ejemplo, clave=./valores.json). El comando add NO admite condicionales. Si el valor en línea facilitado es en sí mismo un par clave-valor con "=" y ",", añádales caracteres de escape. Por ejemplo, key1="key2=val2,key3=val3". Vea http://jsonpatch.com/ para obtener ejemplos sobre la apariencia que debe tener la ruta. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config init

Inicializa un perfil de configuración de controlador de datos que puede usarse con az arcdata dc create.

Inicializa un perfil de configuración de controlador de datos que puede usarse con az arcdata dc create. El origen concreto del perfil de configuración se puede especificar en los argumentos.

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

Ejemplos

Experiencia de inicialización de configuración de controlador de datos guiada: se le van a solicitar los valores necesarios.

az arcdata dc config init

arcdata dc config init con argumentos, crea un perfil de configuración de aks-dev-test en ./custom.

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

Parámetros opcionales

--force -f

Obliga a sobrescribir el archivo de destino.

--path -p

Ruta de acceso de archivo donde quiere colocar el perfil de configuración (se usa /custom de forma predeterminada)

--source -s

Origen del perfil de configuración: ['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'].

--target -t

Obsoleto

La opción "-t" está en desuso y se quitará en una versión futura. Use '-p' en su lugar.

Ruta de acceso de archivo donde quiere colocar el perfil de configuración (se usa /custom de forma predeterminada)

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config list

Muestra las opciones de perfil de configuración disponibles.

Enumere las opciones de perfil de configuración disponibles para su uso en arcdata dc config init.

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

Ejemplos

Muestra todos los nombres disponibles del perfil de configuración.

az arcdata dc config list

Muestra código json de un perfil de configuración específico.

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

Parámetros opcionales

--config-profile -c

Perfil de configuración predeterminado: ['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'].

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config patch

Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.

Aplica una revisión en el archivo de configuración según el archivo de revisión especificado. Para obtener más información sobre cómo se deben componer las rutas de acceso, consulte http://jsonpatch.com/. La operación de reemplazar puede usar declaraciones condicionales en la ruta debido a la biblioteca jsonpath https://jsonpath.com/. Todos los archivos json de revisión tienen que iniciarse con una clave de “patch”, que tiene una matriz de revisiones con la correspondiente operación (add [agregar], replace [reemplazar], remove [quitar]), ruta y valor. La operación “remove” (quitar) no necesita un valor, solo una ruta de acceso. Consulte los ejemplos más abajo.

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

Ejemplos

Ejemplo 1: Reemplazo del puerto de un único punto de conexión (punto de conexión del controlador de datos) por un archivo de revisión.

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

Ejemplo 2: Reemplazo de almacenamiento del controlador de datos por un archivo de revisión.

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

Parámetros requeridos

--config-file -c

Obsoleto

La opción "-c" está en desuso y se quitará en una versión futura. Use "--path" en su lugar.

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

--patch-file -p

Ruta a un archivo json de revisión basado en la biblioteca jsonpatch: http://jsonpatch.com/. Tiene que empezar el archivo json de revisión con una clave denominada “patch”, cuyo valor es una matriz de operaciones de revisión que quiere realizar. Para la ruta de una operación de revisión, puede usar la notación de puntos (como clave1.clave2) para la mayoría de las operaciones. Si no quiere realizar una operación de reemplazo y va a reemplazar un valor en una matriz que necesita una condicional, use la notación jsonpath (para hacerlo, agregue un signo de $ al principio de la ruta de acceso). Esto le permitirá realizar una condicional como $.key1.key2[?( @.key3=="someValue"].key4. Consulte los ejemplos más abajo. Para obtener más ayuda con los condicionales, consulte https://jsonpath.com/.

--path

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config remove

Quita un valor de una ruta de acceso json en un archivo de configuración.

Quita el valor de la ruta de acceso JSON del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comquotaciones correctamente. Como alternativa, puede usar la función del archivo de revisión.

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

Ejemplos

Ejemplo 1: Eliminación de almacenamiento del controlador de datos.

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

Parámetros requeridos

--config-file -c

Obsoleto

La opción "-c" está en desuso y se quitará en una versión futura. Use '-p' en su lugar.

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

--json-path -j

Lista de rutas json basadas en la biblioteca jsonpatch que indica qué valores quiere quitar (por ejemplo, “clave1.subclave1,clave2.subclave2”). El comando "remove" NO admite condicionales. Vea http://jsonpatch.com/ para obtener ejemplos sobre la apariencia que debe tener la ruta. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config replace

Reemplaza un valor de una ruta de acceso json en un archivo de configuración.

Reemplaza el valor en la ruta de acceso json del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comquotaciones correctamente. Como alternativa, puede usar la función del archivo de revisión.

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

Ejemplos

Ejemplo 1: Reemplazo del puerto de un único punto de conexión (punto de conexión del controlador de datos).

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

Ejemplo 2: Reemplazo de almacenamiento del controlador de datos.

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

Parámetros requeridos

--config-file -c

Obsoleto

La opción "-c" está en desuso y se quitará en una versión futura. Use '-p' en su lugar.

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

--json-values -j

Lista de pares de clave y valor de rutas json a valores: clave1.subclave1=valor1,clave2.subclave2=valor2. Puede proporcionar valores json insertados (como key='{"kind":"cluster","name":"test-cluster"}'), o bien puede especificar una ruta de archivo (por ejemplo, clave=./valores.json). El comando replace admite condicionales mediante la biblioteca jsonpath. Para usar esto, inicie la ruta con un signo de $. Esto le permitirá realizar un condicional como -j $.key1.key2[?( @.key3=="someValue"].key4=value. Si el valor en línea facilitado es en sí mismo un par clave-valor con "=" y ",", añádales caracteres de escape. Por ejemplo, key1="key2=val2,key3=val3". A continuación, se muestran algunos ejemplos. Para obtener ayuda adicional, consulte: https://jsonpath.com/.

--path -p

Ruta de acceso del archivo de configuración del controlador de datos de la configuración que desea establecer, es decir, custom/control.json.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc config show

Devuelve la configuración del recurso personalizado del controlador de datos.

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

Parámetros opcionales

--k8s-namespace -k

El espacio de nombres de Kubernetes en el que existe el controlador de datos.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.