az connectedk8s

Note

Esta referencia forma parte de la extensión connectedk8s para la CLI de Azure (versión 2.70.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.	Extension	GA
az connectedk8s delete	Elimine un clúster de Kubernetes conectado junto con agentes de clúster conectados.	Extension	GA
az connectedk8s disable-features	Deshabilita las características selectivas en el clúster conectado.	Extension	Preview
az connectedk8s enable-features	Habilita las características selectivas en el clúster conectado.	Extension	Preview
az connectedk8s list	Enumeración de clústeres de Kubernetes conectados.	Extension	GA
az connectedk8s proxy	Obtenga acceso a un clúster de Kubernetes conectado.	Extension	GA
az connectedk8s show	Mostrar detalles de un clúster de Kubernetes conectado.	Extension	GA
az connectedk8s troubleshoot	Realice comprobaciones de diagnóstico en un clúster de Kubernetes habilitado para Arc.	Extension	Preview
az connectedk8s update	Actualice las propiedades del clúster de Kubernetes incorporado a Arc.	Extension	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.	Extension	GA

az connectedk8s connect

Incorpore un clúster de Kubernetes conectado a Azure.

El clúster de Kubernetes que se va a incorporar como un clúster conectado debe ser el clúster predeterminado en kubeconfig. Ejecute kubectl config get-contexts para confirmar el nombre del contexto de destino. A continuación, establezca el contexto predeterminado en el clúster correcto mediante la ejecución de kubectl config use-context target-cluster-name.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config --configuration-settings]
                        [--config-protected --config-protected-settings]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert --proxy-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 --enable-workload-identity {false, true}]
                        [--gateway-resource-id]
                        [--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 --private-link-scope-resource-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

Incorpore un clúster de Kubernetes conectado con la característica de puerta de enlace de Azure habilitada.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--azure-hybrid-benefit

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

Propiedad	Valor
Valores aceptados:	False, NotApplicable, True

--config --configuration-settings

Vista previa

Opciones de configuración como par clave=valor. Repita el parámetro para cada configuración. No lo use para secretos, ya que este valor se devuelve en respuesta.

--config-protected --config-protected-settings

Vista previa

Valores protegidos de configuración como par clave=valor. Repita el parámetro para cada configuración. Solo se devuelve la clave en respuesta, el valor no.

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

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

Propiedad	Valor
Valor predeterminado:	False

--distribution

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

Propiedad	Valor
Valor predeterminado:	generic
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 federación de identidades de carga de trabajo.

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments
Valor predeterminado:	False
Valores aceptados:	false, true

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

Propiedad	Valor
Grupo de parámetros:	PrivateLink Arguments
Valores aceptados:	false, true

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

Vista previa

Habilite el webhook de identidad de carga de trabajo.

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments
Valor predeterminado:	False
Valores aceptados:	false, true

--gateway-resource-id

Vista previa

ArmID del recurso de puerta de enlace de Arc.

Propiedad	Valor
Grupo de parámetros:	Gateway Arguments

--infrastructure

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

Propiedad

Valor

Valor predeterminado:

generic

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

--kube-config

Ruta de acceso al archivo de configuración kube.

--kube-context

Contexto kubconfig de la máquina actual.

--location -l

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

--no-wait

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

Propiedad	Valor
Grupo de parámetros:	Timeout Arguments
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.

Propiedad	Valor
Grupo de parámetros:	Timeout Arguments
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.

Propiedad	Valor
Grupo de parámetros:	PrivateLink Arguments

--proxy-http

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--proxy-https

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--proxy-skip-range

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--self-hosted-issuer

Vista previa

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

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments

--skip-ssl-verification

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

Propiedad	Valor
Valor predeterminado:	False

--tags

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

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--force

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

Propiedad	Valor
Valor predeterminado:	False

--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

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

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--skip-ssl-verification

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

Propiedad	Valor
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.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--skip-ssl-verification

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

Propiedad	Valor
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.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--custom-locations-oid

OID de la aplicación "ubicaciones personalizadas".

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Azure RBAC Arguments

--skip-ssl-verification

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

Propiedad	Valor
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.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad	Valor
Valor predeterminado:	~\.kube\config

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--kube-context

Si se especifica, sobrescriba el nombre de contexto predeterminado.

--name -n

Nombre del clúster conectado.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--port

Puerto usado para acceder al clúster conectado.

Propiedad	Valor
Valor predeterminado:	47011

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre del clúster conectado.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad	Valor
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 del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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}]
                       [--config --configuration-settings]
                       [--config-protected --config-protected-settings]
                       [--container-log-path]
                       [--custom-ca-cert --proxy-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi --disable-workload-identity {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 --enable-workload-identity {false, true}]
                       [--gateway-resource-id]
                       [--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

Actualice un clúster de Kubernetes conectado con la característica de puerta de enlace de Azure habilitada.

az connectedk8s update -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Deshabilite la característica de puerta de enlace de Azure en un clúster de Kubernetes conectado.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad	Valor
Valores aceptados:	false, true

--azure-hybrid-benefit

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

Propiedad	Valor
Valores aceptados:	False, NotApplicable, True

--config --configuration-settings

Vista previa

Opciones de configuración como par clave=valor. Repita el parámetro para cada configuración. No lo use para secretos, ya que este valor se devuelve en respuesta.

--config-protected --config-protected-settings

Vista previa

Valores protegidos de configuración como par clave=valor. Repita el parámetro para cada configuración. Solo se devuelve la clave en respuesta, el valor no.

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--disable-gateway

Vista previa

Marca para deshabilitar Arc Gateway.

Propiedad	Valor
Grupo de parámetros:	Gateway Arguments
Valor predeterminado:	False
Valores aceptados:	false, true

--disable-proxy

Deshabilita la configuración del proxy para los agentes.

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments
Valor predeterminado:	False

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

Vista previa

Deshabilite el webhook de identidad de carga de trabajo.

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments
Valores aceptados:	false, true

--distribution

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

Propiedad	Valor
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 federación de identidades de carga de trabajo.

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments
Valores aceptados:	false, true

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

Vista previa

Habilite el webhook de identidad de carga de trabajo.

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments
Valores aceptados:	false, true

--gateway-resource-id

Vista previa

ArmID del recurso de puerta de enlace de Arc.

Propiedad	Valor
Grupo de parámetros:	Gateway Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--proxy-http

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--proxy-https

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--proxy-skip-range

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

Propiedad	Valor
Grupo de parámetros:	Proxy Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--self-hosted-issuer

Vista previa

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

Propiedad	Valor
Grupo de parámetros:	Workload Identity Arguments

--skip-ssl-verification

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

Propiedad	Valor
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.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--tags

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

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--agent-version

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

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--skip-ssl-verification

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

Propiedad	Valor
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.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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

Propiedad	Valor
Valor predeterminado:	600

Parámetros globales

--debug

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

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az connectedk8s

Comandos

az connectedk8s connect

Ejemplos

Parámetros requeridos

Parámetros opcionales

az connectedk8s delete

Ejemplos

Parámetros opcionales

az connectedk8s disable-features

Ejemplos

Parámetros requeridos

Parámetros opcionales

az connectedk8s enable-features

Ejemplos

Parámetros requeridos

Parámetros opcionales

az connectedk8s list

Ejemplos

Parámetros opcionales

az connectedk8s proxy

Ejemplos

Parámetros opcionales

az connectedk8s show

Ejemplos

Parámetros opcionales

az connectedk8s troubleshoot

Ejemplos

Parámetros requeridos

Parámetros opcionales

az connectedk8s update

Ejemplos

Parámetros opcionales

az connectedk8s upgrade

Ejemplos

Parámetros opcionales

Comentarios