az connectedk8s

Nota:

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

Comandos para administrar clústeres de Kubernetes conectados.

Comandos

Nombre	Description	Tipo	Estado
az connectedk8s connect	Incorpore un clúster de Kubernetes conectado a Azure.	Extensión	GA
az connectedk8s delete	Elimine un clúster de Kubernetes conectado junto con agentes de clúster conectados.	Extensión	GA
az connectedk8s disable-features	Deshabilita las características selectivas en el clúster conectado.	Extensión	Vista previa
az connectedk8s enable-features	Habilita las características selectivas en el clúster conectado.	Extensión	Vista previa
az connectedk8s list	Enumeración de clústeres de Kubernetes conectados.	Extensión	GA
az connectedk8s proxy	Obtenga acceso a un clúster de Kubernetes conectado.	Extensión	GA
az connectedk8s show	Mostrar detalles de un clúster de Kubernetes conectado.	Extensión	GA
az connectedk8s troubleshoot	Realice comprobaciones de diagnóstico en un clúster de Kubernetes habilitado para Arc.	Extensión	Vista previa
az connectedk8s update	Actualice las propiedades del clúster de Kubernetes incorporado a Arc.	Extensión	GA
az connectedk8s upgrade	Actualice de forma atómica los agentes incorporados a la versión específica o de forma predeterminada a la versión más reciente.	Extensión	GA

az connectedk8s connect

Incorpore un clúster de Kubernetes conectado a Azure.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-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 {false, true}]
                        [--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]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Ejemplos

Incorpore un clúster de Kubernetes conectado con el contexto kube config y kube predeterminados.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Incorpore un clúster de Kubernetes conectado con la configuración de kube predeterminada y el contexto kube y deshabilite la actualización automática de los agentes de arc.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

Incorpore un clúster de Kubernetes conectado especificando kubeconfig y kubecontext.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Incorpore un clúster de Kubernetes conectado especificando el proxy https, el proxy http y ninguna configuración 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

Incorpore un clúster de Kubernetes conectado especificando el proxy https, el proxy http, ningún proxy con la configuración del certificado.

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

Incorpore un clúster de Kubernetes conectado con la característica private link habilitada especificando parámetros de vínculo privado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

Incorpore un clúster de Kubernetes conectado con el tiempo de espera de incorporación personalizado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

Incorpore un clúster de Kubernetes conectado con el emisor de oidc y el webhook de identidad de carga de trabajo habilitado.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Incorpore un clúster de Kubernetes conectado con el emisor oidc habilitado mediante una dirección URL del emisor autohospedado para el clúster de nube pública.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Parámetros requeridos

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--azure-hybrid-benefit

Marca para habilitar o deshabilitar Ventaja híbrida de Azure característica.

Valores aceptados: False, NotApplicable, True

--container-log-path

Invalide la ruta de acceso del registro de contenedor predeterminada para habilitar el registro de fluent-bit.

--correlation-id

Guid que se usa para realizar un seguimiento interno del origen de la incorporación de clústeres. No lo modifique a menos que se lo indique.

--custom-ca-cert --proxy-cert

Ruta de acceso al archivo de certificado para proxy o entidad de certificación personalizada.

--custom-locations-oid

OID de la aplicación "ubicaciones personalizadas".

--disable-auto-upgrade

Marca para deshabilitar la actualización automática de agentes de arc.

Valor predeterminado: False

--distribution

La distribución de Kubernetes que se ejecutará en este clúster conectado.

Valores aceptados: 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

Valor predeterminado: generic

--distribution-version

Versión de distribución de Kubernetes del clúster conectado.

--enable-oidc-issuer

Vista previa

Habilite la creación de la dirección URL del emisor de OIDC que se usa para la identidad de carga de trabajo.

Valores aceptados: false, true

Valor predeterminado: False

--enable-private-link

Vista previa

Marca para habilitar o deshabilitar la compatibilidad con private link en un recurso de clúster conectado. Valores permitidos: false, true.

Valores aceptados: false, true

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

Vista previa

Habilite el webhook de identidad de carga de trabajo.

Valores aceptados: false, true

Valor predeterminado: False

--infrastructure

