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
-
En NetScaler ADM, vaya a Aplicaciones > Configuración > StyleBooksy, a continuación, haga clic en Importar un nuevo StyleBook.
-
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.ymlque había creado en StyleBook para crear un servidor virtual de equilibrio de carga.
-
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).
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:
-
Agregue el
icon_mapping.jsonarchivo en la carpeta de recursos. -
Asigne StyleBooks e iconos en el
icon_mapping.jsonarchivo de la siguiente manera:<StyleBook file name> : <icon file name> <!--NeedCopy-->
El siguiente es un ejemplo de paquete StyleBook:
La
resourcescarpeta contiene los iconos necesarios.
En este ejemplo,
sharepoint.yamlyskype.yamllos archivos se asignan automáticamente asharepoint.jpegyskype.pngrespectivamente.Para asignar
exchange.yamlaexch.png, especifique lo siguiente en elicon_mapping.jsonarchivo:{ "exchange.yaml":"exch.png" } <!--NeedCopy-->Si especifica la
defaulticonentrada, los StyleBooks se asignarán al icono predeterminado a menos que estén asignados a un icono diferente.defaulticon: <icon file name> <!--NeedCopy-->En Aplicaciones > 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 redactar 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.
-
Sincronizar repositorio: Esta opción muestra los repositorios agregados a ADM. Seleccione el repositorio que quiere sincronizar con ADM.
Nota:
También puedes copiar y pegar el contenido de un archivo YAML de StyleBook en el editor de YAML.
-
-
Opcional, seleccione un icono de un StyleBook.
En Aplicaciones > StyleBook, el StyleBook importado aparece con este icono.
-
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.
-
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.
-
Especifique los valores necesarios para los parámetros.
En el ejemplo siguiente,
-
Especifique los campos obligatorios del nombre de la aplicación y la dirección IP del equilibrador de carga.
-
Seleccione LoadBalancing Algorithm en la lista. De forma predeterminada, se selecciona ROUNDROBIN.
-
-
En Instancias de destino, seleccione la dirección IP de la instancia de NetScaler donde quiere implementar la configuración.
También puede implementar la configuración en más de un NetScaler, especificando tantas instancias de destino como sea necesario.
-
Si quiere probar en los objetos de configuración de NetScaler (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 seleccionadas.
Tras implementar la configuración correctamente, 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 NetScaler detectadas recientemente en NetScaler ADM a la lista de instancias disponibles en esta ventana.
Buscar StyleBooks personalizados
NetScaler ADM ahora le 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
-
En NetScaler ADM, vaya a Aplicaciones > Configuraciones > StyleBooks.
-
Haga clic en el icono de búsqueda situado en la parte superior derecha.
-
En la barra de búsqueda, seleccione Tipo y, a continuación, seleccione Personalizado en la sublista.
-
NetScaler ADM muestra solo los StyleBooks definidos por el usuario.