Configuración de StyleBook

Crear y modificar un paquete de configuración

En NetScaler Console, puede crear un paquete de configuración a partir de un StyleBook. El paquete de configuración está vinculado al StyleBook desde el que se creó. Cualquier actualización del paquete de configuración se realiza a través del StyleBook al que está vinculado.

Crear un paquete de configuración

Para crear un paquete de configuración a partir de un StyleBook, haga lo siguiente:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.

  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 los StyleBooks en libros de estilo predeterminados, empresariales y personalizados. Seleccione las fichas respectivas para encontrar los StyleBooks necesarios.

  4. Opcional, especifique una clave de configuración única para su paquete de configuración. Esta clave aparece como clave de visualización para este paquete de configuración.

    • Si especifica una clave de configuración existente, NetScaler Console no podrá crear el paquete de configuración.

    • Si no especifica una clave de configuración , NetScaler Console asigna automáticamente el ID del paquete de configuración. Sin embargo, este valor no aparece como clave de visualización.

    • Si no especifica una clave de configuración y alguno de los parámetros de StyleBook ha establecido el atributo key, el valor de ese parámetro aparecerá como clave de visualización. Para obtener más información, consulte Parámetros.

  5. 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.

  6. 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 NetScaler especificando tantas instancias de destino como sea 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 NetScaler.

  8. Haga clic en Crear

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

Si desea editar los paquetes de configuración existentes, seleccione el paquete de configuración y haga clic en Editar .

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 anterior, es posible que desee actualizarlos para usar 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 de balanceador de carga en una instancia de NetScaler. Además, se crea un paquete de configuración CP1 a partir de este StyleBook.

Para configurar los monitores con la configuración básica del equilibrador de carga, necesita un StyleBook nuevo. Para ello, cree un StyleBook example-lb-mon que incluya la capacidad de configurar monitores junto con la configuración básica del balanceador de cargas.

Tras crear un StyleBook, actualice el paquete de configuración CP1 existente para agregar monitores. Para actualizar el paquete de configuración, haga lo siguiente:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.

  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.

    Nota:

    La página de compatibilidad de StyleBook muestra las diferencias en los parámetros. Esta página le ayuda a decidir si quiere cambiar el StyleBook o continuar con el StyleBook existente. Si quiere cambiar el StyleBook, revise los cambios y, a continuación, haga clic en Siguiente.

    Si se agregan nuevos parámetros al nuevo StyleBook, después de cambiar el StyleBook, debe 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, los StyleBooks conservan los valores más antiguos de la configuración básica del balanceador de cargas 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 NetScaler.

  8. Haga clic en OK.

    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.

Cambie el StyleBook que tiene varios paquetes de configuración

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

  1. Importe un StyleBook nuevo a NetScaler Console.

    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 por 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.

    Para los paquetes de configuración seleccionados, la consola de NetScaler 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 curso/fallidas en la página de configuraciones .

  3. Elimine el StyleBook antiguo de la consola NetScaler una vez que todos los paquetes de configuración estén vinculados al nuevo StyleBook.

Exportación o importación de 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 de NetScaler Console. 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 > Configuración > Paquetes de configuración.

  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 Exportar.

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

Importar configuración

Puede importar un paquete de configuración de su equipo local a otro servidor de NetScaler Console. Para importar un paquete de configuración, haga lo siguiente:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.

  2. Seleccione Importar configuración.

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

  4. Utilice la contraseña que especificó durante la exportación.

  5. Opcionalmente, en Opciones avanzadas, seleccione Permitir solo la creación de una nueva configuración si todos los objetos de configuración ya existen en NetScaler.

    Esta opción no altera los objetos que ya están creados en la instancia de NetScaler.

    Tenga en cuenta que agregó la misma instancia de NetScaler en dos servidores de NetScaler Console. Además, desea migrar un paquete de configuración de un servidor de NetScaler Console a otro servidor. Utilice esta opción para importar un paquete de configuración sin modificar sus objetos de configuración en una instancia de NetScaler.

    Importante:

    Para usar esta opción, asegúrese de que el paquete de configuración especificado tenga la información de las instancias de destino. Consulte Configuración de exportació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, la consola de NetScaler comprueba lo siguiente:

  • StyleBookasociado : si el StyleBook asociado no está en la consola de NetScaler, 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 de NetScaler mencionadas no están en la consola de NetScaler, el paquete de configuración se importa sin las instancias de destino.

  • NetScaler Console de origen: si importa un paquete de configuración en el mismo servidor de NetScaler Console, el paquete seleccionado actualiza el paquete de configuración existente.

