Compartir a través de

az aks extension

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 extension . Obtenga más información sobre las extensiones.

Comandos para administrar extensiones en el clúster de Kubernetes.

Comandos

Nombre Description Tipo Estado
az aks extension create

Crea la instancia de extensión de clúster en el clúster administrado. Consulte el ejemplo al final para ver cómo crear una extensión de clúster.

 Extension GA
az aks extension delete

Elimine una extensión de clúster.

 Extension GA
az aks extension list

Enumerar extensiones de clúster.

 Extension GA
az aks extension show

Mostrar una extensión de clúster.

 Extension GA
az aks extension type

Administración de tipos de extensión en Azure Kubernetes Service.

 Extension GA
az aks extension type list

Enumera los tipos de extensión de clúster disponibles. Las propiedades usadas para el filtrado incluyen la versión de Kubernetes, la ubicación del clúster.

 Extension GA
az aks extension type show

Mostrar propiedades para un tipo de extensión de clúster. Las propiedades usadas para el filtrado incluyen la versión de Kubernetes, la ubicación del clúster.

 Extension GA
az aks extension type version

Administre la versión de los tipos de extensión en Azure Kubernetes Service.

 Extension GA
az aks extension type version list

Enumera las versiones disponibles del tipo de extensión de clúster. Las propiedades usadas para el filtrado incluyen la versión de Kubernetes, la ubicación del clúster.

 Extension GA
az aks extension type version show

Mostrar las propiedades asociadas a una versión de tipo de extensión de clúster. Las propiedades usadas para el filtrado incluyen la versión de Kubernetes, la ubicación del clúster.

 Extension GA
az aks extension update

Actualice las propiedades mutables de una extensión de clúster.

 Extension GA

az aks extension create

Crea la instancia de extensión de clúster en el clúster administrado. Consulte el ejemplo al final para ver cómo crear una extensión de clúster.

Cree una extensión de clúster. La salida incluye secretos que debe proteger. Asegúrese de que no incluya estos secretos en el control de código fuente. Compruebe también que no haya secretos presentes en los registros del comando o script. Para obtener más información, vea http://aka.ms/clisecrets.

az aks extension create --cluster-name
                        --extension-type
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--release-namespace]
                        [--scope {cluster, namespace}]
                        [--target-namespace]

Ejemplos

Instalación de la extensión de clúster en el clúster de AKS con parámetros necesarios

az aks extension create --resource-group my-resource-group --cluster-name mycluster --name myextension --extension-type microsoft.flux

Instalación de la extensión de clúster con opciones de configuración de parámetros opcionales

az aks extension create --resource-group abc --cluster-name test --name flux --extension-type microsoft.flux --config useKubeletIdentity=true

Parámetros requeridos

--cluster-name -c

Nombre del clúster de AKS.

--extension-type -t

Nombre del tipo de extensión.

--name -n

Nombre de la instancia de extensión.

--resource-group -g

Nombre del grupo de recursos.

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.

--config --configuration-settings

Opciones de configuración como par clave=valor.

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. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-file --config-settings-file

Ruta de acceso del archivo JSON para las opciones de configuración.

Ruta de acceso del archivo JSON para las opciones de configuración. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-protected --config-protected-settings

Valores protegidos de configuración como par clave=valor.

Opciones 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. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-protected-file --config-protected-settings-file

Ruta de acceso del archivo JSON para la configuración protegida por la configuración.

Ruta de acceso del archivo JSON para la configuración protegida por la configuración. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--release-namespace

Especifique el espacio de nombres para instalar la versión de extensión.

--scope

Especifique el ámbito del tipo de extensión, toma el espacio de nombres o el clúster como ámbito.

Especifique el ámbito del tipo de extensión, toma el espacio de nombres o el clúster como ámbito Si no se especifica, se usará el ámbito predeterminado establecido en el registro de tipo de extensión.

Propiedad Valor
Valores aceptados: cluster, namespace
--target-namespace

Especifique el espacio de nombres de destino en el que se va a instalar para la instancia de extensión. Este parámetro es necesario si el ámbito de extensión está establecido en "espacio de nombres".

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

