Instalar un operador de agente de NetScaler mediante la consola de OpenShift

Last published : Oct 02, 2026
Nota:
El agente de OpenShift solo es compatible con el servicio NetScaler Console.
Un operador es un kit de herramientas de código abierto que le permite implementar y administrar las aplicaciones de Kubernetes de una manera eficaz, automatizada y escalable. Como administrador, puede implementar un agente en el clúster de OpenShift mediante el operador de agente de NetScaler® ADM.
Nota:
Un agente configurado en el clúster de OpenShift no se actualiza automáticamente de forma predeterminada.

Requisitos previos

Antes de la implementación, asegúrese de que:
  • Tiene las restricciones de contexto de seguridad privilegiadas para controlar los permisos de los pods. Para el agente, ejecute el siguiente comando para obtener las restricciones de contexto de seguridad privilegiadas para la cuenta de servicio:
    oc adm policy add-scc-to-user privileged -z adm-agent-serviceaccount
  • Ejecute el siguiente comando para crear un secreto de inicio de sesión del agente:
    kubectl create secret generic admlogin --from-literal=username=nsroot --from-literal=password=<adm-agent-password> -n <namespace>
    Nota:
    • <adm-agent-password> es una contraseña de ejemplo. Debe establecer una contraseña para el agente y NetScaler CPX utiliza estas credenciales para registrarse con el agente.
    • Proporcione admlogin para loginSecret en el YAML del agente al crear la instancia.
    Si está implementando NetScaler CPX™ y el agente en diferentes espacios de nombres, asegúrese de:
    • Etiquete el espacio de nombres con citrix-cpx=enabled en el que se ha implementado NetScaler CPX.
    • Establezca helper.required en verdadero o falso al instalar el operador del agente.
      Nota:
      De forma predeterminada, helper.required se establece en false. Si este parámetro se establece en falso, debe asegurarse de crear el secreto admlogin en cada espacio de nombres si NetScaler CPX y el agente están en espacios de nombres diferentes.
  • Tiene accessSecret que se requiere en el YAML del agente. Estas credenciales son necesarias para que el agente se conecte con el servicio NetScaler Console.
    kubectl create secret generic <secretname> --from-literal=accessid=<ID> --from-literal=accesssecret=<Secret> -n namespace
    Nota:
    Proporcione un nombre de secreto para accessSecret en el YAML del agente al crear la instancia.
    Puede obtener el ID de acceso y el secreto para acceder a NetScaler Console siguiendo el siguiente procedimiento:
    1. Inicie sesión en la consola de administración de Citrix Cloud™.
    2. En el menú de Citrix Cloud, seleccione Identity and Access Management.
      Administración de identidades y accesos
    3. En la pestaña API Access, introduzca un nombre de cliente seguro y haga clic en Create Client.
      API access
    4. Se generan el ID y el Secreto. Haga clic en Descargar y guarde el archivo CSV.
      Archivo de ID y secreto

Instalar el operador de agente

  1. Inicie sesión en la consola del clúster de OpenShift.
  2. Vaya a Operadores > OperatorHub.
  3. En la barra de búsqueda, proporcione el nombre del agente y seleccione el Operador de agente de NetScaler ADM y, a continuación, haga clic en Instalar.
    Operador de agente
  4. En la página Instalar operador, tiene dos opciones:
    • Todos los espacios de nombres del clúster (predeterminado): permite que el operador de agente se suscriba a todos los espacios de nombres disponibles en el clúster y le permite iniciar la instancia del operador de agente desde cualquier espacio de nombres del clúster.
    • Un espacio de nombres específico en el clúster: permite que el operador de agente se suscriba a un espacio de nombres seleccionado en el clúster y solo puede iniciar la instancia del operador de agente desde el espacio de nombres seleccionado.
      En este ejemplo, el operador de agente se asigna a un espacio de nombres llamado Default. Seleccione Automático en Aprobación de actualización y haga clic en Instalar.
      Instalar
      Espere hasta que el operador de agente se haya suscrito correctamente.
      Suscrito
  5. Vaya a Cargas de trabajo > Pods y verificar que el pod netscaler-adm-agent-operator-controller esté en funcionamiento y en ejecución.
  6. Después de que el pod esté en funcionamiento, haga clic en Crear instancia.
    Crear instancia
  7. Seleccione la vista YAML para actualizar cualquier parámetro y, a continuación, haga clic en Crear.
    Nota:
    Asegúrese de que solo haya una instancia de agente por clúster de OpenShift.
    Vista YAML
  8. Vaya a Cargas de trabajo > Pods y asegúrese de que los pods del agente estén en funcionamiento.
    Pod de verificar

Eliminar una instancia de agente

Puede eliminar la instancia de agente del clúster navegando a Operadores > Operadores instalados. En la pestaña Operador de agente de NetScaler ADM, seleccione la instancia y, a continuación, seleccione Eliminar AdmAgent de la lista.
Eliminar

Desinstalar el operador de agente

Si desea desinstalar el pod del operador de agente del clúster, vaya a Operadores > Operadores instalados y, a continuación, seleccione Desinstalar operador de la lista.
Desinstalar operador