Guardar un paquete de configuración como borrador

La opción Guardar como borrador de los paquetes de configuración le permite guardar los cambios de configuración como borradores. Esta función guarda los cambios sin implementarlos inmediatamente en una instancia de NetScaler.

Para guardar un paquete de configuración como borrador, siga estos pasos:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.
  2. En la página Configuraciones, haga clic en Agregar.
  3. Seleccione el libro de estilos que desee y haga clic en Seleccionar.
  4. En la página Crear configuración, haga clic en Guardar como borrador.

Guardar como borrador

Una vez que el paquete de configuración se guarda como borrador, los cambios de configuración no se implementan directamente en la instancia de NetScaler. En su lugar, los paquetes de configuración se almacenan como borradores en la pestaña Borrador de configuraciones, en Configuraciones pendientes.

En la pestaña Borrador de configuraciones, seleccione el paquete de configuración para realizar las siguientes operaciones:

  • Editar la configuración del borrador.
  • Implementar la configuración en una instancia de NetScaler.
  • Eliminar el borrador.

Borrador de configuraciones

También puede programar cuándo implementar los borradores guardados.

Para obtener más información, consulte Crear una programación para un paquete de configuración.

Crear una programación para un paquete de configuración

Al crear un paquete de configuración, el paquete de configuración se implementa automáticamente en una instancia de NetScaler de forma predeterminada. Con esta función, puede programar la implementación de los paquetes de configuración.

Para crear una programación para un paquete de configuración, siga estos pasos:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.
  2. En la página Configuraciones, haga clic en Agregar.
  3. Seleccione el libro de estilos y haga clic en Seleccionar.
  4. En la página Crear configuración, en Ejecución, seleccione Más tarde en la lista Modo de ejecución.
  5. Seleccione la fecha y hora deseadas para la programación y haga clic en Enviar.

Modo de ejecución

Todas las configuraciones programadas se almacenan en la pestaña Configuraciones programadas en Configuraciones pendientes. Puede seleccionar la programación creada para editar los parámetros de configuración, implementar o cancelar la programación.

Nota:

La implementación de un paquete de configuración programado cancela la programación y ejecuta la configuración de inmediato.

Configuración programada

Para un paquete de configuración implementado

También puede crear una programación para editar y eliminar un paquete de configuración implementado.

Programar una operación de edición para un paquete de configuración

Para crear una programación para editar el paquete de configuración implementado, siga estos pasos:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.
  2. En la página Configuraciones, seleccione un StyleBook y haga clic en Editar.
  3. En la página Editar configuración, edite el paquete de configuración.
  4. En la lista Modo de ejecución, seleccione Más tarde.
  5. Seleccione la fecha y hora deseadas para la programación y haga clic en Enviar.

Programar una operación de eliminación para un paquete de configuración

Para crear una programación para eliminar el paquete de configuración implementado, siga estos pasos:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.
  2. En la página Configuraciones, seleccione un StyleBook y haga clic en Eliminar.
  3. En la lista Modo de ejecución, seleccione Más tarde.
  4. Seleccione la fecha y hora deseadas para la programación y haga clic en Aceptar.

Eliminar la programación del paquete de configuración

Separar una instancia de destino de un paquete de configuración

Para separar una instancia de destino de un paquete de configuración, haga lo siguiente:

  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.

  2. Seleccione el paquete de configuración con una instancia de destino que quiera eliminar.

  3. En Seleccionar acción, seleccione Separar objetivos.

  4. En el panel Separar objetivos, seleccione la instancia de destino que quiere eliminar del paquete de configuración.

    Separar objetivos

  5. Haga clic en OK.

Aparece un mensaje que confirma la creación de un paquete de configuración duplicado con la instancia de destino ahora eliminada.

Crea sus 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
<!--NeedCopy-->

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 NetScaler 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
<!--NeedCopy-->
Crear y modificar un paquete de configuración