Categorías de StyleBook
En NetScaler Console, hay dos categorías de StyleBook: predeterminadas y personalizadas, que pueden ser públicas o privadas. NetScaler Console le permite ver todos los StyleBooks presentes en el sistema y cómo están conectados entre sí.
Este documento explica los diferentes tipos de StyleBooks y las siguientes acciones que puede realizar en los StyleBooks desde NetScaler Console:
-
Descargue un StyleBook personalizado y realice modificaciones, o cree un StyleBook basado en uno existente.
-
Oculte los StyleBooks predeterminados de NetScaler Console.
-
Elimine un StyleBook personalizado de NetScaler Console.
-
Agregue etiquetas a los StyleBooks.
StyleBooks predeterminados y personalizados
-
Los StyleBooks predeterminados son los StyleBooks que se incluyen con NetScaler Console y le permiten crear configuraciones que puede implementar en sus instancias de NetScaler. No puede eliminar los StyleBooks predeterminados, pero puede ocultarlos de la GUI de NetScaler Console.
-
Los StyleBooks personalizados son sus propios StyleBooks que importó a NetScaler Console.
Tanto los StyleBooks predeterminados como los personalizados pueden ser públicos o privados.
StyleBooks públicos y privados
Los StyleBooks a partir de los cuales puede crear paquetes de configuración se pueden clasificar como StyleBooks públicos. Es decir, todos están disponibles para su uso directo para crear configuraciones desde la GUI y las API de NetScaler Console.
Pero, algunos StyleBooks se utilizan como bloques de construcción para otros StyleBooks. Dichos StyleBooks se marcan como privados. Los StyleBooks privados no se pueden usar directamente para crear paquetes de configuración desde la GUI de NetScaler Console. Sin embargo, aún puede mostrar y ver estos StyleBooks en NetScaler Console. Para marcar cualquiera de sus StyleBooks personalizados como privado, establezca el atributo privado en el StyleBook en true. Aún puede usar StyleBooks privados para crear paquetes de configuración usando las API de NetScaler Console.
Ejemplo de un StyleBook marcado como privado
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true
Ver StyleBooks
El número de StyleBooks, tanto predeterminados como privados, está aumentando en NetScaler Console. Es posible que desee buscar el StyleBook particular al que desea acceder. También es posible que desee ver ambos tipos de StyleBooks por separado.
En NetScaler Console, cuando navega a Aplicaciones > Configuración > StyleBooks, puede ver una lista de los StyleBooks presentes en el sistema.
Un StyleBook público predeterminado tiene el siguiente icono en su panel:
Mientras que un StyleBook privado predeterminado tiene un icono que lo declara como un StyleBook privado:
Aunque puede ver la definición y las dependencias de un StyleBook privado, no puede crear un paquete de configuración a partir de un StyleBook privado utilizando la GUI. El propósito principal de un StyleBook privado es utilizarlo como un bloque de construcción para otro StyleBook. El uso de StyleBooks como bloques de construcción fomenta la reutilización de patrones de configuración comunes.
Un StyleBook público personalizado tiene un icono diferente, como se muestra en la siguiente imagen:
Mientras que un StyleBook privado personalizado aparece con este icono:
En la parte superior derecha de la página, puede ver una opción para seleccionar el tipo de StyleBooks que desea ver. Hay tres opciones: todos, públicos o privados. Haga clic en una de las opciones.
También puede buscar un StyleBook en particular haciendo clic en el icono de búsqueda. Puede buscar por nombre, espacio de nombres y atributos de versión o una combinación de estas opciones. La operación de búsqueda no distingue entre mayúsculas y minúsculas.
Descargar StyleBooks personalizados
Para descargar los StyleBooks personalizados de NetScaler Console, vaya a Applications > Configuration > Confg Packs. En la lista de StyleBooks que se muestra en el panel derecho, marque la opción para descargar los StyleBooks definidos por el usuario. Haga clic en Download. Si el StyleBook tiene StyleBooks personalizados dependientes, puede incluir los StyleBooks dependientes en el paquete descargado.
Nota
Puede descargar StyleBooks personalizados que estén marcados como públicos o privados.
Nota
No puede descargar los StyleBooks predeterminados de NetScaler Console. Puede ver sus definiciones y dependencias. Para ello, haga clic en los enlaces Ver definición y Ver dependencias en el panel de StyleBook.
Actualizar StyleBook personalizado
Puede actualizar las definiciones de StyleBook personalizados desde la propia GUI de NetScaler Console. Así, puede cambiar el StyleBook sin cambiar su versión. También puede actualizar las definiciones importadas de un paquete de StyleBook.
Importante
Antes de actualizar la definición de StyleBook desde la GUI de NetScaler Console, asegúrese de que la definición de StyleBook no tenga StyleBooks dependientes.
Puede actualizar una definición de StyleBook que tenga paquetes de configuración. Asegúrese de que la definición de StyleBook sea compatible con versiones anteriores. Así, todos los parámetros se mantienen en el StyleBook actualizado y los parámetros recién añadidos aparecen como opcionales.
-
Vaya a Applications > Configuration > StyleBooks.
-
Seleccione la pestaña StyleBooks personalizados.
-
Seleccione Actualizar definición en el StyleBook que desea actualizar.
-
Actualice la definición según sea necesario y haga clic en Actualizar.

