Citrix Application Delivery Management

Grupos de StyleBook

Existen dos grupos de StyleBook en Citrix Application Delivery Management (ADM). Son los StyleBooks predeterminados y los StyleBooks personalizados. Ya sea un valor predeterminado o personalizado, un StyleBook es un StyleBook público o un StyleBook privado. En Citrix 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í.

Este documento explica los diferentes tipos de StyleBooks. Además, explica las siguientes acciones que puede realizar en los StyleBooks de Citrix ADM:

  • Descargue un StyleBook personalizado y realice modificaciones, o cree un StyleBook basado en uno existente.
  • Ocultar los StyleBooks predeterminados de ADM.
  • Elimine un StyleBook personalizado de Citrix ADM.
  • Agregue etiquetas a los StyleBooks.

StyleBooks predeterminados y personalizados

  • LosStyleBooks predeterminados son los StyleBooks enviados con Citrix ADM y permiten crear configuraciones que se pueden implementar en las instancias de Citrix ADC. No puede eliminar los StyleBooks predeterminados, pero puede ocultarlos de la GUI de ADM.
  • LosStyleBooks personalizados son sus propios StyleBooks que ha importado a Citrix ADM.

Los StyleBooks predeterminados y 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 a partir de la GUI y API de Citrix 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 utilizar directamente para crear paquetes de configuración desde la GUI de Citrix ADM. Sin embargo, aún puede mostrar y ver estos StyleBooks en Citrix ADM. 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 Citrix ADM.

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 Citrix ADM. Es posible que quiera buscar el StyleBook concreto al que quiere acceder. También es posible que quiera ver ambos tipos de StyleBooks por separado.

En Citrix ADM, cuando navega a Aplicaciones > StyleBooks, puede ver una lista de StyleBooks que están presentes en el sistema.

Un StyleBook público predeterminado tiene el siguiente icono en su panel:

StyleBookss públicos predeterminados

Mientras que un StyleBook privado predeterminado tiene un icono que lo declara como un StyleBook privado:

Icono privado

Aunque puede ver la definición y las dependencias de un StyleBook privado, no puede crear paquetes 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:

Icono público predeterminado

Mientras aparece un StyleBook privado personalizado con este icono:

Icono privado predeterminado

En la parte superior derecha de la página, puede ver una opción para seleccionar el tipo de StyleBooks que quiere ver. Hay tres opciones: Todos, públicos o privados StyleBooks. Haga clic en una de las opciones.

Filtrar StyleBooks por público y privado

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.

Buscar StyleBooks

Descargar StyleBooks personalizados

Para descargar los StyleBooks personalizados de Citrix 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.

Descargar StyleBooks

Nota

No puede descargar los StyleBooks predeterminados de Citrix ADM. 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 de StyleBook personalizadas desde la propia GUI de ADM.

  1. Vaya a Aplicaciones > Libros de estilo.

  2. Seleccione la ficha Libros de estilo personalizados.

  3. Seleccione Actualizar definición en el StyleBook que desea actualizar.

  4. Actualice la definición según sea necesario y haga clic en Actualizar.

    Actualizar StyleBook personalizado

  5. 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 Citrix ADM. Si el StyleBook utiliza otros StyleBooks personalizados, puede elegir quitar dichos StyleBooks activando la casilla de verificación.

Eliminar StyleBooks

Confirmar eliminar StyleBook

Nota

No elimine un StyleBook personalizado si tiene StyleBooks dependientes en Citrix 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 lo utilizan los componentes o parámetros del segundo StyleBook. Puede estudiar los StyleBooks predeterminados existentes en Citrix ADM para saber cómo se puede crear un StyleBook encima de otro StyleBook.

Citrix 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 Citrix ADM, vaya a Aplicaciones > StyleBooks. La página StyleBooks muestra todos los StyleBooks disponibles para su uso en Citrix ADM. Desplázate hacia abajo y encuentra tu 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.

Dependencias de reenvío

La ficha Dependencias de reenvío le permite ver los diferentes StyleBooks predeterminados que su StyleBook está utilizando. Siga las flechas para encontrar el StyleBook que está usando un StyleBook. Al apuntar con el ratón 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 de reenvío

Dependencias inversas

La ficha Dependencias inversas le permite ver gráficamente los StyleBooks que están usando su StyleBook. Si sigue las flechas, puede ver que todos los StyleBooks en la pantalla apuntan hacia su StyleBook. Algunos StyleBooks pueden estar usando el StyleBook directamente y algunos StyleBooks pueden estar usando el StyleBook a través de otro StyleBook.

Dependencias inversas

Auditar la configuración de ADC contra el paquete de configuración

Puede comparar los cambios realizados por un paquete de configuración StyleBook con la configuración ADC actual. Con esta comparación, puede hacer lo siguiente:

  • Detecte la deriva de configuración entre el paquete de configuración de StyleBook y la configuración de ADC.

  • Identifique los objetos modificados y eliminados en el ADC que no reflejen los cambios realizados por el paquete de configuración.

Para comparar los cambios del paquete de configuración con la configuración de ADCs, haga lo siguiente.

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Haga clic en Auditoría de configuración.

    La página Auditoría de Configuración muestra los objetos creados y auditados.

    Auditar la configuración de ADC contra el paquete de configuración

Crear una etiqueta para el StyleBook

Puede agregar etiquetas a cualquier StyleBook en Citrix 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 Citrix ADM.

Para agregar una etiqueta al StyleBook:

  1. Vaya a Aplicaciones > StyleBooks.

  2. Seleccione Etiquetas en el StyleBook para el que quiere agregar etiquetas.

    Etiquetas para un StyleBook

    Puede agregar etiquetas a todos los tipos de StyleBooks.

  3. Especifique la información de clave y valor necesaria que le ayude a filtrar el StyleBook.

    Por ejemplo, Key=team y Value=bizdata

    Crear una etiqueta para un StyleBook

    Para agregar más etiquetas, haga clic en +.

  4. Haga clic en Crear.

Para filtrar StyleBooks mediante etiquetas, en la barra de búsqueda, haga clic en Etiquetas y seleccione clave y valor de la lista. Se muestran los StyleBooks que coinciden con la etiqueta especificada.

Cómo usar etiquetas

A continuación se muestra un ejemplo de búsqueda de los StyleBooks que tienen una etiqueta donde key=team y value=bizdata:

Ejemplo de una etiqueta

Puede asociar las etiquetas StyleBook a su paquete de configuración. Por lo tanto, puede buscar en los paquetes de configuración mediante las propias etiquetas 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 a la configuración: Esta opción asocia todas las etiquetas 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.

Asociar etiquetas de StyleBook con su paquete de configuración