Elimine una extensión de clúster.

az aks extension delete --cluster-name
                        --name
                        --resource-group
                        [--force]
                        [--no-wait]
                        [--yes]

Ejemplos

Eliminación de una extensión de clúster existente en el clúster de AKS

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext

Eliminación de una extensión de clúster existente en el clúster de AKS con parámetros opcionales

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext --yes --force

Parámetros requeridos

--cluster-name -c

Nombre del clúster de AKS.

--name -n

Nombre de la instancia de extensión.

--resource-group -g

Nombre del grupo de recursos.

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

Especifique si se va a forzar la eliminación de la extensión del clúster.

Especifique si se va a forzar la eliminación de la extensión del clúster Si no se especifica, el valor predeterminado es false.

Propiedad Valor
Valor predeterminado: False
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--yes -y

Omite la solicitud de confirmación.

Omite la solicitud de confirmación. Si no se especifica, el valor predeterminado es false.

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

Enumerar extensiones de clúster.

Enumere todas las extensiones de clúster de un clúster, incluidas sus propiedades. La salida incluye secretos que debe proteger. Asegúrese de que no incluya estos secretos en el control de código fuente. Compruebe también que no haya secretos presentes en los registros del comando o script. Para obtener más información, vea http://aka.ms/clisecrets.

az aks extension list --cluster-name
                      --resource-group

Ejemplos

Enumerar todas las extensiones de clúster en un clúster

az aks extension list --resource-group <group> --cluster-name <name>

Parámetros requeridos

--cluster-name -c

Nombre del clúster de AKS.

--resource-group -g

Nombre del grupo de recursos.

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

Mostrar una extensión de clúster.

Mostrar una extensión de clúster, incluidas sus propiedades. La salida incluye secretos que debe proteger. Asegúrese de que no incluya estos secretos en el control de código fuente. Compruebe también que no haya secretos presentes en los registros del comando o script. Para obtener más información, vea http://aka.ms/clisecrets.

az aks extension show --cluster-name
                      --name
                      --resource-group

Ejemplos

Mostrar detalles de una extensión de clúster

az aks extension show --resource-group my-resource-group --cluster-name mycluster --name myextension

Parámetros requeridos

--cluster-name -c

Nombre del clúster de AKS.

--name -n

Nombre de la instancia de extensión.

--resource-group -g

Nombre del grupo de recursos.

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

Actualice las propiedades mutables de una extensión de clúster.

Para actualizar configSettings y ConfigProtectedSettings, consulte la documentación del servicio de extensión de clúster para comprobar que se admite la actualización de estas propiedades antes de actualizar estas propiedades. La salida incluye secretos que debe proteger. Asegúrese de que no incluya estos secretos en el control de código fuente. Compruebe también que no haya secretos presentes en los registros del comando o script. Para obtener más información, vea http://aka.ms/clisecrets.

az aks extension update --cluster-name
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--yes]

Ejemplos

Actualización de la extensión de clúster en el clúster de AKS

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension

Actualización de la extensión de clúster en el clúster de AKS con parámetros opcionales incluidos

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

Parámetros requeridos

--cluster-name -c

Nombre del clúster de AKS.

--name -n

Nombre de la instancia de extensión.

--resource-group -g

Nombre del grupo de recursos.

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.

--config --configuration-settings

Opciones de configuración como par clave=valor.

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. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-file --config-settings-file

Ruta de acceso del archivo JSON para las opciones de configuración.

Ruta de acceso del archivo JSON para las opciones de configuración. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-protected --config-protected-settings

Valores protegidos de configuración como par clave=valor.

Opciones 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. Si no se especifica, el valor predeterminado es Non.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--config-protected-file --config-protected-settings-file

Ruta de acceso del archivo JSON para la configuración protegida por la configuración.

Ruta de acceso del archivo JSON para la configuración protegida por la configuración. Si no se especifica, el valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--yes -y

Omite la solicitud de confirmación.

Omite la solicitud de confirmación. Si no se especifica, el valor predeterminado es false.

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