Importar StyleBooks personalizados

Después de crear su StyleBook, debe importarlo a Citrix Application Delivery Management (ADM) para usarlo. Citrix ADM le permite importar un único StyleBook en formato YAML o varios archivos YAML de StyleBook como un paquete en un formulario.zip,.tgz o.gz. El sistema Citrix ADM valida sus StyleBooks al importar. El StyleBook ya está listo para ser utilizado para crear configuraciones.

Citrix ADM también tiene un editor YAML integrado que puede utilizar para componer el contenido YAML de StyleBook. El editor YAML le permite validar sus construcciones YAML desde la propia GUI de Citrix ADM. No es necesario utilizar una herramienta independiente para estas comprobaciones de validación. El contenido se valida según los estándares YAML y cualquier desviación se resalta. A continuación, puede corregir el contenido e intentar importar StyleBook a Citrix ADM. El editor YAML integrado proporciona dos ventajas mientras escribe su propio StyleBook.

  • Codificado por colores. El editor muestra el contenido de StyleBook analizado según las directrices de YAML, y la codificación de colores le ayuda a diferenciar fácilmente entre las claves y los valores definidos en el contenido de YAML.
  • Validación de YAML. El contenido se valida para cualquier error de YAML a medida que escribe y cualquier desviación se resalta inmediatamente. Esta validación le permite escribir texto que se ajuste a las directrices de YAML incluso antes de importar StyleBook en Citrix ADM.

Nota

Actualmente, el editor valida el contenido de acuerdo con las directrices de YAML. No valida la corrección del código y los errores tipográficos.

Para importar su StyleBook

  1. En Citrix ADM, vaya a Aplicaciones > Configuración > StyleBooks y, a continuación, haga clic en Importar nuevo StyleBook.

  2. Haga clic en una de las siguientes opciones para importar un StyleBook.

    • Archivo: Seleccione el archivo requerido o el paquete de archivos de su almacenamiento local.

      Nota

      En este ejemplo, importe el lb-vserver.yml StyleBook que ha creado en StyleBook para crear un servidor virtual de equilibrio de carga.

      Importar un archivo StyleBook

    • Paquete: Citrix ADM le permite importar varios StyleBooks en formato YAML. Puede importar más de un archivo YAML StyleBook comprimidos en formato zip (.zip) o tarball (.tgz, .gz).

      Importar un paquete de StyleBook

    • Raw: Componga el contenido de su StyleBook en el editor YAML.

      Puede validar el contenido de StyleBook para comprobar los errores gramaticales de StyleBook. Para validar el contenido de StyleBook, haga clic en Validar contenido.

      Nota

      Al componer StyleBook, asegúrese de conocer los siguientes conceptos:

      • API de NITRO
      • YAML

      Para obtener más información sobre cómo escribir sus propios StyleBooks, consulte Cómo crear tus propios StyleBooks.

      Crear un StyleBook con ADM YAML editor

    • Sincronizar repositorio: Esta opción muestra los repositorios agregados a ADM. Seleccione el repositorio que desea sincronizar con ADM.

      Sincronizar repositorios en ADM

    NotaTambién

    puede copiar y pegar el contenido de un archivo YAML StyleBook en el editor YAML.

  3. Opcional, seleccione un icono en un StyleBook.

    En Aplicaciones > StyleBook, el StyleBook importado aparece con este icono.

    Importar StyleBook con un icono

  4. Haga clic en Crear.

    Citrix ADM ahora valida su StyleBook para todos los errores sintácticos y semánticos de acuerdo con la gramática de StyleBook. Su StyleBook no se importa a Citrix ADM si hay algún error.

    Si no hay errores, el StyleBook se importa correctamente y aparece en la página StyleBooks. Puede identificar el StyleBook por el nombre para mostrar que haya definido en la sección de encabezado del StyleBook.

    Ejemplo StyleBook

    Nota

    Si va a importar un paquete de archivos, Citrix ADM descomprime la carpeta comprimida y valida todos los StyleBooks. El paquete no se importa incluso si un archivo StyleBook falla la prueba de validación.

    Para obtener más información sobre la gramática y la sintaxis de StyleBook de las distintas construcciones y atributos, consulte Gramática de StyleBook.

  5. Haga clic en el enlace Crear configuración para crear configuraciones a partir de este StyleBook.

    El StyleBook se abre como una página de interfaz de usuario en la que puede introducir los valores de todos los parámetros definidos en este StyleBook.

  6. Especifique los valores necesarios para los parámetros.

    En el ejemplo siguiente,

    1. Especifique el nombre de la aplicación y los campos** obligatorios de la dirección IP del equilibrador de **carga.

    2. Seleccione el algoritmo LoadBalancing de la lista. De forma predeterminada, ROUNDROUNDROBIN está seleccionada.

      Ejemplo de implementación de configuración

  7. En Instancias de destino, seleccione la dirección IP de la instancia de Citrix ADC en la que desea implementar la configuración.

    También puede implementar la configuración en más de un Citrix ADC, especificando tantas instancias de destino como sea necesario.

  8. Si desea probar en los objetos de configuración de Citrix ADC (NITRO) antes de implementar la configuración, haga clic en Ejecutar en seco.

    Si la configuración es válida, los objetos de configuración se crean en función de los valores especificados.

    En este ejemplo, StyleBook crea solo un objeto de tipolbvserver. Este servidor de equilibrio de carga era el único componente definido en este ejemplo básico StyleBook.

    Posteriormente, haga clic en Crear para implementar la configuración en las instancias de Citrix ADC seleccionadas.

Después de implementar correctamente la configuración, aparece un nuevo paquete de configuración en la página Configuraciones.

Nota

También puede hacer clic en el icono de actualización para agregar instancias de Citrix ADC detectadas recientemente en Citrix ADM a la lista de instancias disponibles en esta ventana.

Un nuevo paquete de configuración

Buscar StyleBooks personalizados

Citrix ADM ahora le permite buscar StyleBooks según su tipo. Es decir, ahora puede buscar StyleBooks predeterminados o StyleBooks personalizados. Esta opción es especialmente útil cuando tiene que buscar sus StyleBooks definidos por el usuario en medio de muchos StyleBooks predeterminados.

Para buscar StyleBooks personalizados

  1. En Citrix ADM, vaya a Aplicaciones > Configuraciones > StyleBooks.

  2. Haga clic en el icono de búsqueda situado en la parte superior derecha.

  3. En la barra de búsqueda, seleccione Tipo y, a continuación, seleccione Personalizado en la sublista.

  4. Citrix ADM muestra solo los StyleBooks definidos por el usuario.

Buscar StyleBooks personalizados