Importar StyleBooks personalizados
Una vez que haya creado su StyleBook, impórtelo a NetScaler Console para usarlo. NetScaler Console le permite importar un único StyleBook en formato YAML o muchos archivos StyleBook YAML como un paquete en formato .zip, .tgz o .gz. El sistema NetScaler Console valida los StyleBooks al importarlos. El StyleBook ya está listo para usarse en la creación de configuraciones.
NetScaler Console también tiene un editor YAML integrado que puede usar para redactar el contenido YAML del StyleBook. El editor YAML le permite validar sus construcciones YAML desde la propia GUI de NetScaler Console. 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 Console. El editor YAML integrado proporciona dos ventajas mientras escribe su propio StyleBook.
- Codificado por colores. El editor muestra el contenido del StyleBook analizado según las directrices de YAML. 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 detectar errores de YAML a medida que escribes y cualquier desviación se resalta inmediatamente. Esta validación le permite escribir texto que cumpla con las directrices de YAML incluso antes de importar el StyleBook en NetScaler Console.
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.
Utilice etiquetas de formato HTML en la descripción y el encabezado del StyleBook
En la definición de StyleBook, puede incluir un campo de encabezado y utilizar etiquetas de formato HTML para el texto. También puede incluir imágenes como parte del encabezado. El contenido HTML del campo de encabezado se muestra en la parte superior de la página de configuración cuando se crea o actualiza una configuración. Esta función le permite añadir infografías para el StyleBook para ayudar a entender la configuración del StyleBook. Si usa imágenes en el encabezado, asegúrese de usar el formato de imagen codificado en base64 en la etiqueta <img>.
Para utilizar imágenes en el contenido HTML, las imágenes deben estar en línea, como se muestra en el siguiente ejemplo. Puede utilizar herramientas en línea para convertir sus imágenes a su formato codificado en base64.
name: cs-example
namespace: com.example.stylebooks
version: "1.2"
display-name: Content Switching Configuration
description: Example of a very simple content switching config that creates and binds an lb to a cs
header: <img id="b64img" src="data:image/png;base64,…" />
<h3>Operations performed by this StyleBook:</h3>
<ul>
<li style="list-style-type: circle"> Creates a Server </li>
<li style="list-style-type: circle"> Creates a Service Group </li>
<li style="list-style-type: circle"> Creates a LBVServer </li>
<li style="list-style-type: circle"> Creates a CS Policy and Action </li>
</ul>
schema-version: "1.0"
<!--NeedCopy-->
Para importar su StyleBook
-
En NetScaler Console, vaya a Aplicaciones > ConfiguraciónStyleBooksy, a continuación, haga clic enImportar 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
lb-vserver.ymlStyleBook que creó en StyleBook para crear un servidor virtual de equilibrio de carga .
-
Paquete: NetScaler Console le permite importar muchos StyleBooks en formato YAML. Puede importar más de un archivo YAML StyleBook comprimidos en formato zip (.zip) o tarball (.tgz,.gz).
Un StyleBook importado a NetScaler Console se muestra con un icono predeterminado en la GUI de StyleBooks. Puede personalizar estos iconos predeterminados con sus propias imágenes.
Para ello:
- Crea una carpeta con el nombre que
resourcesse encuentra debajo de la carpeta que contiene los archivos YAML de StyleBook. - Cargue los iconos a la carpeta
resources.
Nota:
No puedes cambiar el nombre de
resourcesla carpeta por ningún otro nombre.- Si el archivo de iconos y su archivo StyleBook correspondiente tienen el mismo nombre, el icono se asigna automáticamente al StyleBook.
- Si el archivo de iconos y su archivo StyleBook correspondiente (por ejemplo, exchange.yaml y exch.png) no coinciden, cree un archivo JSON denominado “icon_mapping.json” en la carpeta
resourcesde la siguiente manera:
<StyleBook file name> : <icon file name> <StyleBook file1 name> : <icon file1 name> <StyleBook file2 name> : <icon file2 name> <!--NeedCopy-->El siguiente es un ejemplo de paquete StyleBook:
La carpeta
resourcestiene 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 un icono no está disponible en el paquete StyleBook, se muestra el icono predeterminado.
- Crea una carpeta con el nombre que
-
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 del StyleBook, haga clic en Validar contenido.
Nota:
Al redactar un 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.
Nota:
También puedes crear tu StyleBook en tu editor favorito y, a continuación, copiar y pegar el contenido en el editor YAML para validarlo e importarlo.
-
Repositoriode sincronización : si creas y mantienes tus StyleBooks en GitHub, usa esta opción para que NetScaler Console descubra StyleBooks nuevos o actualizados en tu repositorio. Seleccione el repositorio que desea sincronizar con NetScaler Console.
-
-
Opcional, seleccione un icono de un StyleBook.
En Aplicaciones > Configuración > StyleBooks, el StyleBook importado aparece con este icono.
-
Haga clic en Crear.
NetScaler Console ahora valida su StyleBook para detectar todos los errores sintácticos y semánticos de acuerdo con la gramática del StyleBook. Su StyleBook no se importa a NetScaler Console 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 de visualización que definió en la sección de encabezado del StyleBook.
Nota:
Si va a importar un paquete de archivos, NetScaler Console descomprime la carpeta comprimida y valida todos los StyleBooks. El paquete no se importa aunque un archivo de StyleBook no supere 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.
Se abre la página StyleBook y 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.
Nota:
Para agregar todas las instancias de NetScaler descubiertas recientemente en NetScaler Console a las instancias de destino, vaya a la página de StyleBooks y haga clic en el icono de actualización situado a la derecha de la página.
-
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.
Después de implementar correctamente la configuración, aparecerá un nuevo paquete de configuración en la página Configuraciones.