Crear y editar un paquete de configuración

Last published : Oct 02, 2026
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 crea. Las actualizaciones del paquete de configuración se realizan a través del StyleBook al que está vinculado.
Related information
Crear y usar StyleBooks personalizados

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 desea crear un paquete de configuración.
    Esta página clasifica los StyleBooks en StyleBooks predeterminados y personalizados. Seleccione las pestañas 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 de la GUI difieren de un StyleBook a otro.
  5. En Instancias de destino, seleccione las instancias o grupos de instancias donde desea ejecutar la configuración.
    Nota:
    Puede implementar la configuración en más de un NetScaler, especificando tantas instancias de destino como sea necesario.
  6. Haga clic en Ejecución en seco.
    La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
  7. 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.

Reutilizar configuraciones creadas fuera de StyleBooks y compartir configuraciones entre ConfigPacks

A veces, es posible que haya creado configuraciones de NetScaler® fuera de Stylebooks, ya sea debido a necesidades operativas particulares o a configuraciones heredadas. Ahora puede integrar y administrar estas configuraciones preexistentes como parte de los paquetes de configuración de Stylebook, lo que permite una gestión más flexible y centralizada.
Por ejemplo, antes de esta función, si NetScaler ya está configurado con un perfil SSL, y si la operación del paquete de configuración de StyleBook intenta crear un perfil SSL con el mismo nombre, la operación del paquete de configuración habría fallado con el error "El recurso ya existe". Ahora, con esta función habilitada, la operación del paquete de configuración se realiza correctamente y el perfil SSL existente con el mismo nombre se puede reutilizar en el nuevo paquete de configuración.
Del mismo modo, también puede encontrarse con escenarios en los que se requieren recursos como la configuración de red, las políticas de seguridad o parte de las configuraciones de aplicaciones en varias aplicaciones o configuraciones. Esta función le permite compartir las configuraciones entre varios paquetes de configuración.
Para habilitar esta función, siga estos pasos:
  1. Vaya a Aplicaciones > Configuración > Stylebooks.
  2. En la página Stylebooks, seleccione el Stylebook que utilizará para crear un nuevo paquete de configuración o el asociado con el paquete de configuración que está editando.
  3. En Seleccionar acción, haga clic en Configurar ajustes. Opción Configurar ajustes
    Opción de configuración de Stylebooks
  4. Ajuste la configuración eligiendo una o ambas de las siguientes opciones:
    • Para permitir la reutilización de recursos existentes en NetScaler al crear configuraciones, seleccione la opción Permitir la reutilización de recursos existentes en NetScaler al crear configuraciones.
    • Para conservar los recursos reutilizados en NetScaler al eliminar configuraciones, seleccione la opción ¿Conservar los recursos reutilizados en NetScaler al eliminar configuraciones?. Esta opción conserva los recursos creados originalmente fuera de Stylebooks en NetScaler, incluso si se elimina el último paquete de configuración que los referencia, lo que garantiza su disponibilidad continua.
  5. Haga clic en OK.

Cambiar el StyleBook de un paquete de configuración

A veces, necesita actualizar el StyleBook para añadir funcionalidad o corregir un problema. Si ya ha creado paquetes de configuración utilizando el StyleBook antiguo, es posible que desee actualizarlos para usar el nuevo StyleBook actualizado. Para usar un nuevo StyleBook, cambie el StyleBook existente del paquete de configuración.
Considere un StyleBook de ejemplo example-lb que implementa una configuración básica de balanceador de carga en una instancia de NetScaler. Y, crea un paquete de configuración CP1 a partir de este StyleBook.
Cuando desee configurar monitores con la configuración básica del balanceador de carga, necesitará un nuevo StyleBook. Por lo tanto, cree el StyleBook example-lb-mon que incluya la capacidad de configurar monitores junto con la configuración básica del balanceador de carga.
Después de crear un StyleBook, actualice el paquete de configuración CP1 existente para añadir algunos monitores. Para ello, realice lo siguiente:
  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.
  2. Seleccione el paquete de configuración para el que desea cambiar el StyleBook.
    En este ejemplo, seleccione CP1 de la lista.
  3. Haga clic en Cambiar StyleBook.
  4. Seleccione el StyleBook requerido de la lista. Luego, haga clic en Guardar selección.
  5. Haga clic en Cambiar.
    En este ejemplo, seleccione example-lb-mon de la lista.
    Cuando cambia 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 los parámetros es similar a la del StyleBook anterior, los valores de los parámetros se conservan automáticamente en sus campos respectivos. De lo contrario, solo se transfieren los parámetros que tienen la misma estructura entre los dos StyleBooks. Por ejemplo, el mismo nombre de parámetro, tipo, padre de parámetro y más.
    Cambiar el StyleBook de un paquete de configuración
    Si se añaden nuevos parámetros obligatorios en el 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 StyleBook example-lb son los siguientes:
    Paquete de configuración de equilibrio de carga de ejemplo
    Los parámetros que aparecen en la página de configuración del nuevo StyleBook example-lb-mon son los siguientes:
    Parámetros de ejemplo después de la migración del paquete de configuración
    En este caso, los 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 solo añade los nuevos parámetros. Para los parámetros del monitor, especifique manualmente los valores requeridos.
  6. En Instancias de destino, revise las instancias seleccionadas y actualice la lista si es necesario.
  7. Haga clic en Ejecución de prueba.
    La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
  8. Haga clic en Aceptar.
    En la página StyleBook > Configuraciones, la columna Nombre de StyleBook muestra el nuevo nombre de StyleBook para el paquete de configuración seleccionado. En este caso, muestra example-lb-mon.

