Citrix Application Delivery Management

Migrar la configuración de aplicaciones Citrix ADC con StyleBooks Configuration Builder

El Generador de configuración de StyleBooks se utiliza para migrar una configuración de ADC existente a StyleBooks. Esta función también automatiza la migración de la configuración de la aplicación de una instancia de Citrix ADC a otra instancia o a un grupo de escalado automático.

Configuration Builder proporciona una aplicación estructurada StyleBook que se puede utilizar para cualquier variante de la configuración de ADC. Esta función le ayuda a empezar a utilizar StyleBooks sin tener un conocimiento profundo de la gramática y las construcciones de StyleBooks. De lo contrario, el conocimiento de la gramática y construcciones de StyleBooks es necesario para crear un StyleBook.

Configuration Builder también crea un paquete de configuración que refleja la misma configuración de ADC en una nueva instancia de ADC. Con este paquete de configuración, la configuración inicial de ADC de una instancia de ADC se puede duplicar en otra instancia de ADC. El origen de configuración inicial puede ser uno de los siguientes:

  • Una instancia de Citrix ADC: Especifique la instancia en la que está alojada la configuración de la aplicación que quiere duplicar.

    Configuration Builder convierte la configuración ADC en StyleBook y paquete de configuración aunque no especifique la instancia de destino. Posteriormente, puede utilizar este paquete de configuración para migrar la configuración de ADC a otras instancias de ADC.

    Si la instancia de destino es un grupo de escala automática, el paquete de configuración aparece en la página Red > Grupo de Escalado Automático. En la ficha Configuración.

  • Un conjunto de comandos CLI: Pegue la configuración desde ns.conf o Application config.

Configuration Builder identifica la lista de distintas aplicaciones incrustadas en la configuración de origen. Cuando selecciona la configuración de la aplicación de su interés, Configuration Builder extrae el conjunto de comandos CLI para la aplicación seleccionada. Estos comandos de CLI se extraen de la configuración de origen. También identifica los atributos de implementación y configuración que podrían requerir su entrada.

  • Dirección IP/puertos : puede ver y editar la dirección IP y el puerto de los servidores virtuales, servicios, miembros del grupo de servicio desde la configuración original.

  • Archivos de configuración/secretos : estos atributos pueden ser contraseñas o certificados especificados en la configuración de origen.

Después de especificar la información necesaria, comience a migrar o duplicar la configuración de la aplicación en una instancia ADC de destino.

Flujo de trabajo del generador de configuración de StyleBooks

Después de la creación y migración de la aplicación, se crea un paquete de configuración en Citrix ADM con adc_nitro_application StyleBook. Este StyleBook se crea en base a los recursos ADC NITRO. Este paquete de configuración representa la configuración de la aplicación en la instancia ADC de destino. Para ver el paquete de configuración creado, vaya a Aplicaciones > Libros de Estilo > Configuraciones.

Funciones admitidas de Citrix ADC

El generador de configuración de StyleBook reconoce y admite las siguientes funciones de Citrix ADC en la configuración de origen:

  • Cambio de contenido
  • Equilibrio de carga
  • Supervisión
  • Descarga SSL
  • Limitación de velocidad
  • Reescribe
  • Respondedor
  • Servidor de seguridad de aplicaciones web (WAF)

Crear un StyleBook para migrar la configuración de la aplicación Citrix ADC

El procedimiento siguiente consiste en crear un StyleBook que migra la migración de aplicaciones Citrix ADC en Citrix ADM:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Haga clic en Migrar configuración de ADC.

  3. Haga clic en Get Started.

  4. En Especificar configuración, seleccione el origen de configuración:

    • Importar desde un ADC: Esta opción detecta las aplicaciones activas en la instancia de ADC seleccionada.

    • Importar mediante comandos CLI: Esta opción analiza los comandos CLI y extrae las aplicaciones de los comandos CLI.

  5. Especifique la instancia de ADC de origen desde la que quiere migrar o duplicar la configuración de la aplicación.

    Para migrar la configuración de la aplicación a un grupo de escala automática, asegúrese de que no se incluye la siguiente información en la configuración de origen:

    • IPset
    • Perfil del dispositivo
    • Protocolo
    • Puerto
  6. Especifique la instancia de ADC de destino a la que quiere migrar o duplicar la configuración de la aplicación.

    Para migrar una configuración de aplicación a un grupo de escala automática, seleccione el grupo Escalado automático en la lista.

  7. En Definir aplicación,

    1. En Nombre de aplicación, especifique el nombre de la aplicación.

      Si la instancia de destino es un grupo de escala automática, especifique los siguientes parámetros de escala automática:

      • Tipo de acceso: Puede utilizar la solución de escalado automático de ADM para aplicaciones externas e internas. Seleccione el tipo de acceso a la aplicación requerido.

      • Nombre de dominio: Especifique el nombre de dominio de una aplicación. Esta opción solo es aplicable cuando se selecciona Tipo FQDN definido por el usuario.

      • Zona del dominio: Seleccione el nombre de zona de una aplicación de la lista. Esta opción solo es aplicable cuando se selecciona Tipo FQDN definido por el usuario.

        Este nombre de dominio y zona redirige a los servidores virtuales de Azure. Por ejemplo, si aloja una aplicación en app.example.com, app es el nombre de dominio y example.com es el nombre de zona.

    2. Seleccione los servidores virtuales que quiere migrar.

      Seleccione los servidores virtuales que desea migrar

    3. Haga clic en Siguiente.

  8. En Comandos equivalentes de CLI, revise los comandos y haga clic en Siguiente.

    Estos comandos son específicos de la configuración de la aplicación seleccionada.

    Nota

    También puede agregar o editar la configuración si es necesario.

  9. En Atributos de implementación, puede ver y modificar la dirección IP y el puerto de los servidores virtuales, los servicios y los miembros del grupo de servicios.

    Para modificar la dirección IP y el puerto, haga clic en el icono de edición del servidor virtual, servicio o miembro del grupo de servicios en el diagrama de flujo.

    Modificar los atributos de implementación

    Nota

    Si la instancia de destino es un grupo de escala automática, se deshabilita la edición de la dirección IP del front-end.

    Esta ficha solo aparece en los siguientes casos:

    • Las instancias de origen y destino son diferentes.

    • Importar configuraciones mediante comandos CLI.

  10. En Atributos de configuración, especifique los detalles necesarios y haga clic en Siguiente.

    Esta ficha enumera los secretos, como claves para descifrar contraseñas y certificados.

    Nota

    Antes de iniciar la migración, las configuraciones perdidas o no admitidas se muestran en cualquiera de las siguientes fichas:

    • Configuraciones no admitidas

    • Configuraciones globales no admitidas

    Para migrar estas configuraciones correctamente, debe aplicar las configuraciones perdidas o no admitidas por separado en la instancia de destino. Y, haga clic en Siguiente.

  11. En Migrar, haga clic en Migrar.

Limitaciones

  • Las expresiones nombradas yresponderhtmlpages mencionadas en la instancia de origen no se identifican. Asegúrese de configurar las expresiones con nombre asignado yresponderhtmlpages en la instancia de destino antes de la migración.

  • Si el origen tiene una configuración paraservicegroup y el enlace de supervisión de la siguiente manera:

    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>

    Aparece el siguiente error:

     CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
     <!--NeedCopy-->
    

    Este error se produce porque Citrix ADC guarda el enlace entre Service Group y Monitor en un formato no válido. Este problema se ha corregido desde la compilación de Citrix ADC 12.1.52.15.

Migrar la configuración de aplicaciones Citrix ADC con StyleBooks Configuration Builder