Compartir a través de

az aks addon

Note

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

Comandos para administrar y ver condiciones de complemento únicas.

Comandos

Nombre Description Tipo Estado
az aks addon disable

Deshabilite un complemento de Kubernetes habilitado en un clúster.

 Extension GA
az aks addon enable

Habilite un complemento de Kubernetes.

 Extension GA
az aks addon list

Muestra el estado de todos los complementos de Kubernetes en un clúster determinado.

 Extension GA
az aks addon list-available

Enumere los complementos de Kubernetes disponibles.

 Extension GA
az aks addon show

Mostrar el estado y la configuración de un complemento de Kubernetes habilitado en un clúster determinado.

 Extension GA
az aks addon update

Actualice un complemento de Kubernetes ya habilitado.

 Extension GA

az aks addon disable

Deshabilite un complemento de Kubernetes habilitado en un clúster.

az aks addon disable --addon
                     --name
                     --resource-group
                     [--no-wait]

Ejemplos

Deshabilite el complemento "supervisión".

az aks addon disable -g myResourceGroup -n myAKSCluster -a monitoring

Parámetros requeridos

--addon -a

Especifique el complemento de Kubernetes que se va a deshabilitar.

--name -n

Nombre del clúster administrado.

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

--no-wait

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

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 aks addon enable

Habilite un complemento de Kubernetes.

Estos complementos están disponibles: http_application_routing: configure la entrada con la creación automática de nombres DNS públicos. supervisión: active la supervisión de Log Analytics. Usa el área de trabajo predeterminada de Log Analytics si existe; de lo contrario, crea una. Especifique "--workspace-resource-id" para usar un área de trabajo existente. Si el complemento de supervisión está habilitado --no-wait, el argumento no tendrá ningún efecto virtual-node: habilite el nodo virtual de AKS. Requiere --subnet-name para proporcionar el nombre de una subred existente para que use el nodo virtual. azure-policy: habilite Azure Policy. El complemento de Azure Policy para AKS permite cumplimientos y medidas de seguridad a escala en los clústeres de una manera centralizada y coherente. Obtenga más información en aka.ms/aks/policy. ingress-appgw: habilite el complemento Controlador de entrada de Application Gateway (VERSIÓN PRELIMINAR). open-service-mesh: habilite el complemento Open Service Mesh (VERSIÓN PRELIMINAR). gitops: habilite GitOps (VERSIÓN PRELIMINAR). azure-keyvault-secrets-provider: habilite el complemento Proveedor de secretos de Azure Keyvault. web_application_routing: habilite el complemento De enrutamiento de aplicaciones (VERSIÓN PRELIMINAR). Especifique "--dns-zone-resource-id" para configurar DNS.

az aks addon enable --addon
                    --name
                    --resource-group
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-high-log-scale-mode {false, true}]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Ejemplos

Habilite un complemento de Kubernetes. (autogenerated)

az aks addon enable --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Habilite el complemento ingress-appgw con el prefijo de subred.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Habilite el complemento open-service-mesh.

az aks addon enable --name MyManagedCluster --resource-group MyResourceGroup -a open-service-mesh

Parámetros requeridos

--addon -a

Especifique el complemento de Kubernetes que se va a habilitar.

--name -n

Nombre del clúster administrado.

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

--ampls-resource-id
Vista previa

Identificador de recurso del ámbito de Private Link de Azure Monitor para el complemento de supervisión.

--appgw-id

Identificador de recurso de una instancia de Application Gateway existente que se va a usar con AGIC. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-name

Nombre de la puerta de enlace de aplicaciones para crear o usar en el grupo de recursos del nodo. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-subnet-cidr

CIDR de subred que se usará para una nueva subred creada para implementar Application Gateway. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-subnet-id

Identificador de recurso de una subred existente que se usa para implementar Application Gateway. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-watch-namespace

Especifique el espacio de nombres, que debe observar AGIC. Este puede ser un valor de cadena único o una lista de espacios de nombres separada por comas. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--data-collection-settings
Vista previa

Ruta de acceso al archivo JSON que contiene la configuración de recopilación de datos para el complemento Supervisión.

--dns-zone-resource-ids
Vista previa

Lista separada por comas de identificadores de recursos del recurso de zona DNS que se va a usar con el complemento De enrutamiento de aplicaciones.

--enable-high-log-scale-mode
Vista previa

Habilite el modo de escalado de registros altos para los registros de contenedor.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--enable-msi-auth-for-monitoring
Vista previa

Envíe datos de supervisión a Log Analytics mediante la identidad asignada del clúster (en lugar de la clave compartida del área de trabajo de Log Analytics).

Propiedad Valor
Valor predeterminado: True
Valores aceptados: false, true
--enable-secret-rotation

Habilite la rotación de secretos. Use con el complemento azure-keyvault-secrets-provider.

Propiedad Valor
Valor predeterminado: False
--enable-sgxquotehelper

Habilite el asistente de comillas SGX para el complemento confcom.

Propiedad Valor
Valor predeterminado: False
--enable-syslog
Vista previa

Habilite la recopilación de datos de syslog para el complemento Supervisión.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--rotation-poll-interval

