Citrix Application Delivery Management

Crear y modificar un paquete de configuración

En Citrix Application Delivery Management (ADM), puede crear un paquete de configuración a partir de un StyleBook. Además, el paquete de configuración está vinculado al StyleBook desde el que se crea. Las actualizaciones del paquete de configuración se realizan a través del StyleBook al que está vinculado.

Crear un paquete de configuración

Realice lo siguiente para crear un paquete de configuración a partir de un StyleBook:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Haga clic en Agregar.

  3. En Elegir StyleBooks, seleccione los StyleBooks necesarios a partir de los cuales quiere crear un paquete de configuración.

    Esta página clasifica StyleBooks en StyleBooks predeterminados y personalizados. Seleccione las fichas respectivas para encontrar los StyleBooks necesarios.

  4. Especifique los detalles necesarios, como el nombre de la aplicación, la dirección IP, el puerto o el tipo de protocolo.

    Los campos GUI difieren de un StyleBook a otro StyleBook.

  5. En Instancias de destino, seleccione instancias o grupos de instancias en los que quiera ejecutar la configuración.

    Nota

    Puede implementar la configuración en más de un Citrix ADC especificando tantas instancias de destino como sea necesario.

  6. Haga clic en Ejecutar en seco.

    La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de Citrix ADC.

  7. Haga clic en Crear

    El paquete de configuración aparece en la página StyleBook > Configuraciones.

Si quiere modificar los paquetes de configuración existentes, seleccione el paquete de configuración y haga clic en Modificar.

Cambiar el StyleBook de un paquete de configuración

A veces, debe actualizar el StyleBook para agregar funcionalidad o solucionar un problema. Si ya ha creado paquetes de configuración con el StyleBook antiguo, es posible que quiera actualizarlos para utilizar el nuevo StyleBook actualizado. Para utilizar un nuevo StyleBook, cambie el StyleBook existente del paquete de configuración.

Considere un ejemplo de StyleBook example-lb que implementa una configuración básica del equilibrador de carga en una instancia de ADC. Además, se crea un paquete de configuración CP1 a partir de este StyleBook.

Cuando quiera configurar monitores con la configuración básica del equilibrador de carga, necesita un nuevo StyleBook. Por lo tanto, cree ejemplo-lb-mon StyleBook que incluya la capacidad de configurar monitores junto con la configuración básica del equilibrador de carga.

Después de crear un StyleBook, actualice el paquete de configuración CP1 existente para agregar algunos monitores. Para ello, realice lo siguiente:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Seleccione el paquete de configuración para el que quiere cambiar el StyleBook.

    En este ejemplo, seleccione CP1 de la lista.

  3. Haga clic en Cambiar StyleBooks.

  4. Seleccione el StyleBook requerido de la lista. A continuación, haga clic en Guardar selección.

  5. Haga clic en Change.

    En este ejemplo, seleccione ejemplo-lb-mon de la lista.

    Al cambiar el StyleBook de un paquete de configuración, los parámetros del nuevo StyleBook pueden tener una estructura diferente a la del StyleBook existente. Si la estructura de parámetros es similar a la StyleBook anterior, los valores de los parámetros se conservan automáticamente en sus respectivos campos. De lo contrario, solo se transfieren los parámetros que tengan la misma estructura entre los dos StyleBooks. Por ejemplo, el mismo nombre de parámetro, tipo, principal de parámetro y mucho más.

    Cambiar el StyleBook de un paquete de configuración

    Si se agregan nuevos parámetros necesarios en el nuevo StyleBook, después de cambiar el StyleBook, deberá especificar manualmente los valores de dichos parámetros.

    En este ejemplo, los parámetros que aparecen en la página de configuración del ejemplo-lb StyleBook son los siguientes:

    Ejemplo de paquete de configuración de equilibrio de carga

    Los parámetros que aparecen en la página de configuración del nuevo ejemplo-lb-mon StyleBook son los siguientes:

    Ejemplos de parámetros después de la migración del paquete de configuración

    En este caso, StyleBooks conservan los valores anteriores para la configuración básica del equilibrador de carga porque el nuevo StyleBook no ha cambiado los parámetros existentes. Y, agrega solo los nuevos parámetros. Para parámetros de supervisión, especifique manualmente los valores necesarios.

  6. En Instancias de destino, revise las instancias seleccionadas y actualice la lista si es necesario.

  7. Haga clic en Ejecutar en seco.

    La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de Citrix ADC.

  8. Haga clic en Aceptar.

    En la página StyleBook > Configuraciones, la columna Nombre del StyleBook muestra el nuevo nombre de StyleBook para el paquete de configuración seleccionado. En este caso, muestra ejemplo-lb-mon.

Cambiar el StyleBook que tiene varios paquetes de configuración

