Agregar instancias de NetScaler CPX a NetScaler ADM

Debe agregar las instancias de NetScaler CPX instaladas en un host de Docker al software NetScaler Application Delivery Management (ADM) si quiere administrar y supervisar estas instancias.

Puede agregar instancias al configurar ADM por primera vez o más tarde.

Para agregar instancias, debes crear un perfil de instancia y especificar el nombre de host o la dirección IP de cada instancia, o un intervalo de direcciones IP. Este perfil de instancia contiene el nombre de usuario y la contraseña de las instancias que quiere agregar a NetScaler ADM. Para cada tipo de instancia, está disponible un perfil predeterminado. Por ejemplo, ns-root-profile es el perfil predeterminado para las instancias de NetScaler. Este perfil se define mediante las credenciales de administrador de ADC predeterminadas. Si ha cambiado las credenciales de administrador predeterminadas de las instancias, puede definir perfiles de instancia personalizados para esas instancias. Si cambia las credenciales de una instancia después de detectarse la instancia, debe modificar el perfil de instancia o crear un perfil y, a continuación, volver a descubrir la instancia.

Requisitos previos

Asegúrese de lo siguiente:

  • Se instaló el software NetScaler ADM en Citrix XenServer. Para obtener más información, consulte la documentación de NetScaler ADM.
  • Se instalaron las instancias de NetScaler CPX en un host de Docker.

