Compartir a través de

az aks loadbalancer

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

Comandos para administrar las configuraciones del equilibrador de carga en un clúster de Kubernetes administrado.

Estos comandos habilitan la característica de varios equilibradores de carga estándar para clústeres de Azure Kubernetes Service.

Comandos

Nombre Description Tipo Estado
az aks loadbalancer add

Agregue una configuración del equilibrador de carga a un clúster de Kubernetes administrado.

 Extension GA
az aks loadbalancer delete

Elimine una configuración del equilibrador de carga de un clúster de Kubernetes administrado.

 Extension GA
az aks loadbalancer list

Enumere todas las configuraciones del equilibrador de carga en un clúster de Kubernetes administrado.

 Extension GA
az aks loadbalancer rebalance-nodes

Reequilibrar nodos entre equilibradores de carga específicos.

 Extension GA
az aks loadbalancer show

Mostrar detalles de una configuración específica del equilibrador de carga en un clúster de Kubernetes administrado.

 Extension GA
az aks loadbalancer update

Actualice una configuración del equilibrador de carga en un clúster de Kubernetes administrado.

 Extension GA

az aks loadbalancer add

Agregue una configuración del equilibrador de carga a un clúster de Kubernetes administrado.

az aks loadbalancer add --cluster-name
                        --name
                        --primary-agent-pool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--allow-service-placement {false, true}]
                        [--node-selector]
                        [--service-label-selector]
                        [--service-namespace-selector]

Ejemplos

Adición de una configuración del equilibrador de carga con un grupo de agentes principal específico

az aks loadbalancer add -g MyResourceGroup -n secondary --cluster-name MyManagedCluster --primary-agent-pool-name nodepool1

Adición de una configuración del equilibrador de carga con el selector de etiquetas de servicio

az aks loadbalancer add -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool2 --service-label-selector app=frontend

Adición de una configuración del equilibrador de carga que no coloca automáticamente los servicios

az aks loadbalancer add -g MyResourceGroup -n restricted-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool3 --allow-service-placement false

Adición de una configuración del equilibrador de carga con encabezados de API de AKS personalizados

az aks loadbalancer add -g MyResourceGroup -n api-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool1 --aks-custom-headers CustomHeader=Value

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--name -n

Nombre de la configuración del equilibrador de carga.

Nombre del equilibrador de carga usado para la identificación. Debe haber una configuración denominada "kubernetes" en el clúster.

--primary-agent-pool-name -p

Nombre del grupo de agentes principal para este equilibrador de carga.

Campo obligatorio. Valor de cadena que debe especificar el identificador de un grupo de agentes existente. Todos los nodos del grupo especificado siempre se agregarán a este equilibrador de carga.

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

--aks-custom-headers

Envíe encabezados personalizados a la API de AKS.

Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allow-service-placement -a

Si se deben colocar automáticamente los servicios en el equilibrador de carga.

Si no se proporciona, el valor predeterminado es true. Si se establece en false manualmente, el equilibrador de carga externo e interno no se seleccionará para los servicios a menos que se dirijan explícitamente a él.

Propiedad Valor
Valores aceptados: false, true
--node-selector -d

Selector de etiquetas de nodo para nodos que pueden ser miembros de este equilibrador de carga.

Los nodos que coinciden con este selector serán posibles miembros de este equilibrador de carga. Formatear como pares clave=valor separados por comas.

--service-label-selector -l

Selector de etiquetas para los servicios que se pueden colocar en este equilibrador de carga.

Solo los servicios que coinciden con este selector se pueden colocar en este equilibrador de carga. Dar formato como pares clave=valor separados por comas o expresiones como "key In value1,value2".

--service-namespace-selector -s

Selector de etiquetas de espacio de nombres para servicios que se pueden colocar en este equilibrador de carga.

Los servicios creados en espacios de nombres que coinciden con el selector se pueden colocar en este equilibrador de carga. Formatear como pares clave=valor separados por comas.

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

Elimine una configuración del equilibrador de carga de un clúster de Kubernetes administrado.

az aks loadbalancer delete --cluster-name
                           --name
                           --resource-group

Ejemplos

Eliminación de una configuración del equilibrador de carga

az aks loadbalancer delete -g MyResourceGroup -n secondary --cluster-name MyManagedCluster

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--name -n

Nombre de la configuración del equilibrador de carga que se va a eliminar.