Cuando cambie un StyleBook existente que tiene varios paquetes de configuración, haga lo siguiente:

  1. Importar un nuevo StyleBook a ADM.

    Normalmente, el nuevo StyleBook tiene el mismo nombre y espacio de nombres con una versión superior a la del StyleBook existente. Sin embargo, puede omitir este paso si el nombre, el espacio de nombres o la versión son diferentes.

  2. Cambie el StyleBook para los paquetes de configuración asociados al StyleBook existente.

    Puede seleccionar Cambiar StyleBook solo cuando los paquetes de configuración seleccionados estén asociados al mismo StyleBook.

    Seleccionar los paquetes de configuración asociados al mismo StyleBook

    Para los paquetes de configuración seleccionados, el ADM cambia correctamente el StyleBook cuando se cumplen las siguientes condiciones:

    • Todos los parámetros de configuración del StyleBook existente deben estar presentes en el StyleBook seleccionado.

    • Los nuevos parámetros del StyleBook seleccionado son opcionales.

    Para ver el progreso de los paquetes de configuración seleccionados, seleccione Configuraciones en Progres/Fallo en la página Configuraciones.

    Estado de progreso del paquete de configuración

  3. Quite el StyleBook antiguo de ADM una vez que todos los paquetes de configuración estén vinculados al nuevo StyleBook.

Exportar o importar paquetes de configuración

Puede exportar o importar un paquete de configuración como StyleBooks. Con esta función, puede compartir fácilmente la configuración de StyleBook con otro servidor ADM. Cuando exporta un paquete de configuración, un paquete tgz o un paquete zip se descarga al equipo local. Este paquete incluye un archivo JSON con todos los parámetros definidos en un paquete de configuración.

Exportar configuración

Haga lo siguiente para exportar un paquete de configuración:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Seleccione el paquete de configuración que quiera exportar.

  3. En Seleccionar acción, seleccione Exportar configuración.

    Opción de configuración de exportación

  4. En el panel Configuración de exportación, especifique lo siguiente:

    • Información de instancias de destino en las que se implementa la configuración: seleccione esta opción para incluir la información de las instancias de destino con el paquete de exportación.

    • StyleBook asociado a Configuración: Seleccione esta opción para incluir el StyleBook en el paquete de exportación.

    • Frase de contraseña para proteger los datos de configuración de exportación: especifique una frase de contraseña para cifrar el paquete de exportación. Esta frase de contraseña protege los datos confidenciales de un paquete de configuración.

    • Comprimir tipo de archivo: seleccione el tipo de archivo ZIP o TGZ .

    Exportar paquete de configuración

  5. Haga clic en Export.

    Guarde el paquete de exportación en el equipo local.

Importar configuración

Puede importar un paquete de configuración desde el equipo local a otro servidor ADM. Para importar un paquete de configuración, haga lo siguiente:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Seleccione Importar configuración.

    Opción de configuración de importación

  3. Elija el paquete de archivos de importación desde el equipo.

  4. Utilice la frase de contraseña especificada durante la exportación.

  5. Opcional, en Opciones avanzadas, seleccione Solo permitir la creación de nueva configuración si ya existen todos los objetos de configuración en ADC.

    Esta opción no modifica los objetos que ya se han creado en la instancia de ADC.

    Tenga en cuenta que ha agregado la misma instancia de ADC en dos servidores ADM. Además, quiere migrar un paquete de configuración de un servidor ADM a otro servidor. Utilice esta opción para importar un paquete de configuración sin alterar sus objetos de configuración en una instancia de ADC.

    Importante

    Para utilizar esta opción, asegúrese de que el paquete de configuración especificado tiene la información de las instancias de destino. ¿VesExportar configuración?

    Esta opción solo migra la configuración si todos los objetos están presentes en la instancia de destino.

  6. Haga clic en Importar.

Importar configuración

Al importar un paquete de configuración, ADM comprueba lo siguiente:

  • StyleBook asociado: si el StyleBook asociado no está en el ADM, importa el StyleBook junto con el paquete de configuración.

  • Instancias de destino: compruebe las instancias de destino e implementa la configuración en las instancias de destino especificadas. Si las instancias ADC mencionadas no están en el ADM, el paquete de configuración se importa sin instancias de destino.

  • ADM de origen: si va a importar un paquete de configuración en el mismo servidor ADM, el paquete seleccionado actualiza el paquete de configuración existente.

Crea tus StyleBooks

El contenido completo de example-lb StyleBook se proporciona para su referencia de la siguiente manera:

name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
parameters-default-sources:
  - stlb::lb
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters

El contenido completo de example-lb-mon StyleBook se proporciona para su referencia de la siguiente manera:

name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
  -
    namespace: netscaler.nitro.config
    prefix: ns
    version: "10.5"
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
  -
    namespace: com.citrix.adc.commontypes
    prefix: cmtypes
    version: "1.0"
parameters-default-sources:
  - stlb::lb
parameters:
  -
    name: monitors
    label: "List of Monitors"
    description: "List of Monitors to monitor Application Servers"
    type: cmtypes::monitor[]
substitutions:
  mon-name(appname, monname): $appname + "-mon-" + $monname
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
  -
    name: monitors-comp
    type: cmtypes::monitor
    condition: $parameters.monitors
    repeat: $parameters.monitors
    repeat-item: mon
    repeat-index: ndx
    description: Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB config
    properties-default-sources:
      - $mon
    properties:
        monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
    components:
      -
        name: monitor-svcg-binding-comp
        condition:  $parameters.svc-servers
        type: ns::servicegroup_lbmonitor_binding
        properties:
          servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
          monitor_name: $parent.properties.monitorname
Crear y modificar un paquete de configuración