Agregar instancias CPX de Citrix ADC a Citrix ADM

Debe agregar las instancias CPX de Citrix ADC instaladas en un host de Docker al software Citrix 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 Citrix ADM. Para cada tipo de instancia, está disponible un perfil predeterminado. Por ejemplo, ns-root-profile es el perfil predeterminado para las instancias de Citrix ADC. 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 Citrix ADM en Citrix XenServer. Para obtener más información, consulte la documentación de Citrix ADM.
  • Se instalaron las instancias CPX de Citrix ADC en un host de Docker.

Para agregar instancias de Citrix ADC CPX a ADM:

  1. En un explorador web, escriba la dirección IP de Citrix 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 > Citrix ADC y haga clic en la ficha CPX.

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

  5. Se abrirá la página Add Citrix ADC CPX. Introduzca los valores para los siguientes parámetros:

    1. Puede agregar instancias CPX proporcionando la dirección IP accesible de la instancia CPX o la dirección IP del contenedor Docker donde está alojada la instancia CPX.
    2. Seleccione el perfil de la instancia CPX.
    3. Seleccione el sitio donde 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.

      Imagen localizada

  6. Haga clic en OK.

Nota

Si quiere volver a descubrir una instancia, elija Redes > Instancias > Citrix ADC > 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 Citrix ADC CPX a Citrix ADM mediante variables de entorno

También puede agregar las instancias CPX de Citrix ADC a Citrix ADM mediante variables de entorno. Para agregar instancias, debe configurar las siguientes variables de entorno para la instancia de Citrix ADC 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 Citrix ADC 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 Citrix ADC CPX a Citrix 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 CPX de Citrix ADC a Citrix ADM mediante Kubernetes ConfigMaps

Citrix ADC CPX admite el registro en Citrix ADM mediante el uso de archivos montados en volumen a través de Kubernetes ConfigMaps. Para habilitar esta forma de registro, Citrix ADC 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, Citrix ADC 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. Citrix ADC 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 CPX de Citrix ADC. 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 Citrix ADC CPX. Con toda la información necesaria para el registro, Citrix ADC CPX intenta registrarse en el agente ADM.

A continuación se muestra un ejemplo de fragmento de archivo YAML de Citrix ADC 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 Citrix ADC 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 Citrix ADC 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 Citrix ADC CPX antes de implementar el agente ADM, Citrix ADC CPX sigue intentando registrarse hasta que se implemente el agente ADM. Una vez que se implementa el agente ADM, la instancia de Citrix ADC 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 Citrix ADC CPX con la información de configuración.

Una instancia de Citrix ADC 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 Citrix ADC 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 CPX de Citrix ADC a Citrix ADM