Compartir a través de


az networkcloud kubernetescluster agentpool

Nota:

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

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administre el grupo de agentes del clúster de Kubernetes.

Comandos

Nombre Description Tipo Estado
az networkcloud kubernetescluster agentpool create

Cree un nuevo grupo de agentes de clúster de Kubernetes o actualice las propiedades de la existente.

Extensión Vista previa
az networkcloud kubernetescluster agentpool delete

Elimine el grupo de agentes de clúster de Kubernetes proporcionado.

Extensión Vista previa
az networkcloud kubernetescluster agentpool list

Enumera los grupos de agentes para el clúster de Kubernetes proporcionado.

Extensión Vista previa
az networkcloud kubernetescluster agentpool show

Obtenga las propiedades del grupo de agentes de clúster de Kubernetes proporcionado.

Extensión Vista previa
az networkcloud kubernetescluster agentpool update

Actualice las propiedades del grupo de agentes de clúster de Kubernetes proporcionado o actualice las etiquetas asociadas al grupo de agentes de clúster de Kubernetes. Las propiedades y las actualizaciones de etiquetas se pueden realizar de forma independiente.

Extensión Vista previa
az networkcloud kubernetescluster agentpool wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Extensión Vista previa

az networkcloud kubernetescluster agentpool create

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un nuevo grupo de agentes de clúster de Kubernetes o actualice las propiedades de la existente.

az networkcloud kubernetescluster agentpool create --agent-pool-name
                                                   --count
                                                   --kubernetes-cluster-name
                                                   --mode {NotApplicable, System, User}
                                                   --resource-group
                                                   --vm-sku-name
                                                   [--admin-username]
                                                   [--agent-options]
                                                   [--attached-network-configuration]
                                                   [--availability-zones]
                                                   [--extended-location]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--labels]
                                                   [--location]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--tags]
                                                   [--taints]
                                                   [--upgrade-settings]

Ejemplos

Creación o actualización del grupo de agentes del clúster de Kubernetes

az networkcloud kubernetescluster agentpool create --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --admin-username "azureuser" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm' --count 3 --mode "System" --vm-sku-name "NC-XXXXX" --agent-options hugepages-count=96 hugepages-size="1G" --attached-network-configuration l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName,pluginType:'SRIOV',ipamEnabled:'False'}]" trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" --labels="[{key:'kubernetes.label',value:'true'}]" --taints="[{key:'kubernetes.taint',value:'true'}]" --upgrade-settings max-surge="1" --availability-zones="['zone1','zone2']"

Parámetros requeridos

--agent-pool-name --name -n

Nombre del grupo de agentes de clúster de Kubernetes.

--count

Número de máquinas virtuales que usan esta configuración.

--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--mode

La selección de cómo se utiliza este grupo de agentes, ya sea como un grupo de sistemas o un grupo de usuarios. Los grupos de sistemas ejecutan las características y los servicios críticos para el clúster de Kubernetes, mientras que los grupos de usuarios están dedicados a las cargas de trabajo de usuario. Cada clúster de Kubernetes debe contener al menos un grupo de nodos del sistema con al menos un nodo.

valores aceptados: NotApplicable, System, User
--resource-group -g

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

--vm-sku-name

Nombre de la SKU de máquina virtual que determina el tamaño de los recursos asignados para las máquinas virtuales de nodo.

Parámetros opcionales

--admin-username

Nombre de usuario del administrador que se aplicará a los sistemas operativos que ejecutan nodos de Kubernetes. Si no se proporciona, el servicio elegirá un nombre de usuario.

--agent-options

Las configuraciones que se aplicarán a cada agente de este grupo de agentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--attached-network-configuration

La configuración de redes que se adjuntan al grupo de agentes para su uso por las cargas de trabajo que se ejecutan en este clúster de Kubernetes. Estas redes se agregan a las redes conectadas en la configuración de red conectada al clúster de Kubernetes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--availability-zones

Lista de zonas de disponibilidad del clúster de nube de red que se usa para el aprovisionamiento de nodos en este grupo de agentes. Si no se especifica, se usarán todas las zonas de disponibilidad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--extended-location

Ubicación extendida del clúster asociado al recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--generate-ssh-keys

Generar archivos de clave pública y privada SSH si faltan. Las claves se almacenarán en "~/.ssh".

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--labels

Etiquetas aplicadas a los nodos de este grupo de agentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--location -l

