Implementar el controlador IPAM de NetScaler

Last published : Oct 02, 2026
NetScaler proporciona un controlador IPAM para la gestión de direcciones IP. El controlador IPAM de NetScaler se ejecuta en paralelo al controlador de entrada de NetScaler en el clúster de Kubernetes. El controlador IPAM de NetScaler asigna direcciones IP a los servicios de tipo LoadBalancer y a los recursos de entrada desde un rango de direcciones IP especificado.
El controlador IPAM de NetScaler requiere la definición de recurso personalizado (CRD) VIP de NetScaler. La CRD VIP se utiliza para la comunicación interna entre el controlador de entrada de NetScaler y el controlador IPAM de NetScaler.
Related information
Soluciones de implementación

Requisitos previos

  • Un clúster de Kubernetes y una herramienta de línea de comandos kubectl para comunicarse con el clúster.
  • Cree un espacio de nombres llamado netscaler para aislar los recursos. Ejecute el siguiente comando para crear un espacio de nombres:
    kubectl create namespace netscaler
  • Instale el controlador de entrada de NetScaler para su NetScaler VPX o NetScaler MPX utilizando los siguientes comandos de Helm.
Nota:
Asegúrese de crear un secreto utilizando las credenciales de NetScaler VPX o NetScaler MPX antes de ejecutar los siguientes comandos.
helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/

helm install NetScaler-ingress-controller netscaler/NetScaler-ingress-controller --set nsIP=<NSIP of MPX/VPX>,license.accept=yes,adcCredentialSecret=<Secret-for-ADC-credentials>,ingressClass[0]=netscaler,serviceClass[0]=netscaler,ipam=true,crds.install=true -n netscaler
Para obtener información detallada sobre la implementación y configuración del controlador de entrada de NetScaler mediante gráficos de Helm, consulte el repositorio de gráficos de Helm.

Implementar el controlador IPAM

  1. Agregue el repositorio de gráficos de Helm de NetScaler a su registro local utilizando el siguiente comando.
    helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/
  2. Instale el controlador IPAM de NetScaler utilizando el siguiente comando.
    helm install netscaler-ipam-controller netscaler/netscaler-ipam-controller --set vipRange='[{"<VIP-range-key>": ["<ip-range>"]}]' -n netscaler
Para obtener información sobre todos los parámetros configurables al instalar el controlador IPAM mediante gráficos de Helm, consulte el repositorio de gráficos de Helm.

Asignaciones de direcciones IP

  • Para los servicios de tipo LoadBalancer, se asigna una dirección IP única a cada servicio del rango VIP.
  • Para un recurso de entrada, se asigna una dirección IP dentro del rango IP especificado. Cuando varios recursos de entrada hacen referencia al mismo rango VIP, la dirección IP asignada al primer recurso de entrada se asigna a todos los demás recursos de entrada.
  • Tanto los servicios de tipo LoadBalancer como los recursos de entrada pueden usar el controlador IPAM de NetScaler para la asignación de direcciones IP al mismo tiempo. Si se asigna una dirección IP a un tipo de recurso, no estará disponible para otro tipo de recurso. Sin embargo, la misma dirección IP se puede asignar a varios recursos de entrada.

Variables de entorno en el controlador IPAM

Esta sección proporciona información sobre las variables de entorno en el controlador IPAM de NetScaler.

VIP_RANGE

La variable de entorno VIP_RANGE le permite definir el rango de direcciones IP. Puede definir un rango de direcciones IP o un rango de direcciones IP asociado a un nombre único.
Rango de direcciones IP
Puede definir el rango de direcciones IP a partir de una subred o varias subredes. Además, puede usar el carácter - para definir el rango de direcciones IP. El controlador IPAM asigna la dirección IP de este rango de direcciones IP al servicio.
Rango de direcciones IP asociado a un nombre único
Puede asignar un nombre único al rango de direcciones IP y definir el rango en la variable de entorno VIP_RANGE. Esta forma de asignar el rango de direcciones IP le permite diferenciar entre los rangos de direcciones IP. Cuando crea los servicios de tipo LoadBalancer, puede usar la anotación service.citrix.com/ipam-range en la definición del servicio para especificar el rango de direcciones IP que se utilizará para la asignación de direcciones IP.

reuseIngressVip

La variable reuseIngressVip le permite configurar el controlador IPAM para asignar la misma dirección IP o una dirección IP diferente a cada recurso de entrada que haga referencia al mismo rango VIP.
Valor de reuseIngressVip Descripción
true (Predeterminado) Asigna la misma dirección IP a cada recurso de entrada
falso Asigna una dirección IP diferente a cada recurso de entrada

Referencia

  • Para obtener información sobre cómo exponer servicios de tipo LoadBalancer con direcciones IP asignadas por el controlador IPAM, consulte esta sección.