az aksarc
Nota
Esta referencia forma parte de la extensión de aksarc para la CLI de Azure (versión 2.32.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az aksarc. Más información sobre las extensiones.
Administrar clústeres aprovisionados.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az aksarc create |
Crea el clúster aprovisionado. |
Extensión | GA |
az aksarc delete |
Elimina el clúster aprovisionado. |
Extensión | GA |
az aksarc get-credentials |
Obtenga kubeconfig local del clúster aprovisionado. |
Extensión | GA |
az aksarc get-logs |
Recopile registros de clústeres aprovisionados y de la infraestructura subyacente. |
Extensión | GA |
az aksarc get-upgrades |
Obtenga las versiones de actualización disponibles para el clúster aprovisionado. |
Extensión | GA |
az aksarc get-versions |
Enumere las versiones de Kubernetes admitidas en la ubicación personalizada especificada. |
Extensión | GA |
az aksarc list |
Enumera los clústeres aprovisionados en un grupo de recursos o en una suscripción. |
Extensión | GA |
az aksarc logs |
Obsolescente. Use "az aksarc get-logs" en su lugar. |
Extensión | GA |
az aksarc logs hci |
Recopile registros de clústeres aprovisionados y de la infraestructura subyacente. |
Extensión | Obsolescente |
az aksarc nodepool |
Administrar grupos de nodos en un clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool add |
Agrega un grupo de nodos en el clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool delete |
Elimina el grupo de nodos en el clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool list |
Enumera todos los grupos de nodos del clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool scale |
Escala el grupo de nodos en el clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool show |
Obtiene el grupo de nodos en el clúster aprovisionado. |
Extensión | GA |
az aksarc nodepool update |
Actualice un grupo de nodos en el clúster aprovisionado. |
Extensión | GA |
az aksarc notice |
Muestra el archivo NOTICE al archivo filepath especificado por el usuario. |
Extensión | GA |
az aksarc release |
Administrar imágenes de VHD para clústeres aprovisionados. |
Extensión | Vista previa |
az aksarc release download |
Descarga las imágenes de disco duro virtual de una versión. |
Extensión | Vista previa |
az aksarc release save |
Aprovisiona las imágenes de disco duro virtual descargadas en el puente de recursos de arco. |
Extensión | Vista previa |
az aksarc show |
Obtiene el clúster aprovisionado. |
Extensión | GA |
az aksarc update |
Actualiza el clúster aprovisionado. |
Extensión | GA |
az aksarc upgrade |
Actualiza el clúster aprovisionado. |
Extensión | GA |
az aksarc vmsize |
Administre las SKU de máquina virtual para los clústeres aprovisionados. |
Extensión | GA |
az aksarc vmsize list |
Enumera los tamaños de máquina virtual admitidos en la ubicación personalizada especificada. |
Extensión | GA |
az aksarc vnet |
Administrar redes virtuales para clústeres aprovisionados. |
Extensión | GA |
az aksarc vnet create |
Crea la red virtual. |
Extensión | GA |
az aksarc vnet delete |
Elimina la red virtual. |
Extensión | GA |
az aksarc vnet list |
Enumera las redes virtuales por grupo de recursos o suscripción. |
Extensión | GA |
az aksarc vnet show |
Obtiene la red virtual. |
Extensión | GA |
az aksarc create
Crea el clúster aprovisionado.
az aksarc create --custom-location
--name
--resource-group
--vnet-id
[--aad-admin-group-object-ids]
[--ca-profile]
[--control-plane-count]
[--control-plane-ip]
[--control-plane-vm-size]
[--disable-nfs-driver]
[--disable-smb-driver]
[--enable-ahub]
[--enable-ai-toolchain-operator]
[--enable-azure-rbac]
[--enable-cluster-autoscaler]
[--enable-oidc-issuer]
[--enable-wi]
[--gateway-id]
[--generate-ssh-keys]
[--kubernetes-version]
[--load-balancer-count]
[--location]
[--max-count]
[--max-pods]
[--min-count]
[--no-wait]
[--node-count]
[--node-vm-size]
[--nodepool-labels]
[--nodepool-taints]
[--pod-cidr]
[--ssh-auth-ips]
[--ssh-key-value]
[--tags]
[--validate]
Ejemplos
PutProvisionedCluster
az aksarc create --resource-group sample-rg --custom-location sample-cl --name sample-aksarccluster --vnet-ids "vnet-arm-id"
Parámetros requeridos
Nombre o identificador de la ubicación personalizada que se va a usar para el clúster aprovisionado.
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Identificador de recurso de ARM de la red virtual aksarc o la red lógica local de Azure.
Parámetros opcionales
Lista separada por comas de identificadores de objeto de grupo de aad que se establecerán como administrador de clústeres en el clúster aprovisionado.
Lista separada por espacios de pares clave=valor para configurar el escalador automático del clúster. Pase una cadena vacía para borrar el perfil.
Número de nodos del plano de control.
Kubernetes APIServer IPAddress. La dirección IPAddress debe ser enrutable desde azure Resource Bridge Appliance VM.It debe formar parte de la subred de red a la que se hace referencia. La creación del clúster puede producir un error o un tiempo de espera si se pasa una dirección IP no enrutable.
Tamaño de máquina virtual del plano de control.
Deshabilite el controlador NFS para el clúster aprovisionado.
Deshabilite el controlador SMB para el clúster aprovisionado.
Habilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.
Habilite el operador de cadena de herramientas de AI para el clúster aprovisionado.
Habilite RBAC de Azure para controlar las comprobaciones de autorización en el clúster.
Habilite el escalador automático del clúster para el clúster aprovisionado.
Habilite el emisor de OIDC.
Habilite el complemento de identidad de carga de trabajo.
Id. de arm de puerta de enlace del clúster aprovisionado.
Genere ssh key-pair si no está presente.
Versión de Kubernetes del clúster aprovisionado.
Número de nodos del equilibrador de carga.
Ubicación. Valores de: az account list-locations
. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>
.
Número máximo de nodos para el escalado automático.
Número máximo de pods que se pueden ejecutar en un nodo.
Número mínimo de nodos para el escalado automático.
No espere a que finalice la operación de ejecución prolongada.
Número de nodos que se van a crear en el grupo de nodos.
Tamaño de máquina virtual de los nodos del grupo de nodos.
Etiquetas separadas por espacios: key[=value] [key[=value] ...].
Lista separada por comas de taints de nodepool.
Intervalos IP de notación CIDR desde los que se van a asignar direcciones IP de pod.
Lista separada por comas de direcciones IP o CIDR que pueden conectarse mediante ssh a la máquina virtual del clúster.
Ruta de acceso a la clave pública ssh que se insertará en el plano de control.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Valide los parámetros de entrada del clúster sin crear realmente el clúster.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc delete
Elimina el clúster aprovisionado.
az aksarc delete --name
--resource-group
[--no-wait]
[--yes]
Ejemplos
DeleteProvisionedCluster
az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
No espere a que finalice la operación de ejecución prolongada.
No solicite confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc get-credentials
Obtenga kubeconfig local del clúster aprovisionado.
az aksarc get-credentials --name
--resource-group
[--admin]
[--context]
[--file]
[--overwrite-existing]
Ejemplos
GetAdminCredential
az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin
GetAADUserCredential
az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Obtenga las credenciales de administrador del clúster.
Si se especifica, sobrescriba el nombre de contexto predeterminado.
Archivo de configuración de Kubernetes que se va a actualizar. Si no se proporciona, actualiza el archivo '~/.kube/config'.
Sobrescriba cualquier entrada de clúster existente con el mismo nombre.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc get-logs
Recopile registros de clústeres aprovisionados y de la infraestructura subyacente.
az aksarc get-logs [--credentials-dir]
[--ip]
[--kubeconfig]
[--out-dir]
Ejemplos
Recopilación de registros con la dirección IP y las credenciales ssh
az aksarc get-logs --ip 192.168.200.31 192.168.200.32 --ssh-key ~/.ssh --out-dir ./logs
Recopilación de registros con credenciales kubeconfig y SSH, kubeconfig solo se usa para recopilar direcciones IP y se usa la ruta de acceso del archivo ssh-key en lugar del directorio.
az aksarc get-logs --kubeconfig ~/.kube/config --ssh-key ~/.ssh/id_rsa --out-dir ./logs
Parámetros opcionales
Se acepta la ruta de acceso a las credenciales SSH para conectarse a los nodos, ya sea id_rsa archivo o directorio.
Direcciones IP de nodos (nodos de plano de control o nodos de trabajo) desde las que se deben recopilar los registros.
Ruta de acceso al archivo kubeconfig para conectarse al clúster.
Directorio de salida para almacenar los registros recopilados. Si no se especifica, los registros se almacenarán en el directorio actual.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc get-upgrades
Obtenga las versiones de actualización disponibles para el clúster aprovisionado.
az aksarc get-upgrades --name
--resource-group
Ejemplos
Obtención de las versiones de actualización disponibles para el clúster aprovisionado de AKS híbrido
az aksarc get-upgrades --name "samplecluster" --resource-group "sample-rg"
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc get-versions
Enumere las versiones de Kubernetes admitidas en la ubicación personalizada especificada.
az aksarc get-versions --custom-location
[--resource-group]
Ejemplos
VMListSkus
az aksarc get-versions -g sample-rg --custom-location sample-cl
Parámetros requeridos
Nombre de la ubicación personalizada que se va a usar para mostrar las versiones k8s admitidas.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc list
Enumera los clústeres aprovisionados en un grupo de recursos o en una suscripción.
az aksarc list [--resource-group]
Ejemplos
ListProvisionedClusterByResourceGroup
az aksarc list --resource-group "sample-rg"
ListProvisionedClusterBySubscription
az aksarc list
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc notice
Muestra el archivo NOTICE al archivo filepath especificado por el usuario.
az aksarc notice --output-filepath
Ejemplos
GetNoticeFile
az aksarc notice --output-filepath "./Notice"
Parámetros requeridos
Ruta de acceso de archivo de salida para el archivo NOTICE.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc show
Obtiene el clúster aprovisionado.
az aksarc show --name
--resource-group
Ejemplos
GetProvisionedCluster
az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc update
Actualiza el clúster aprovisionado.
az aksarc update --name
--resource-group
[--aad-admin-group-object-ids]
[--ca-profile]
[--control-plane-count]
[--disable-ahub]
[--disable-ai-toolchain-operator]
[--disable-cluster-autoscaler]
[--disable-gateway]
[--disable-nfs-driver]
[--disable-smb-driver]
[--enable-ahub]
[--enable-ai-toolchain-operator]
[--enable-cluster-autoscaler]
[--enable-nfs-driver]
[--enable-smb-driver]
[--gateway-id]
[--max-count]
[--min-count]
[--tags]
[--update-cluster-autoscaler]
Ejemplos
UpdateProvisionedCluster
az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"
Habilite la característica Ventajas del usuario híbrido de Azure para un clúster aprovisionado.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub
Deshabilite la característica Ventajas del usuario híbrido de Azure para un clúster aprovisionado.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub
Escalar verticalmente los nodos del plano de control.
az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Lista separada por comas de identificadores de objeto de grupo de aad que se establecerán como administrador de clústeres en el clúster aprovisionado.
Lista separada por espacios de pares clave=valor para configurar el escalador automático del clúster. Pase una cadena vacía para borrar el perfil.
Número de nodos a los que se va a escalar el plano de control.
Deshabilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.
Deshabilite el operador ai Toolchain para el clúster aprovisionado.
Deshabilite el escalador automático del clúster para el clúster aprovisionado.
Deshabilite la puerta de enlace para el clúster aprovisionado.
Deshabilite el controlador NFS para el clúster aprovisionado.
Deshabilite el controlador SMB para el clúster aprovisionado.
Habilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.
Habilite el operador de cadena de herramientas de AI para el clúster aprovisionado.
Habilite el escalador automático del clúster para el clúster aprovisionado.
Habilite el controlador NFS para el clúster aprovisionado.
Habilite el controlador SMB para el clúster aprovisionado.
Id. de arm de puerta de enlace del clúster aprovisionado.
Número máximo de nodos para el escalado automático.
Número mínimo de nodos para el escalado automático.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Actualice el escalador automático del clúster para el clúster aprovisionado.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az aksarc upgrade
Actualiza el clúster aprovisionado.
az aksarc upgrade --name
--resource-group
[--kubernetes-version]
[--no-wait]
[--yes]
Ejemplos
UpgradeProvisionedCluster
az aksarc upgrade --name "sample-aksarccluster" --resource-group "sample-rg" --kubernetes-version "1.22.2"
Parámetros requeridos
Nombre del clúster aprovisionado.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Versión de Kubernetes del clúster aprovisionado.
No espere a que finalice la operación de ejecución prolongada.
Marca para deshabilitar las solicitudes de confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.