Categorías de StyleBook
Hay dos categorías de StyleBook en NetScaler Application Delivery Management (ADM). Son los StyleBooks predeterminados y los StyleBooks personalizados. Ya sea predeterminado o personalizado, un StyleBook es un StyleBook público o privado. En NetScaler ADM, puede ver todos los StyleBooks presentes en el sistema, independientemente de su tipo o estado de visibilidad. También puede ver una visualización gráfica de cómo los StyleBooks están conectados entre sí.
En este documento se explican los diferentes tipos de StyleBooks. Además, explica las siguientes acciones que puede realizar en los StyleBooks de NetScaler ADM:
- Descargue un StyleBook personalizado y realice modificaciones, o cree un StyleBook basado en uno existente.
- Ocultar ADM StyleBooks predeterminados.
- Elimine un StyleBook personalizado de NetScaler ADM.
- Agregue etiquetas a los StyleBooks.
StyleBooks predeterminados y personalizados
- LosStyleBooks predeterminados son los StyleBooks que se suministran con NetScaler ADM y permiten crear configuraciones que puede implementar en las instancias de NetScaler. No puede eliminar StyleBooks predeterminados, pero puede ocultarlos de la GUI de ADM.
- LosStyleBooks personalizados son sus propios StyleBooks que importó a NetScaler ADM.
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 desde la GUI y las API de NetScaler ADM.
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 un paquete de configuración desde la GUI de NetScaler ADM. Sin embargo, aún puede mostrar y ver estos StyleBooks en NetScaler ADM. Para marcar cualquiera de sus StyleBooks personalizados como privados, establezca el atributo private en StyleBook en true. Puede seguir utilizando StyleBooks privados para crear paquetes de configuración con las API ADM 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
El número de StyleBooks: tanto los predeterminados como los privados están aumentando en NetScaler ADM. 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 ADM, al ir a Aplicaciones > StyleBooks, puede ver una lista de los StyleBooks que están presentes en el sistema.
Un StyleBook público predeterminado tiene los siguientes iconos 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 ADM, vaya a Aplicaciones > StyleBooks > Configuraciones. 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. 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 ADM. Por lo tanto, le ayuda a realizar cambios en 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 ADM, 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. Todos los parámetros del StyleBook existente se conservan en el StyleBook actualizado y los parámetros 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 quiere quitar StyleBook de NetScaler ADM. 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 ADM. De lo contrario, rompería 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 importar un StyleBook a otro StyleBook. Un StyleBook importado se declara como un tipo y es utilizado por componentes o parámetros del segundo StyleBook. Puede estudiar los StyleBooks predeterminados existentes en NetScaler ADM para saber cómo se puede crear un StyleBook encima de otro StyleBook.
NetScaler ADM le permite ver una visualización gráfica de cómo los StyleBooks están conectados entre sí. Esta representación es especialmente útil para StyleBooks complejos que se crean mediante otros StyleBooks como bloques de creación. Al mirar el gráfico de dependencia, es posible ver las relaciones y dependencias entre varios StyleBooks.
Un StyleBook utilizado por otros StyleBooks no se puede quitar del sistema porque rompería los StyleBooks existentes. Mediante la visualización del gráfico de dependencia, puede identificar qué StyleBooks están impidiendo la eliminación de un StyleBook.
Para ver las dependencias de StyleBook
En NetScaler ADM, vaya a Aplicaciones > StyleBooks. La página StyleBooks muestra todos los StyleBooks disponibles para su uso en NetScaler ADM. Desplácese hacia abajo y busque su StyleBook. El icono de StyleBook muestra vínculos para crear una configuración, ver la definición de StyleBook y ver las dependencias de StyleBook. Haga clic en Ver dependencias.
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 los nombres de StyleBook para ver la definición de ese StyleBook.
Dependencias inversas
La pestaña 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 ADC comparándola con el paquete de configuración
Puede comparar los cambios realizados por un paquete de configuración de StyleBook con la configuración actual de ADC. Con esta comparación, puede hacer lo siguiente:
-
Detecte la diferencia de configuración entre el paquete de configuración de StyleBook y la configuración de ADC.
-
Identifique los objetos modificados y eliminados del ADC que no reflejen los cambios realizados por el paquete de configuración.
Para comparar los cambios del paquete de configuración con las configuraciones de ADC, haga lo siguiente:
-
Vaya a Aplicaciones > StyleBooks > Configuraciones.
-
Haga clic en Auditoría de configuración.
La página Auditoría de configuración muestra los objetos creados y auditados.
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 NetScaler a ver, analizar y solucionar problemas del paquete de configuración.
-
En Aplicaciones > Configuración > Paquetes de configuración > Paquetes de soporte, seleccione un paquete de configuración. Haga clic en Download.
-
En la página Descargar paquete de soporte, especifique:
-
Cifrar los datos de configuración mediante una contraseña : seleccione esta opción si quiere especificar una contraseña para cifrar el archivo del paquete.
-
Contraseña: especifique una contraseña para cifrar el paquete de exportación. Esta contraseña protege los datos confidenciales de un paquete de configuración. La contraseña debe tener un mínimo de 20 caracteres.
-
Tipo de archivo comprimido: puede comprimir el paquete en formato de archivo ZIP o TGZ.
-
-
Haga clic en Download.
Crear una etiqueta para el StyleBook
Puede agregar etiquetas a cualquier StyleBook en NetScaler ADM. Las etiquetas son pares clave-valor que le permiten agrupar StyleBooks mediante diferentes criterios. Puede utilizar estas etiquetas mientras busca o filtra StyleBooks en NetScaler ADM.
Para agregar una etiqueta al StyleBook:
-
Vaya a Aplicaciones > 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 StyleBooks mediante etiquetas en la barra de búsqueda, haga clic en Etiquetas 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.
Para configurar un StyleBook mediante comandos de CLI
Si quiere configurar cualquier StyleBook mediante comandos de CLI, haga lo siguiente:
- Ejecute el comando
show ns runningConfigen NetScaler. - En NetScaler ADM, cree una configuración utilizando StyleBooks predeterminados, StyleBooks de aplicaciones empresariales o StyleBooks personalizados.
- Vuelva a ejecutar el comando
show ns runningConfigen NetScaler.
La diferencia entre las dos salidas muestra los comandos de CLI que puede utilizar para configurar cualquier StyleBook mediante la CLI de NetScaler.
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 ADC comparándola con el paquete de configuración
- Descargar el paquete de soporte de un paquete de configuración
- Crear una etiqueta para el StyleBook
- Para configurar un StyleBook mediante comandos de CLI