Categorías de StyleBook
En NetScaler Console, hay dos categorías de StyleBook: predeterminada y personalizada, que pueden ser públicas o privadas. NetScaler Console le permite ver todos los StyleBooks que están 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 StyleBookspredeterminados son los StyleBooks que se envían 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 StyleBookspersonalizados son sus propios StyleBooks que ha importado a NetScaler Console.
Los StyleBooks predeterminados y personalizados pueden ser públicos o privados.
StyleBooks públicos y privados
Los StyleBooks desde los que 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 a partir de la GUI y las API de NetScaler Console.
Sin embargo, algunos StyleBooks se utilizan como bloques de construcción para otros StyleBooks. Dichos StyleBooks están marcados 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 privados, establezca el atributo private en StyleBook en true. Aún puede usar StyleBooks privados para crear paquetes de configuración mediante las API de la consola de NetScaler.
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
<!--NeedCopy-->
Ver StyleBooks
La cantidad de StyleBooks, tanto predeterminados como privados, está aumentando en NetScaler Console. Puede que quiera buscar el StyleBook concreto al que quiere acceder. También es posible que quiera ver ambos tipos de StyleBooks por separado.
En NetScaler Console, cuando vaya a Aplicaciones > Configuración StyleBooks, puede ver una lista de los StyleBooks que están 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:
Si bien 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 mediante la GUI. El propósito principal de un StyleBook privado es usarlo como bloque de creación para otro StyleBook. El uso de building-blocks-StyleBooks 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 aparece un StyleBook privado personalizado con este icono:
En la parte superior derecha de la página, puede ver una opción para seleccionar el tipo de StyleBooks que deseas ver. Hay tres opciones: todos los StyleBooks, 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 Aplicaciones > Configuración Paquetes de configuración. En la lista de StyleBooks que se muestran en el panel derecho, marque la opción para descargar los StyleBooks personalizados. 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 del panel StyleBook.
Actualizar StyleBook personalizado
Puede actualizar las definiciones personalizadas de StyleBook desde la propia GUI de NetScaler Console. Por lo tanto, puede cambiar el StyleBook sin cambiar su versión. También puede actualizar las definiciones importadas desde 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. Por lo tanto, todos los parámetros se mantienen en el StyleBook actualizado y los parámetros recién agregados aparecen como opcionales.
-
Vaya a Aplicaciones > Configuración > StyleBooks.
-
Seleccione la ficha Libros de estilo personalizados.
-
Seleccione Actualizar definición en el StyleBook que quiere actualizar.
-
Actualice la definición según sea necesario y haga clic en Actualizar.
-
Actualice la página para ver los cambios más recientes.
Eliminar StyleBooks personalizados
También puede eliminar un StyleBook personalizado haciendo clic en el botón Eliminar. Una ventana emergente le pide que confirme si desea eliminar el StyleBook de NetScaler Console. Si el StyleBook usa 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 función importante y poderosa de StyleBooks es que se pueden usar como bloques de construcción para otros StyleBooks.
Puede hacer lo siguiente:
-
Importar un StyleBook a otro StyleBook : un StyleBook importado se declara como un tipo y es utilizado por los componentes o parámetros del segundo StyleBook. Consulte los StyleBooks predeterminados existentes en NetScaler Console para aprender cómo se puede crear un StyleBook sobre otro StyleBook.
-
Vea una visualización gráfica de cómo los StyleBooks están conectados entre sí : esta representación es útil para StyleBooks complejos que se crean 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 puede eliminar un StyleBook que utilizan otros StyleBooks porque esta acción puede dañar los StyleBooks existentes. Utilice la pantalla del gráfico de dependencias para identificar qué StyleBooks impiden la eliminación de un StyleBook.
Para ver las dependencias de StyleBook
En NetScaler Console, vaya a Aplicaciones > ConfiguraciónStyleBooks. 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.
Reenviar dependencias
La ficha Forward Dependencies le permite ver los diferentes StyleBooks predeterminados que utiliza su StyleBook. Siga las flechas para encontrar el StyleBook que utiliza un StyleBook. Al apuntar con el mouse a una de las flechas, se resaltan la flecha y los StyleBooks que están conectados entre sí. También puede hacer clic en un StyleBook para ver la definición de ese StyleBook.
Dependencias inversas
La ficha Dependencias inversas le permite ver gráficamente los StyleBooks que utilizan su StyleBook. Si sigue las flechas, puede ver que todos los StyleBooks en la pantalla apuntan hacia su StyleBook. Algunos StyleBooks pueden estar mediante el StyleBook directamente y algunos StyleBooks pueden estar mediante el StyleBook a través de otro StyleBook.
Audite la configuración de NetScaler comparándola con 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:
-
Detecte la desviación de configuración entre el paquete de configuración de StyleBook y la configuración de NetScaler.
-
Identifique los objetos modificados y eliminados del NetScaler que no muestren 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 Aplicaciones > Configuración > Paquetes de configuración.
-
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 que está implementado en una instancia de NetScaler, puede tener diferencias con respecto a su estado de implementación. Además, no se actualiza el paquete de configuración. El motor StyleBook reconcilia 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 los 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 en el 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.
-
Si lo quiere, especifique la contraseña para cifrar el archivo de paquete.
-
Haga clic en Download.
Crear una etiqueta para el StyleBook
Puede añadir etiquetas a cualquier StyleBook de NetScaler Console. Las etiquetas son pares clave-valor que le permiten agrupar StyleBooks mediante diferentes criterios. Puede usar estas etiquetas mientras busca o filtra StyleBooks en NetScaler Console.
Para agregar una etiqueta al StyleBook:
-
Vaya a Aplicaciones > Configuración > StyleBooks.
-
Seleccione Etiquetas en el StyleBook para el que quiere agregar etiquetas.
Puede agregar etiquetas a todos los tipos de StyleBooks.
-
Especifique la información de Key y Value necesaria que le ayude a filtrar el StyleBook.
Por ejemplo, Key=team y Value=bizdata
Para agregar más etiquetas, haga clic en +.
-
Haga clic en Crear.
Para filtrar los 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. Por lo tanto, puede buscar los paquetes de configuración utilizando las propias etiquetas de StyleBook.
Al crear un paquete de configuración, utilice una de las siguientes opciones de la sección Asociación de etiquetas :
-
Asociar todas las etiquetas de StyleBook actuales y futuras a la configuración : esta opción asocia todas las etiquetas de StyleBook a un paquete de configuración. También se asegura de asociar las nuevas etiquetas que pueda agregar 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, puede utilizar este paquete para la personalización, por ejemplo, para actualizar las components secciones parametersy.
Para clonar un StyleBook:
-
Vaya a Aplicaciones > Configuración > StyleBooks.
-
Seleccione Clonar en el StyleBook predeterminado o personalizado que desea 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 puedes 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 usar ningún espacio de nombres reservado de NetScaler Console para los StyleBooks clonados.
-
Haga clic en Clonar. El paquete StyleBook clonado se importa a NetScaler Console y aparece en la página StyleBooks.
En este artículo
- StyleBooks predeterminados y personalizados
- StyleBooks públicos y privados
- Ver StyleBooks
- Descargar StyleBooks personalizados
- Actualizar StyleBook personalizado
- Eliminar StyleBooks personalizados
- Ver dependencias de StyleBook
- Reenviar dependencias
- Dependencias inversas
- Audite la configuración de NetScaler comparándola con los paquetes de configuración
- Descargar el paquete de soporte de un paquete de configuración
- Crear una etiqueta para el StyleBook
- Clonar un StyleBook