La infraestructura en la que se ejecutará el clúster de Kubernetes representado por este clúster conectado.

Valores aceptados: 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

Valor predeterminado: generic

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False

--onboarding-timeout

Tiempo necesario (en segundos) para que los pods de arc-agent se instalen en el clúster de Kubernetes. Invalide este valor si las restricciones de hardware o red del clúster requieren más tiempo para instalar los pods de arc-agent.

Valor predeterminado: 1200

--pls-arm-id --private-link-scope-resource-id

Vista previa

Identificador de recurso de ARM del recurso de ámbito de vínculo privado al que está asociado este clúster conectado.

--proxy-http

Dirección URL del proxy HTTP que se va a usar.

--proxy-https

Dirección URL del proxy https que se va a usar.

--proxy-skip-range

Lista de direcciones URL o CIDR para las que no se debe usar el proxy.

--self-hosted-issuer

Vista previa

Dirección URL del emisor autohospedado para clústeres de nube pública: AKS, GKE, EKS.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--yes -y

No solicita confirmación.

Valor predeterminado: False

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

Elimine un clúster de Kubernetes conectado junto con agentes de clúster conectados.

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

Ejemplos

Elimine un clúster de Kubernetes conectado y los agentes de clúster conectados con kubeconfig y kubecontext predeterminados.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Elimine un clúster de Kubernetes conectado especificando kubeconfig y kubecontext para la eliminación de agentes de clúster conectados.

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Parámetros opcionales

--force

Forzar la eliminación para quitar todos los recursos de Azure-Arc del clúster.

Valor predeterminado: False

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--name -n

Nombre del clúster conectado.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--subscription

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

--yes -y

No solicita confirmación.

Valor predeterminado: False

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 connectedk8s disable-features

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Deshabilita las características selectivas en el clúster conectado.

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

Ejemplos

Deshabilita la característica azure-rbac.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

Deshabilite varias características.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

Parámetros requeridos

--features

Lista separada por espacios de características que desea deshabilitar.

Valores aceptados: azure-rbac, cluster-connect, custom-locations

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--subscription

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

--yes -y

No solicita confirmación.

Valor predeterminado: False

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 connectedk8s enable-features

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Habilita las características selectivas en el clúster conectado.

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]

Ejemplos

Habilita la característica Cluster-Connect.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Habilite la característica RBAC de Azure.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

Habilite varias características.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

Parámetros requeridos

--features

Lista separada por espacios de las características que desea habilitar.

Valores aceptados: azure-rbac, cluster-connect, custom-locations

Parámetros opcionales

--custom-locations-oid

OID de la aplicación "ubicaciones personalizadas".

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--skip-azure-rbac-list

Lista separada por comas de nombres de nombres de usuario/correo electrónico/oid. Azure RBAC se omitirá para estos usuarios. Especifique al habilitar azure-rbac.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--subscription

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

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

Enumeración de clústeres de Kubernetes conectados.

az connectedk8s list [--resource-group]

Ejemplos

Enumere todos los clústeres de Kubernetes conectados en un grupo de recursos.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Enumere todos los clústeres de Kubernetes conectados en una suscripción.

az connectedk8s list --subscription subscriptionName

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Obtenga acceso a un clúster de Kubernetes conectado.

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

Ejemplos

Obtenga acceso a un clúster de Kubernetes conectado.

az connectedk8s proxy -n clusterName -g resourceGroupName

Obtención del acceso a un clúster de Kubernetes conectado con el puerto personalizado

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

Obtención del acceso a un clúster de Kubernetes conectado con el token de cuenta de servicio

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

Obtención del acceso a un clúster de Kubernetes conectado especificando la ubicación de kubeconfig personalizada

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

Obtención del acceso a un clúster de Kubernetes conectado especificando el contexto personalizado

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

Parámetros opcionales

--file -f

Archivo de configuración de Kubernetes que se va a actualizar. Si no se proporciona, actualiza el archivo '~/.kube/config'. Use "-" para imprimir YAML en stdout en su lugar.

Valor predeterminado: ~\.kube\config

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-context

Si se especifica, sobrescriba el nombre de contexto predeterminado.

--name -n

Nombre del clúster conectado.

