Application Delivery Management

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 interfaz gráfica de usuario 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 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 el StyleBook en 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 StyleBook lb-vserver.yml que creó 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 StyleBook

      Ahora puede incluir iconos en cada StyleBook del paquete. Asegúrese de tener la carpeta de recursos que contiene iconos en los formatos PNG, GIF o JPEG. Si el nombre del archivo de icono coincide con el nombre de StyleBook, los iconos se asignan automáticamente a los StyleBooks. De lo contrario, haga lo siguiente:

      1. Agregue el archivo icon_mapping.json en la carpeta de recursos.

      2. Asigne StyleBooks e iconos en el archivo icon_mapping.json de la siguiente manera:

        <StyleBook file name> : <icon file name>
        <!--NeedCopy-->
        

      El siguiente es un ejemplo de paquete StyleBook:

      Paquete StyleBook con iconos

      La carpeta resources contiene los iconos necesarios.

      Iconos en la carpeta de recursos

      En este ejemplo, los archivos sharepoint.yaml y skype.yaml se asignan automáticamente a sharepoint.jpeg y skype.png respectivamente.

      Para asignar exchange.yaml a exch.png, especifique lo siguiente en el archivo icon_mapping.json:

       {
       "exchange.yaml":"exch.png"
       }
       <!--NeedCopy-->
      

      Si especifica la entrada defaulticon, los StyleBooks se asignarán al icono predeterminado a menos que estén asignados a un icono diferente.

       defaulticon: <icon file name>
       <!--NeedCopy-->
      

      En Application > StyleBooks, los StyleBooks importados aparecen con los iconos asignados.

    • 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, consulta Cómo crear sus propios StyleBooks.

      Crear un StyleBook con el editor ADM YAML

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

      Sincronizar repositorios en ADM

    Nota

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

  3. Opcional, seleccione un icono de 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 los distintos constructos y atributos, consulte Gramática de StyleBook.

  5. Haga clic en el vínculo 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 los campos obligatorios del nombre de la aplicación y la dirección IP del equilibrador de carga.

    2. Seleccione LoadBalancing Algorithm en la lista. De forma predeterminada, se selecciona ROUNDROBIN.

      Ejemplo de implementación de configuración

  7. En Instancias de destino, seleccione la dirección IP de la instancia de Citrix ADC donde quiere 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 quiere 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

Importar StyleBooks personalizados