-
Actualice la página para ver los últimos cambios.
Eliminar StyleBooks personalizados
También puede eliminar un StyleBook personalizado haciendo clic en el botón Eliminar. Una ventana emergente le pedirá que confirme si desea eliminar el StyleBook de NetScaler Console. Si el StyleBook utiliza otros StyleBooks personalizados, puede optar por eliminar dichos StyleBooks seleccionando la casilla de verificación.
Nota:
No elimine un StyleBook personalizado si tiene StyleBooks dependientes en NetScaler Console. Esta acción puede romper los StyleBooks existentes.
Ver dependencias de StyleBook
Una característica importante y potente de los StyleBooks es que se pueden utilizar como bloques de construcción para otros StyleBooks.
Puede:
-
Importar un StyleBook en otro StyleBook - Un StyleBook importado se declara como un tipo y es utilizado por los componentes o parámetros del segundo StyleBook. Vea los StyleBooks predeterminados existentes en NetScaler Console para aprender cómo se puede construir un StyleBook sobre otro StyleBook.
-
Ver una representación gráfica de cómo los StyleBooks están conectados entre sí - Esta representación es útil para StyleBooks complejos que se construyen utilizando otros StyleBooks como bloques de construcción. El gráfico de dependencias le permite ver las relaciones y dependencias entre los StyleBooks.
Nota:
No se puede eliminar un StyleBook que está siendo utilizado por otros StyleBooks porque esta acción puede romper los StyleBooks existentes. Utilice la visualización del gráfico de dependencias para identificar qué StyleBooks están impidiendo la eliminación de un StyleBook.
Para ver las dependencias de StyleBook
En NetScaler Console, vaya a Applications > Configuration > StyleBooks. La página StyleBooks muestra todos los StyleBooks disponibles para su uso en NetScaler Console. Desplácese hacia abajo y busque su StyleBook. Haga clic en Ver dependencias para ver los StyleBooks dependientes.
Dependencias directas
La pestaña Dependencias directas le permite ver los diferentes StyleBooks predeterminados que su StyleBook está utilizando. Siga las flechas para encontrar el StyleBook que está utilizando un StyleBook. Cuando apunte el ratón a una de las flechas, la flecha y los StyleBooks que están conectados entre sí se resaltan. También puede hacer clic en un StyleBook para ver la definición de ese StyleBook.
Dependencias inversas
La pestaña Dependencias inversas le permite ver gráficamente los StyleBooks que están utilizando su StyleBook. Si sigue las flechas, puede ver que todos los StyleBooks en la pantalla apuntan hacia su StyleBook. Algunos StyleBooks pueden estar utilizando el StyleBook directamente y otros StyleBooks pueden estar utilizando el StyleBook a través de otro StyleBook.
Auditar la configuración de NetScaler frente a los paquetes de configuración
Puede comparar los cambios realizados por un paquete de configuración de StyleBook con la configuración actual de NetScaler. Con esta comparación, puede hacer lo siguiente:
-
Detectar la desviación de la configuración entre el paquete de configuración de StyleBook y la configuración de NetScaler.
-
Identificar cualquier objeto modificado y eliminado en NetScaler que no muestre los cambios realizados por el paquete de configuración.
Para comparar los cambios del paquete de configuración con la configuración de la instancia de NetScaler, haga lo siguiente:
-
Vaya a Applications > Configuration > Config Packs.
-
Haga clic en Auditoría de configuración.La página Auditoría de configuración muestra los objetos creados y auditados.

