Adición de instancias de NetScaler CPX a NetScaler ADM

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

Puede añadir instancias al configurar ADM por primera vez o más tarde.

Para añadir instancias, debe crear un perfil de instancia y especificar el nombre de host o la dirección IP de cada instancia, o un rango de direcciones IP. Este perfil de instancia contiene el nombre de usuario y la contraseña de las instancias que desea añadir a NetScaler ADM. Para cada tipo de instancia, hay un perfil predeterminado disponible. 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 sus instancias, puede definir perfiles de instancia personalizados para esas instancias. Si cambia las credenciales de una instancia después de que se haya detectado, debe editar el perfil de instancia o crear un perfil y, a continuación, volver a detectar la instancia.

Requisitos previos

Asegúrese de que tiene:

• Software NetScaler ADM instalado en Citrix XenServer. Para obtener más información, consulte Documentación de NetScaler ADM.
• Instancias de NetScaler CPX instaladas en un host de Docker.

Para añadir 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 añadir nuevas instancias CPX en NetScaler ADM.

5. Se abre la página Agregar NetScaler CPX. Introduzca los valores para los siguientes parámetros:

   1. Puede añadir instancias CPX proporcionando la dirección IP accesible de la instancia CPX o la dirección IP del contenedor de Docker donde se aloja la instancia CPX.
   2. Seleccione el perfil de la instancia CPX.
   3. Seleccione el sitio donde se implementarán las instancias.
   4. Seleccione el agente.

   5. Opcionalmente, puede introducir el par clave-valor en la instancia. Añadir un par clave-valor le facilita la búsqueda de la instancia más tarde.

      

6. Haga clic en Aceptar.

Nota

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

Adición de instancias NetScaler CPX a NetScaler ADM mediante variables de entorno

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

• NS_MGMT_SERVER - Dirección IP/FQDN de ADM
• 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 asignado en el nodo
• NS_SNMP_PORT - Puerto SNMP asignado en el nodo
• NS_ROUTABLE - (La dirección IP del pod de NetScaler CPX no es enrutable desde el exterior.)
• NS_MGMT_USER – Nombre de usuario de ADM
• NS_MGMT_PASS – Contraseña de ADM

El siguiente es un ejemplo de comando docker run 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-->

Adición de instancias de NetScaler CPX a NetScaler ADM mediante Kubernetes ConfigMaps

NetScaler CPX admite el registro con 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 deben especificarse junto con algunos archivos montados en volumen a través de ConfigMaps y Secrets.

Las siguientes son 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 de FQDN y las credenciales del agente ADM. NetScaler CPX adquiere esta información de los archivos montados en 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 las 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 con el agente ADM.

El siguiente es un ejemplo de un fragmento de archivo YAML de NetScaler CPX con el ConfigMap y el 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 ConfigMap llamado adm-agent-config y un secreto adm-agent-user. El siguiente es un ejemplo para crear el ConfigMap y el Secret requeridos.

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 debe registrarse la instancia de NetScaler CPX.

Utilice el siguiente comando para crear un ConfigMap:

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

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

Secreto: Utilice 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 necesarias y los archivos montados en volumen 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 seguirá intentando registrarse hasta que se implemente el agente ADM. Una vez implementado 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 con el agente ADM. Esto 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 el ConfigMap y el Secreto para el NetScaler CPX ya implementado. Debe actualizar el archivo a partir del cual se crea el ConfigMap con la dirección IP o el FQDN del nuevo agente ADM y eliminar el ConfigMap antiguo y, a continuación, crear un nuevo ConfigMap. Del mismo modo, el secreto existente debe eliminarse y debe crearse un nuevo secreto con las credenciales para el nuevo agente ADM.