Crear un StyleBook compuesto
Una característica importante y potente de los StyleBooks es que pueden utilizarse como bloques de construcción para otros StyleBooks. Un StyleBook puede importarse en otro StyleBook y puede ser referido como un tipo que es utilizado por los componentes del segundo StyleBook, de forma similar a un StyleBook integrado de NITRO.
Por ejemplo, puede utilizar el StyleBook basic-lb-config que creó en la sección anterior para construir otro StyleBook llamado composite-example. Para utilizar el StyleBook "basic-lb-config", debe importarlo en el nuevo StyleBook en la sección import-stylebooks.
Cree su StyleBook
El nuevo StyleBook tendría el siguiente aspecto:
name: composite-example
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Virtual Server (HTTP/RoundRobin)
description: This StyleBook defines a RoundRobin load balancing configuration with a monitor.
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "10.5"
prefix: ns
-
namespace: com.example.stylebooks
version: "0.1"
prefix: stlb
parameters:
-
name: name
type: string
label: Application Name
description: Give a name to the application configuration.
required: true
-
name: ip
type: ipaddress
label: Application Virtual IP (VIP)
description: The Application VIP that clients access
required: true
-
name: svc-servers
type: ipaddress[]
label: Application Server IPs
description: The IP addresses of all the servers of this application
required: true
-
name: response-code
type: string[]
label: List of Response Codes
description: List of Response Codes - Provide a list of response codes in integer.
components:
-
name: basic-lb-comp
type: stlb::basic-lb-config
description: This component's type is another StyleBook that builds the NetScaler lbvserver, servicegroups and services configuration objects.
properties:
name: $parameters.name
ip: $parameters.ip
svc-servers: $parameters.svc-servers
-
name: monit-comp
type: ns::lbmonitor
description: This component is a basic Nitro type (a Builtin StyleBook) that builds the NetScaler monitor configuration object.
properties:
monitorname: $parameters.name + "-mon"
type: HTTP
respcode: $parameters.response-code
httprequest: "'GET /'"
lrtm: ENABLED
secure: "YES"
components:
-
name: monit-svcgrp-bind-comp
type: ns::servicegroup_lbmonitor_binding
properties:
servicegroupname: $components.basic-lb-comp.outputs.servicegroup-comp.properties.servicegroupname
monitor_name: $parent.properties.monitorname
En la sección import-stylebooks, importa el StyleBook basic-lb-config utilizando su espacio de nombres y versión, referidos con el prefijo
stlb.
En la sección de componentes, se definen dos componentes. El primer componente es de tipo stlb::basic-lb-config, donde "basic-lb-config" es el nombre del StyleBook que creó en StyleBook para crear una configuración básica de equilibrio de carga. Las propiedades definidas para este componente corresponden a los parámetros obligatorios declarados en el StyleBook basic-lb-config. Sin embargo, puede utilizar cualquier parámetro del StyleBook (tanto los obligatorios como los opcionales). En lugar de volver a construir un
lbvserver, un grupo de servicios y enlaces de servicio y grupo de servicios, importa el StyleBook que hace todo esto como un componente y lo utiliza para crear estos objetos de configuración en el nuevo StyleBook.
StyleBook añade un segundo componente
monit-comp que utiliza los atributos del recurso NITRO lbmonitor (un StyleBook integrado) para crear un objeto de configuración de monitor. También tiene un subcomponente monit-svcgrp-bind-comp para crear el objeto de configuración de enlace que vincula el monitor al servicegroup creado en el primer componente. Dado que el componente servicegroup creado en el StyleBook "basic-lb-config" se expone como una salida, este StyleBook puede acceder a él utilizando la expresión $components.basic-lb-comp.outputs.servicegroup-comp. Este es un ejemplo de cómo la sección de salidas puede ser utilizada por los StyleBooks importadores para tener acceso a componentes en los StyleBooks importados a los que de otro modo no habrían podido acceder.
A continuación, copie y pegue el contenido del StyleBook en un editor de texto y, a continuación, guarde el archivo como composite-example.yaml. Asegúrese de validar el contenido YAML antes de importar el archivo en NetScaler Console. Luego, impórtelo a NetScaler Console y cree una o varias configuraciones utilizando este StyleBook.
Citrix recomienda que utilice el validador YAML integrado en StyleBooks para validar e importar el contenido YAML.