Crear y modificar un paquete de configuración
En NetScaler 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:
-
Vaya a Aplicaciones > StyleBooks > Configuraciones.
-
Haga clic en Agregar.
-
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.
-
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.
-
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.
-
Haga clic en Ejecutar en seco.
La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
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:
-
Vaya a Aplicaciones > StyleBooks > Configuraciones.
-
Seleccione el paquete de configuración para el que quiere cambiar el StyleBook.
En este ejemplo, seleccione CP1 de la lista.
-
Haga clic en Cambiar StyleBooks.
-
Seleccione el StyleBook requerido de la lista. A continuación, haga clic en Guardar selección.
-
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.
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:
Los parámetros que aparecen en la página de configuración del nuevo ejemplo-lb-mon StyleBook son los siguientes:
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.
-
En Instancias de destino, revise las instancias seleccionadas y actualice la lista si es necesario.
-
Haga clic en Ejecutar en seco.
La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
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:
-
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.
-
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.
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.
-
-
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:
-
Vaya a Aplicaciones > StyleBooks > Configuraciones.
-
Seleccione el paquete de configuración que quiera exportar.
-
En Seleccionar acción, seleccione Exportar configuración.
-
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.
-
-
Haga clic en Exportar.
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:
-
Vaya a Aplicaciones > StyleBooks > Configuraciones.
-
Seleccione Importar configuración.
-
Elija el paquete de archivos de importación desde el equipo.
-
Utilice la frase de contraseña especificada durante la exportación.
-
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. 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.
-
Haga clic en Importar.
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.
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:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración .
-
Seleccione el paquete de configuración con una instancia de destino que quiera eliminar.
-
En Seleccionar acción, seleccione Separar objetivos.
-
En el panel Separar objetivos, seleccione la instancia de destino que quiere eliminar del paquete de configuración.
-
Haga clic en Aceptar.
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-->