Compartir a través de

az aksarc

  • Referencia

Nota:

Esta referencia forma parte de la extensión 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 . Obtenga 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-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

Recopilar registros de clústeres aprovisionados.

 Extensión GA
az aksarc logs hci

Recopile registros de clústeres aprovisionados en el entorno de HCI.

 Extensión GA
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

Novedades 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-azure-rbac]
                 [--enable-cluster-autoscaler]
                 [--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]

Ejemplos

PutProvisionedCluster

az aksarc create -g sample-rg --custom-location sample-cl -n sample-aksarccluster --vnet-ids "vnet-arm-id"

Parámetros requeridos

--custom-location

Nombre o identificador de la ubicación personalizada que se va a usar para el clúster aprovisionado.

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

--vnet-id --vnet-ids

Identificador de recurso de ARM de la red virtual aksarc o la red lógica de Azure Stack HCI.

Parámetros opcionales

--aad-admin-group-object-ids -i

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.

--ca-profile --cluster-autoscaler-profile

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.

--control-plane-count --control-plane-node-count

Número de nodos del plano de control.

--control-plane-ip

\Kubernetes APIServer IPAddress. IpAddress debe ser enrutable desde la máquina virtual del dispositivo de Azure Resource Bridge. Debe formar parte de la subred de red a la que se hace referencia. Excluya de ippools para evitar duplicados. La creación del clúster puede producir un error o un tiempo de espera si se pasa una dirección IP no enrutable.

--control-plane-vm-size

Tamaño de máquina virtual del plano de control.

--disable-nfs-driver

Deshabilite el controlador NFS para el clúster aprovisionado.

valor predeterminado: False
--disable-smb-driver

Deshabilite el controlador SMB para el clúster aprovisionado.

valor predeterminado: False
--enable-ahub

Habilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.

valor predeterminado: False
--enable-azure-rbac

Habilite RBAC de Azure para controlar las comprobaciones de autorización en el clúster.

valor predeterminado: False
--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster para el clúster aprovisionado.

valor predeterminado: False
--generate-ssh-keys

Genere ssh key-pair si no está presente.

valor predeterminado: False
--kubernetes-version -k

Versión de Kubernetes del clúster aprovisionado.

--load-balancer-count

Número de nodos del equilibrador de carga.

--location -l

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

--max-count

Número máximo de nodos para el escalado automático.

--max-pods -m

Número máximo de pods que se pueden ejecutar en un nodo.

--min-count

Número mínimo de nodos para el escalado automático.

--no-wait

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

valor predeterminado: False
--node-count -c

Número de nodos que se van a crear en el grupo de nodos.

valor predeterminado: 1
--node-vm-size

Tamaño de máquina virtual de los nodos del grupo de nodos.

--nodepool-labels

Etiquetas separadas por espacios: key[=value] [key[=value] ...].

--nodepool-taints

Lista separada por comas de taints de nodepool.

--pod-cidr

Intervalos IP de notación CIDR desde los que se van a asignar direcciones IP de pod.

--ssh-auth-ips --ssh-authorized-ip-ranges

Lista separada por comas de direcciones IP o CIDR que pueden conectarse mediante ssh a la máquina virtual del clúster.

--ssh-key-value

Ruta de acceso a la clave pública ssh que se insertará en el plano de control.

valor predeterminado: ~\.ssh\id_rsa.pub
--tags

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros opcionales

--no-wait

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

valor predeterminado: False
--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aksarc get-credentials

Obtenga kubeconfig local del clúster aprovisionado.

az aksarc get-credentials --name
                          --resource-group
                          [--admin]
                          [--context]
                          [--file]
                          [--overwrite-existing]

Ejemplos

Get Administración Credential

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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros opcionales

--admin -a

Obtenga las credenciales de administrador del clúster.

valor predeterminado: False
--context

Si se especifica, sobrescriba el nombre de contexto predeterminado.

--file -f

Archivo de configuración de Kubernetes que se va a actualizar. Si no se proporciona, actualiza el archivo '~/.kube/config'.

valor predeterminado: ~\.kube\config
--overwrite-existing

Sobrescriba cualquier entrada de clúster existente con el mismo nombre.

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--custom-location

Nombre de la ubicación personalizada que se va a usar para mostrar las versiones k8s admitidas.

Parámetros opcionales

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--output-filepath

Ruta de acceso de archivo de salida para el archivo NOTICE.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az aksarc update

Novedades el clúster aprovisionado.

az aksarc update --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--ca-profile]
                 [--control-plane-count]
                 [--disable-ahub]
                 [--disable-cluster-autoscaler]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-cluster-autoscaler]
                 [--enable-nfs-driver]
                 [--enable-smb-driver]
                 [--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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros opcionales

--aad-admin-group-object-ids -i

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.

--ca-profile --cluster-autoscaler-profile

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.

--control-plane-count --control-plane-node-count

Número de nodos a los que se va a escalar el plano de control.

--disable-ahub

Deshabilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.

valor predeterminado: False
--disable-cluster-autoscaler -d

Deshabilite el escalador automático del clúster para el clúster aprovisionado.

valor predeterminado: False
--disable-nfs-driver

Deshabilite el controlador NFS para el clúster aprovisionado.

valor predeterminado: False
--disable-smb-driver

Deshabilite el controlador SMB para el clúster aprovisionado.

valor predeterminado: False
--enable-ahub

Habilite ventajas de usuario híbrido de Azure (AHUB) para el clúster aprovisionado.

valor predeterminado: False
--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster para el clúster aprovisionado.

valor predeterminado: False
--enable-nfs-driver

Habilite el controlador NFS para el clúster aprovisionado.

valor predeterminado: False
--enable-smb-driver

Habilite el controlador SMB para el clúster aprovisionado.

valor predeterminado: False
--max-count

Número máximo de nodos para el escalado automático.

--min-count

Número mínimo de nodos para el escalado automático.

--tags

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

--update-cluster-autoscaler -u

Actualice el escalador automático del clúster para el clúster aprovisionado.

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az 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

--name -n

Nombre del clúster aprovisionado.

--resource-group -g

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

Parámetros opcionales

--kubernetes-version -k

Versión de Kubernetes del clúster aprovisionado.

--no-wait

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

valor predeterminado: False
--yes

Marca para deshabilitar las solicitudes de confirmación.

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.