Nota:
Al actualizar un paquete de configuración de StyleBook implementado en una instancia de NetScaler, puede presentar diferencias con respecto a su estado implementado. Y, falla la actualización del paquete de configuración. El motor de StyleBook concilia automáticamente estas diferencias y actualiza el paquete de configuración.
Descargar el paquete de soporte de un paquete de configuración
El paquete de soporte de un paquete de configuración ayuda al equipo de soporte técnico de Citrix a ver, analizar y solucionar problemas del paquete de configuración. Para descargar el paquete de soporte, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione el paquete de configuración del que desea descargar el paquete de soporte.
-
En Seleccionar acción, haga clic en Paquete de soporte.Puede comprimir el paquete en formato de archivo Zip o TGZ.
-
Opcional, especifique la frase de contraseña para cifrar el archivo del paquete.
-
Haga clic en Descargar.
Crear una etiqueta para el StyleBook
Puede añadir etiquetas a cualquier StyleBook en NetScaler Console. Las etiquetas son pares clave-valor que le permiten agrupar StyleBooks utilizando diferentes criterios. Puede utilizar estas etiquetas al buscar o filtrar StyleBooks en NetScaler Console.
Para añadir una etiqueta al StyleBook:
-
Vaya a Aplicaciones > Configuración > StyleBooks.
-
Seleccione Etiquetas en el StyleBook al que desea añadir etiquetas.
Puede añadir etiquetas a todos los tipos de StyleBooks. -
Especifique la información de Clave y Valor necesaria que le ayude a filtrar el StyleBook.Por ejemplo, Clave=equipo y Valor=datos_empresa
Para añadir más etiquetas, haga clic en +. -
Haga clic en Crear.
Para filtrar StyleBooks mediante etiquetas, haga clic en Etiquetas en la barra de búsqueda y seleccione una clave y un valor de la lista. Se muestran los StyleBooks que coinciden con la etiqueta especificada.
A continuación, se muestra un ejemplo de búsqueda de los StyleBooks que tienen una etiqueta donde
key=team y value=bizdata:
Puede asociar las etiquetas de StyleBook a su paquete de configuración. Así, puede buscar los paquetes de configuración utilizando las propias etiquetas de StyleBook.
Cuando cree un paquete de configuración, utilice una de las siguientes opciones en la sección Asociación de etiquetas:
-
Asociar todas las etiquetas de StyleBook presentes y futuras con la configuración: esta opción asocia todas las etiquetas de StyleBook a un paquete de configuración. También garantiza la asociación de las nuevas etiquetas que pueda añadir a los StyleBooks en el futuro.
-
Seleccionar etiquetas: esta opción muestra las etiquetas del StyleBook seleccionado. Puede seleccionar las etiquetas de StyleBook necesarias y asociarlas a un paquete de configuración.
Clonar un StyleBook
Como administradores, pueden crear un duplicado de un StyleBook, junto con sus StyleBooks dependientes. A continuación, pueden utilizar este paquete para personalizaciones como la actualización de las secciones
parameters y components.
Para clonar un StyleBook:
-
Vaya a Aplicaciones > Configuración > StyleBooks.
-
Seleccione Clonar en el StyleBook predeterminado o personalizado que desee duplicar.

-
En la página Clonar StyleBook, introduzca un espacio de nombres y una versión para el StyleBook y los StyleBooks dependientes. También puede elegir los espacios de nombres y las versiones sugeridos.
Nota:El StyleBook clonado y sus StyleBooks dependientes deben tener diferentes espacios de nombres y versiones para diferenciarlos de los StyleBooks existentes. No puede utilizar ningún espacio de nombres reservado de NetScaler Console para los StyleBooks clonados. -
Haga clic en Clonar. El paquete de StyleBook clonado se importa a NetScaler Console y aparece en la página de StyleBooks.