Ubicación geográfica donde reside el recurso Cuando no se especifica, se usará la ubicación del grupo de recursos.

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ssh-dest-key-path

Lista de rutas de acceso separadas por espacios para las claves públicas ssh. Se puede proporcionar una ruta de acceso de archivo o un directorio. Si se proporciona un directorio, intentará cargar todas las claves públicas (.pub) encontradas. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--ssh-key-values

Lista de claves públicas SSH separadas por espacios. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--taints

Los valores taint aplicados a los nodos de este grupo de agentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--upgrade-settings

Configuración del grupo de agentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 networkcloud kubernetescluster agentpool delete

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine el grupo de agentes de clúster de Kubernetes proporcionado.

az networkcloud kubernetescluster agentpool delete [--agent-pool-name]
                                                   [--ids]
                                                   [--kubernetes-cluster-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--yes]

Ejemplos

Eliminación del grupo de agentes del clúster de Kubernetes

az networkcloud kubernetescluster agentpool delete --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parámetros opcionales

--agent-pool-name --name -n

Nombre del grupo de agentes de clúster de Kubernetes.

--ids

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

--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--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 networkcloud kubernetescluster agentpool list

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumera los grupos de agentes para el clúster de Kubernetes proporcionado.

az networkcloud kubernetescluster agentpool list --kubernetes-cluster-name
                                                 --resource-group
                                                 [--max-items]
                                                 [--next-token]

Ejemplos

Enumeración de grupos de agentes del clúster de Kubernetes

az networkcloud kubernetescluster agentpool list --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parámetros requeridos

--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--resource-group -g

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

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

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 networkcloud kubernetescluster agentpool show

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga las propiedades del grupo de agentes de clúster de Kubernetes proporcionado.

az networkcloud kubernetescluster agentpool show [--agent-pool-name]
                                                 [--ids]
                                                 [--kubernetes-cluster-name]
                                                 [--resource-group]
                                                 [--subscription]

Ejemplos

Obtención del grupo de agentes del clúster de Kubernetes

az networkcloud kubernetescluster agentpool show --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parámetros opcionales

--agent-pool-name --name -n

Nombre del grupo de agentes de clúster de Kubernetes.

--ids

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

--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--resource-group -g

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

--subscription

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

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 networkcloud kubernetescluster agentpool update

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice las propiedades del grupo de agentes de clúster de Kubernetes proporcionado o actualice las etiquetas asociadas al grupo de agentes de clúster de Kubernetes. Las propiedades y las actualizaciones de etiquetas se pueden realizar de forma independiente.

az networkcloud kubernetescluster agentpool update [--agent-pool-name]
                                                   [--count]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ids]
                                                   [--kubernetes-cluster-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--subscription]
                                                   [--tags]
                                                   [--upgrade-settings]

Ejemplos

Grupo de agentes de revisión del clúster de Kubernetes

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --count 3 --upgrade-settings max-surge="1"

Actualizar las credenciales de administrador del grupo de agentes

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'

Parámetros opcionales

--agent-pool-name --name -n

Nombre del grupo de agentes de clúster de Kubernetes.

--count

Número de máquinas virtuales que usan esta configuración.

--generate-ssh-keys

Generar archivos de clave pública y privada SSH si faltan. Las claves se almacenarán en "~/.ssh".

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

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

--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--ssh-dest-key-path

Lista de rutas de acceso separadas por espacios para las claves públicas ssh. Se puede proporcionar una ruta de acceso de archivo o un directorio. Si se proporciona un directorio, intentará cargar todas las claves públicas (.pub) encontradas. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--ssh-key-values

Lista de claves públicas SSH separadas por espacios. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--subscription

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

--tags

Etiquetas de recursos de Azure que reemplazarán las existentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--upgrade-settings

Configuración del grupo de agentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 networkcloud kubernetescluster agentpool wait

Vista previa

El grupo de comandos "az networkcloud" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az networkcloud kubernetescluster agentpool wait [--agent-pool-name]
                                                 [--created]
                                                 [--custom]
                                                 [--deleted]
                                                 [--exists]
                                                 [--ids]
                                                 [--interval]
                                                 [--kubernetes-cluster-name]
                                                 [--resource-group]
                                                 [--subscription]
                                                 [--timeout]
                                                 [--updated]

Parámetros opcionales

--agent-pool-name --name -n

Nombre del grupo de agentes de clúster de Kubernetes.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--ids

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

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--kubernetes-cluster-name

Nombre del clúster de Kubernetes.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

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.