El equilibrador de carga "kubernetes" no se puede eliminar, ya que es necesario para la operación del clúster.

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

Enumere todas las configuraciones del equilibrador de carga en un clúster de Kubernetes administrado.

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

Ejemplos

Enumerar todas las configuraciones del equilibrador de carga

az aks loadbalancer list -g MyResourceGroup --cluster-name MyManagedCluster

Enumerar todas las configuraciones del equilibrador de carga en formato de tabla

az aks loadbalancer list -g MyResourceGroup --cluster-name MyManagedCluster -o table

Parámetros requeridos

--cluster-name

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 loadbalancer rebalance-nodes

Reequilibrar nodos entre equilibradores de carga específicos.

az aks loadbalancer rebalance-nodes --name
                                    --resource-group
                                    [--lb-names --load-balancer-names]

Parámetros requeridos

--name -n

Nombre del clúster administrado.

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

--lb-names --load-balancer-names

Lista separada por espacios de nombres de equilibrador de carga para reequilibrar. Si no se especifica, se reequilibran todos los equilibradores de carga.

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

Mostrar detalles de una configuración específica del equilibrador de carga en un clúster de Kubernetes administrado.

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

Ejemplos

Mostrar detalles de una configuración específica del equilibrador de carga

az aks loadbalancer show -g MyResourceGroup -n secondary --cluster-name MyManagedCluster

Mostrar detalles de una configuración del equilibrador de carga en formato de tabla

az aks loadbalancer show -g MyResourceGroup -n kubernetes --cluster-name MyManagedCluster -o table

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--name -n

Nombre de la configuración del equilibrador de carga que se va a mostrar.

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

Actualice una configuración del equilibrador de carga en un clúster de Kubernetes administrado.

az aks loadbalancer update --cluster-name
                           --name
                           --resource-group
                           [--aks-custom-headers]
                           [--allow-service-placement {false, true}]
                           [--node-selector]
                           [--primary-agent-pool-name]
                           [--service-label-selector]
                           [--service-namespace-selector]

Ejemplos

Actualización del grupo de agentes principal de una configuración del equilibrador de carga

az aks loadbalancer update -g MyResourceGroup -n secondary --cluster-name MyManagedCluster --primary-agent-pool-name nodepool2

Actualización de una configuración del equilibrador de carga para deshabilitar la selección automática de ubicación del servicio

az aks loadbalancer update -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --allow-service-placement false

Actualización de una configuración del equilibrador de carga con el nuevo selector de servicio

az aks loadbalancer update -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --service-label-selector tier=frontend,environment=production

Actualización de una configuración del equilibrador de carga con encabezados de API de AKS personalizados

az aks loadbalancer update -g MyResourceGroup -n api-lb --cluster-name MyManagedCluster --aks-custom-headers CustomHeader=Value

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--name -n

Nombre de la configuración del equilibrador de carga que se va a actualizar.

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

--aks-custom-headers

Envíe encabezados personalizados a la API de AKS.

Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allow-service-placement -a

Si se deben colocar automáticamente los servicios en el equilibrador de carga.

Si se establece en false, el equilibrador de carga externo e interno no se seleccionará para los servicios a menos que se dirijan explícitamente a él.

Propiedad Valor
Valores aceptados: false, true
--node-selector -d

Selector de etiquetas de nodo para nodos que pueden ser miembros de este equilibrador de carga.

Los nodos que coinciden con este selector serán posibles miembros de este equilibrador de carga. Formatear como pares clave=valor separados por comas.

--primary-agent-pool-name -p

Nombre del grupo de agentes principal para este equilibrador de carga.

Valor de cadena que debe especificar el identificador de un grupo de agentes existente. Todos los nodos del grupo especificado siempre se agregarán a este equilibrador de carga.

--service-label-selector -l

Selector de etiquetas para los servicios que se pueden colocar en este equilibrador de carga.

Solo los servicios que coinciden con este selector se pueden colocar en este equilibrador de carga. Dar formato como pares clave=valor separados por comas o expresiones como "key In value1,value2".

--service-namespace-selector -s

Selector de etiquetas de espacio de nombres para servicios que se pueden colocar en este equilibrador de carga.

Los servicios creados en espacios de nombres que coinciden con el selector se pueden colocar en este equilibrador de carga. Formatear como pares clave=valor separados por comas.

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