Application Delivery Management

Importar StyleBooks personalizados

Después de crear su StyleBook, debe importarlo a NetScaler Application Delivery Management (ADM) para usarlo. NetScaler 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 NetScaler ADM valida sus StyleBooks al importar. El StyleBook ya está listo para usarse en la creación de configuraciones.

NetScaler 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 NetScaler 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 el StyleBook a NetScaler 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 NetScaler ADM, vaya a Aplicaciones > Configuración > StyleBooksy, a continuación, haga clic en Importar un 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 : NetScaler 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 icon_mapping.json archivo en la carpeta de recursos.

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

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

      El siguiente es un ejemplo de paquete StyleBook:

      Paquete StyleBook con iconos

      La resources carpeta contiene los iconos necesarios.

      Iconos en la carpeta de recursos

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

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

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

      Si especifica la defaulticon entrada, 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 del StyleBook para comprobar los errores gramaticales del 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.

    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.

  4. Haga clic en Crear.

    NetScaler 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 NetScaler ADM si hay algún error.

    Si no hay ningún error, el StyleBook se importará correctamente y aparecerá 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.

    Nota

    Si va a importar un paquete de archivos, NetScaler 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.

  7. En Instancias de destino, seleccione la dirección IP de la instancia de NetScaler ADC donde quiere implementar la configuración.

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

  8. Si quiere probar en los objetos de configuración de NetScaler 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, el StyleBook crea solo un objeto de tipo lbvserver. Este servidor de equilibrio de carga era el único componente definido en este ejemplo básico StyleBook.

    Más tarde, haga clic en Crear para implementar la configuración en las instancias de NetScaler ADC seleccionadas.

Después de implementar correctamente la configuración, aparecerá 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.

Buscar StyleBooks personalizados

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

Para buscar StyleBooks personalizados

  1. En NetScaler 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.

Importar StyleBooks personalizados