Para agregar instancias de NetScaler CPX a ADM:

  1. En un explorador web, escriba la dirección IP de NetScaler Application Delivery Management (por ejemplo, http://192.168.100.1)).

  2. En los campos Nombre de usuario y Contraseña, introduzca las credenciales de administrador. Las credenciales de administrador predeterminadas son nsroot y nsroot.

  3. Vaya a Redes > Instancias > NetScaler y haga clic en la ficha CPX.

  4. Haga clic en Agregar para agregar nuevas instancias CPX en NetScaler ADM.

  5. Se abrirá la página Add NetScaler CPX. Introduzca los valores de los siguientes parámetros:

    1. Puede agregar instancias de CPX proporcionando la dirección IP accesible de la instancia CPX o la dirección IP del contenedor Docker donde está alojada la instancia de CPX.
    2. Seleccione el perfil de la instancia CPX.
    3. Seleccione el sitio en el que se van a implementar las instancias.
    4. Seleccione el agente.
    5. Como opción, puede introducir el par clave-valor en la instancia. La incorporación de un par clave-valor facilita la búsqueda de la instancia más adelante.

      Agregar instancias de CPX

  6. Haga clic en Aceptar.

Nota

Si quiere volver a descubrir una instancia, elija Redes > Instancias > NetScaler > CPX, seleccione la instancia que quiere redescubrir y, a continuación, en la lista desplegable Seleccionar acción, haga clic en Redescubrir.

Agregar instancias de NetScaler CPX a NetScaler ADM mediante variables de entorno

También puede agregar las instancias de NetScaler CPX a NetScaler ADM mediante variables de entorno. Para agregar instancias, debe configurar las siguientes variables de entorno para la instancia de NetScaler CPX.

  • NS_MGMT_SERVER - Dirección IP ADM/FQDN
  • HOST - Dirección IP del nodo
  • NS_HTTP_PORT - Puerto HTTP asignado en el nodo
  • NS_HTTPS_PORT- Puerto HTTPS asignado en el nodo
  • NS_SSH_PORT - Puerto SSH mapeado en el nodo
  • NS_SNMP_PORT - Puerto SNMP asignado en el nodo
  • NS_ROUTABLE - (La dirección IP del pod de NetScaler CPX no se puede redirigir desde el exterior).
  • NS_MGMT_USER — Nombre de usuario de ADM
  • NS_MGMT_PASS — Contraseña ADM

A continuación, se muestra un comando docker run de ejemplo para agregar una instancia de NetScaler CPX a NetScaler ADM.

 docker run -dt --privileged=true -p 9080:9080 -p 9443:9443 -p 9022:22 -p 9161:161 -e EULA=yes -e NS_MGMT_SERVER=abc-mgmt-server.com -e HOST=10.1.1.1 -e NS_HTTP_PORT=9080 -e NS_HTTPS_PORT=9443 -e NS_SSH_PORT=9022 -e NS_SNMP_PORT=9161 -e NS_ROUTABLE=0 --ulimit core=-1 –name test cpx:latest

<!--NeedCopy-->

Agregar instancias de NetScaler CPX a NetScaler ADM mediante Kubernetes ConfigMaps

NetScaler CPX admite el registro en NetScaler ADM mediante el uso de archivos montados en volumen a través de Kubernetes ConfigMaps. Para habilitar esta forma de registro, NetScaler CPX requiere algunas variables de entorno que se especificarán junto con algunos archivos montados en volúmenes a través de ConfigMaps y Secrets.

A continuación se muestran las variables de entorno requeridas y su descripción:

  • NS_HTTP_PORT - Especifica el puerto HTTP asignado en el nodo.
  • NS_HTTPS_PORT - Especifica el puerto HTTPS asignado en el nodo.
  • NS_SSH_PORT - Especifica el puerto SSH asignado en el nodo.
  • NS_SNMP_PORT- Especifica el puerto SNMP asignado en el nodo.

Además de las variables de entorno enumeradas, NetScaler CPX requiere información sobre el agente ADM con el que debe registrarse. Esta información contiene la dirección IP o los detalles y credenciales de FQDN del agente ADM. NetScaler CPX adquiere esta información de los archivos montados en el volumen. Un ConfigMap que contiene la dirección IP o el FQDN se monta como un archivo en el sistema de archivos de la instancia de NetScaler CPX. Un secreto de Kubernetes que contiene credenciales para el agente ADM también se monta como un archivo en el sistema de archivos de la instancia de NetScaler CPX. Con toda la información necesaria para el registro, NetScaler CPX intenta registrarse en el agente ADM.

A continuación se muestra un ejemplo de fragmento de archivo YAML de NetScaler CPX con ConfigMap y Secret montados como archivos:

      …
      env:
      - name: "EULA"
        value: "yes"
      - name: "NS_HTTP_PORT"
        value: "9080"
      - name: "NS_HTTPS_PORT"
        value: "9443"
      - name: "NS_SSH_PORT"
        value: "22"
      - name: "NS_SNMP_PORT"
        value: "161"
      - name: "KUBERNETES_TASK_ID"
        value: ""
      …
      volumeMounts:
        …
        - mountPath: /var/adminfo/server/
          name: adm-agent-config
        - mountPath: /var/adminfo/credentials/
          name: adm-agent-user
        …
  volumes:
  …
  - name: adm-agent-config
    configMap:
      name: adm-agent-config
  - name: adm-agent-user
    secret:
      secretName: adm-secret

En el ejemplo anterior, se consumen un nombre ConfigMap adm-agent-config y un secreto adm-agent-user. A continuación se muestra un ejemplo para crear el ConfigMap y Secret necesarios.

ConfigMap: El ConfigMap se crea a partir de un archivo llamado adm_reg_envs. El archivo requiere la dirección IP o el FQDN del agente ADM en el siguiente formato:

NS_MGMT_SERVER=adm-agent

En el formato anterior, adm-agent es el FQDN del agente ADM en el que se debe registrar la instancia de NetScaler CPX.

Use el siguiente comando para crear un ConfigMap:

kubectl create configmap adm-agent-config --from-file=adm_reg_envs

Nota: El nombre del archivo debe tener la variable adm_reg_envs y debe montarse en la ruta: /var/adminfo/server/.

Secreto: usa el siguiente comando para crear un secreto de Kubernetes. En el siguiente comando, user123 es el nombre de usuario del agente ADM y pass123 es la contraseña.

kubectl create secret generic adm-secret --from-literal=NS_MGMT_USER=user123 --from-literal=NS_MGMT_PASS=pass123

Una instancia de NetScaler CPX se puede implementar en un clúster de Kubernetes con las variables de entorno y los archivos montados en volumen requeridos incluso antes de implementar el agente ADM en el clúster. Si implementa una instancia de NetScaler CPX antes de implementar el agente ADM, NetScaler CPX sigue intentando registrarse hasta que se implemente el agente ADM. Una vez que se implementa el agente ADM, la instancia de NetScaler CPX utiliza los datos de configuración proporcionados a través de las variables de entorno y los archivos montados en volumen para registrarse en el agente ADM. Le ayuda a evitar la reimplementación de NetScaler CPX con la información de configuración.

Una instancia de NetScaler CPX, que ya está registrada con un agente ADM, puede cambiar dinámicamente el registro a otro agente ADM después de un cambio en la configuración. Para ello, puede actualizar la información de configuración en ConfigMap y el secreto para el NetScaler CPX ya implementado. Debe actualizar el archivo desde el que se creó el ConfigMap con la dirección IP o el FQDN del nuevo agente ADM y eliminar el ConfigMap anterior y, a continuación, crear un nuevo ConfigMap. Del mismo modo, se debe eliminar el secreto existente y se debe crear un nuevo secreto con las credenciales del nuevo agente de ADM.

Agregar instancias de NetScaler CPX a NetScaler ADM