--port

Puerto usado para acceder al clúster conectado.

Valor predeterminado: 47011

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

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

--token

Token de cuenta de servicio que se va a usar para autenticarse en el clúster de Kubernetes.

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

Mostrar detalles de un clúster de Kubernetes conectado.

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Ejemplos

Mostrar los detalles de un clúster de Kubernetes conectado

az connectedk8s show -g resourceGroupName -n connectedClusterName

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

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

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

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Realice comprobaciones de diagnóstico en un clúster de Kubernetes habilitado para Arc.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

Ejemplos

Realice comprobaciones de diagnóstico en un clúster de Kubernetes habilitado para Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Parámetros requeridos

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubeconfig de la máquina actual.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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

Actualice las propiedades del clúster de Kubernetes incorporado a Arc.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--container-log-path]
                       [--custom-ca-cert]
                       [--disable-proxy]
                       [--disable-wi {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 {false, true}]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

Ejemplos

Actualización de los valores de proxy para los agentes

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

Deshabilitación de la configuración de proxy para agentes

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

Deshabilitación de la actualización automática de agentes

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

Actualice un clúster de Kubernetes conectado con el emisor oidc y el webhook de identidad de carga de trabajo habilitado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Actualice un clúster de Kubernetes conectado con el emisor oidc habilitado mediante una dirección URL del emisor autohospedado para el clúster de nube pública.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Deshabilite el webhook de identidad de carga de trabajo en un clúster de Kubernetes conectado.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

Parámetros opcionales

--auto-upgrade

Marca para habilitar o deshabilitar la actualización automática de agentes de arc. De forma predeterminada, la actualización automática de agentes está habilitada.

Valores aceptados: false, true

--azure-hybrid-benefit

Marca para habilitar o deshabilitar Ventaja híbrida de Azure característica.

Valores aceptados: False, NotApplicable, True

--container-log-path

Invalide la ruta de acceso del registro de contenedor predeterminada para habilitar el registro de fluent-bit.

--custom-ca-cert --proxy-cert

Ruta de acceso al archivo de certificado para proxy o entidad de certificación personalizada.

--disable-proxy

Deshabilita la configuración del proxy para los agentes.

Valor predeterminado: False

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

Vista previa

Deshabilite el webhook de identidad de carga de trabajo.

Valores aceptados: false, true

--distribution

La distribución de Kubernetes que se ejecutará en este clúster conectado.

Valores aceptados: 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

Versión de distribución de Kubernetes del clúster conectado.

--enable-oidc-issuer

Vista previa

Habilite la creación de la dirección URL del emisor de OIDC que se usa para la identidad de carga de trabajo.

Valores aceptados: false, true

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

Vista previa

Habilite el webhook de identidad de carga de trabajo.

Valores aceptados: false, true

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--name -n

Nombre del clúster conectado.

--proxy-http

Dirección URL del proxy HTTP que se va a usar.

--proxy-https

Dirección URL del proxy https que se va a usar.

--proxy-skip-range

Lista de direcciones URL o CIDR para las que no se debe usar el proxy.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--self-hosted-issuer

Vista previa

Dirección URL del emisor autohospedado para clústeres de nube pública: AKS, GKE, EKS.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--subscription

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--yes -y

No solicita confirmación.

Valor predeterminado: False

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

Actualice de forma atómica los agentes incorporados a la versión específica o de forma predeterminada a la versión más reciente.

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

Ejemplos

Actualización de los agentes a la versión más reciente

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

Actualización de los agentes a una versión específica

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

Actualice los agentes con tiempo de espera de actualización personalizado.

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

Parámetros opcionales

--agent-version

Versión del agente a la que actualizar los gráficos de Helm.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--name -n

Nombre del clúster conectado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--skip-ssl-verification

Omita la comprobación SSL para cualquier conexión de clúster.

Valor predeterminado: False

--subscription

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

--upgrade-timeout

Tiempo necesario (en segundos) para que los pods de arc-agent se actualicen en el clúster de Kubernetes. Invalide este valor si las restricciones de hardware o red del clúster requieren más tiempo para actualizar los pods de arc-agent.

Valor predeterminado: 600

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.