Cambiar el StyleBook que tiene varios paquetes de configuración

Cuando cambie un StyleBook existente que tenga varios paquetes de configuración, haga lo siguiente:
  1. Importe un nuevo StyleBook 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 para los paquetes de configuración asociados con el StyleBook existente.
    Puede seleccionar Cambiar StyleBook solo cuando los paquetes de configuración seleccionados estén asociados con el mismo StyleBook.
    Para los paquetes de configuración seleccionados, NetScaler Console 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 Configuraciones.
  3. Elimine el StyleBook antiguo de NetScaler Console 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 los StyleBooks. Con esta función, puede compartir fácilmente la configuración del StyleBook con otra NetScaler Console. Al exportar un paquete de configuración, se descarga un paquete tgz o zip en su equipo local. Este paquete incluye un archivo JSON con todos los parámetros definidos en un paquete de configuración.

Exportar configuración

Realice lo siguiente para exportar un paquete de configuración:
  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.
  2. Seleccione un paquete de configuración que desee exportar.
  3. En Seleccionar acción, seleccione Exportar configuración.
    Opción de exportar configuración
  4. En el panel Exportar configuración, especifique lo siguiente:
    • Información de la instancia de destino en la que se implementa la configuración: Seleccione esta opción para incluir la información de las instancias de destino en el paquete de exportación.
    • StyleBook asociado a la configuración: Seleccione esta opción para incluir el StyleBook en el paquete de exportación.
    • Contraseña para proteger los datos de configuración de exportación: Especifique una contraseña para cifrar el paquete de exportación. Esta contraseña protege los datos confidenciales de un paquete de configuración.
    • Tipo de archivo comprimido: 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 su equipo local.

Importar configuración

Puede importar un paquete de configuración desde su equipo local a una NetScaler Console diferente. Para importar un paquete de configuración, haga lo siguiente:
  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.
  2. Seleccione Importar configuración.
  3. Elija el paquete de archivos de importación desde su equipo.
  4. Utilice la contraseña que especificó durante la exportación.
  5. Opcional: en Opciones avanzadas, seleccione Permitir la creación de una nueva configuración solo 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.
    Considere que agregó la misma instancia de NetScaler en dos servidores de NetScaler Console. Y desea migrar un paquete de configuración de un servidor de NetScaler Console a otro. Utilice esta opción para importar un paquete de configuración sin alterar 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 contenga la información de las instancias de destino. Consulte (#export-configuration).
    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, NetScaler Console verifica lo siguiente:
  • StyleBook asociado: Si el StyleBook asociado no está en NetScaler Console, importa el StyleBook junto con el paquete de configuración.
  • Instancias de destino: Comprueba las instancias de destino e implementa la configuración en las instancias de destino especificadas. Si las instancias de NetScaler mencionadas no están presentes en NetScaler Console, el paquete de configuración se importa sin instancias de destino.
  • NetScaler Console de origen: Si está importando 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 en 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:
  1. Vaya a Aplicaciones > Configuración > Paquetes de configuración.
  2. En la página Configurations, haga clic en Add.
  3. Seleccione el Stylebook deseado y haga clic en Select.
  4. En la página Create Configuration, haga clic en Save as Draft.
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 ficha Draft Configurations en Pending Configurations.
En la ficha Draft Configurations, seleccione el paquete de configuración para realizar las siguientes operaciones:
  • Modificar la configuración de un paquete de configuración.
  • Implementar la configuración en una instancia de NetScaler.
  • Eliminar el borrador para quitar la configuración sin implementarla.
Configuraciones de borrador
También puede programar cuándo implementar los borradores guardados.
Para obtener más información, consulte Programar un paquete de configuración.

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

Cuando se crea un paquete de configuración, este se implementa automáticamente en una instancia de NetScaler de forma predeterminada. Con esta función, puede programar cuándo implementar el paquete de configuración.
Para crear una programación para un paquete de configuración:
  1. Vaya a Applications > Configuration > Config Packs.
  2. En la página Configurations, haga clic en Add.
  3. Seleccione el StyleBook y haga clic en Select.
  4. En la página Create Configuration, en Execution, seleccione Later de la lista Execution Mode.
  5. Seleccione la hora y fecha deseadas para la programación y haga clic en Submit.
Modo de ejecución
Todas las configuraciones programadas se almacenan en la pestaña Scheduled configurations en Pending Configurations. Puede seleccionar la programación creada para editarla, implementarla o cancelarla.
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:
  1. Vaya a Applications > Configuration > Config Packs.
  2. En la página Configurations, seleccione un StyleBook y haga clic en Edit.
  3. En la página Edit Configuration, edite el paquete de configuración.
  4. En la lista Modo de ejecución, seleccione Más tarde.
  5. Seleccione la hora y la fecha 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:
  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 hora y la fecha deseadas para la programación y haga clic en Enviar.

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

Para desasociar 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 desee eliminar.
  3. En Seleccionar acción, seleccione Desasociar destinos.
  4. En el panel Desasociar destinos, seleccione la instancia de destino que desea eliminar del paquete de configuración.
    Desasociar destinos
  5. Haga clic en Aceptar.
Se muestra un mensaje que confirma la creación de un paquete de configuración duplicado con la instancia de destino ahora eliminada.

Cree sus StyleBooks

El contenido completo del StyleBook example-lb se proporciona para su referencia a continuación:
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 del StyleBook example-lb-mon se proporciona para su referencia a continuación:
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