Establezca el intervalo de sondeo de rotación. Use con el complemento azure-keyvault-secrets-provider.

--subnet-name -s

Nombre de subred del nodo virtual que se va a usar.

--workspace-resource-id

Identificador de recurso de un área de trabajo de Log Analytics para almacenar los datos relacionados con la supervisión.

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 aks addon list

Muestra el estado de todos los complementos de Kubernetes en un clúster determinado.

az aks addon list --name
                  --resource-group

Parámetros requeridos

--name -n

Nombre del clúster administrado.

--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 aks addon list-available

Enumere los complementos de Kubernetes disponibles.

az aks addon list-available
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 aks addon show

Mostrar el estado y la configuración de un complemento de Kubernetes habilitado en un clúster determinado.

az aks addon show --addon
                  --name
                  --resource-group

Ejemplos

Mostrar la configuración del complemento "supervisión".

az aks addon show -g myResourceGroup -n myAKSCluster -a monitoring

Parámetros requeridos

--addon -a

Especifique el complemento de Kubernetes.

--name -n

Nombre del clúster administrado.

--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 aks addon update

Actualice un complemento de Kubernetes ya habilitado.

az aks addon update --addon
                    --name
                    --resource-group
                    [--ampls-resource-id]
                    [--appgw-id]
                    [--appgw-name]
                    [--appgw-subnet-cidr]
                    [--appgw-subnet-id]
                    [--appgw-watch-namespace]
                    [--data-collection-settings]
                    [--dns-zone-resource-ids]
                    [--enable-high-log-scale-mode {false, true}]
                    [--enable-msi-auth-for-monitoring {false, true}]
                    [--enable-secret-rotation]
                    [--enable-sgxquotehelper]
                    [--enable-syslog {false, true}]
                    [--no-wait]
                    [--rotation-poll-interval]
                    [--subnet-name]
                    [--workspace-resource-id]

Ejemplos

Actualice un complemento de Kubernetes. (autogenerated)

az aks addon update --addon virtual-node --name MyManagedCluster --resource-group MyResourceGroup --subnet-name VirtualNodeSubnet

Actualice el complemento ingress-appgw con el prefijo de subred.

az aks addon update --name MyManagedCluster --resource-group MyResourceGroup --addon ingress-appgw --appgw-subnet-cidr 10.2.0.0/16 --appgw-name gateway

Actualice el complemento de supervisión con el identificador de recurso del área de trabajo.

az aks addon update -g $rg -n $cn -a monitoring --workspace-resource-id=/subscriptions/0000000-00000000-00000-000-000/resourcegroups/myresourcegroup/providers/microsoft.operationalinsights/workspaces/defaultlaworkspace

Parámetros requeridos

--addon -a

Especifique el complemento de Kubernetes que se va a actualizar.

--name -n

Nombre del clúster administrado.

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

--ampls-resource-id
Vista previa

Identificador de recurso del ámbito de Private Link de Azure Monitor para el complemento de supervisión.

--appgw-id

Identificador de recurso de una instancia de Application Gateway existente que se va a usar con AGIC. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-name

Nombre de la puerta de enlace de aplicaciones para crear o usar en el grupo de recursos del nodo. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-subnet-cidr

CIDR de subred que se usará para una nueva subred creada para implementar Application Gateway. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-subnet-id

Identificador de recurso de una subred existente que se usa para implementar Application Gateway. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--appgw-watch-namespace

Especifique el espacio de nombres, que debe observar AGIC. Este puede ser un valor de cadena único o una lista de espacios de nombres separada por comas. Use con el complemento de entrada de Azure.

Propiedad Valor
Grupo de parámetros: Application Gateway Arguments
--data-collection-settings
Vista previa

Ruta de acceso al archivo JSON que contiene la configuración de recopilación de datos para el complemento Supervisión.

--dns-zone-resource-ids
Vista previa

Lista separada por comas de identificadores de recursos del recurso de zona DNS que se va a usar con el complemento De enrutamiento de aplicaciones.

--enable-high-log-scale-mode
Vista previa

Habilite el modo de escalado de registros altos para los registros de contenedor.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--enable-msi-auth-for-monitoring
Vista previa

Envíe datos de supervisión a Log Analytics mediante la identidad asignada del clúster (en lugar de la clave compartida del área de trabajo de Log Analytics).

Propiedad Valor
Valores aceptados: false, true
--enable-secret-rotation

Habilite la rotación de secretos. Use con el complemento azure-keyvault-secrets-provider.

Propiedad Valor
Valor predeterminado: False
--enable-sgxquotehelper

Habilite el asistente de comillas SGX para el complemento confcom.

Propiedad Valor
Valor predeterminado: False
--enable-syslog
Vista previa

Habilite la recopilación de datos de syslog para el complemento Supervisión.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--rotation-poll-interval

Establezca el intervalo de sondeo de rotación. Use con el complemento azure-keyvault-secrets-provider.

--subnet-name -s

Nombre de subred del nodo virtual que se va a usar.

--workspace-resource-id

Identificador de recurso de un área de trabajo de Log Analytics para almacenar los datos relacionados con la supervisión.

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