Componentes
La construcción de componentes en un StyleBook se considera la sección más importante del StyleBook. En esta sección, se definen los objetos de configuración que deben crearse. Con esta construcción, puede crear uno o varios objetos de configuración del mismo tipo.
La construcción de componentes puede utilizar la entrada proporcionada en la sección de parámetros para adaptar la configuración generada por el StyleBook. Esta es una sección opcional, aunque la mayoría de los StyleBooks tienen una sección de componentes.
La siguiente tabla describe los atributos principales de un componente.
| Atributo | Descripción |
|---|---|
name |
El nombre del componente. Puede especificar un nombre alfanumérico. El nombre debe comenzar con una letra y puede incluir letras adicionales, números, guiones (-) o guiones bajos (_). |
description |
Una descripción de la función de este componente en el StyleBook. |
type |
El tipo determina qué propiedades proporciona este componente. Los componentes tienen dos tipos de clases: Tipo integrado: Este tipo lo proporciona el sistema y no es necesario definirlo, por ejemplo, los tipos de entidad NITRO lbvserver o servicegroup. Cuando un componente tiene un atributo de tipo integrado, crea un objeto de configuración de ese tipo en NetScaler. Por ejemplo, si un componente hace referencia al tipo integrado lbvserver, este componente crea un servidor virtual de equilibrio de carga en la instancia de NetScaler que es el destino de la configuración. Tipo compuesto: Este tipo hace referencia a un StyleBook existente que creó e importó en NetScaler Console. Cuando un componente tiene un atributo de tipo compuesto, crea todos los objetos de configuración, que se especifican en el StyleBook referenciado, en la instancia de NetScaler que es el destino de la configuración. Esto le permite combinar varios StyleBooks donde cada StyleBook crea una parte de la configuración final. Para obtener más información sobre los StyleBooks compuestos, consulte Crear un StyleBook compuesto. |
meta-properties |
Las metapropiedades definen las acciones que se deben realizar en los objetos de NetScaler. Puede tomar valores estáticos o dinámicos como una acción de metapropiedad válida. Cuando se especifican expresiones para una metapropiedad, aplica dinámicamente las acciones de metapropiedad válidas para los objetos de NetScaler. Este atributo se puede usar en un StyleBook cuando se desean realizar operaciones que no sean CRUD en objetos de NetScaler. Para obtener más información, consulte Crear un StyleBook para realizar operaciones que no sean CRUD. |
properties |
Los subatributos que se pueden usar para un atributo de tipo de componente. Las propiedades válidas para un componente están dictadas por su tipo. Para un tipo integrado, estas son las propiedades o atributos del objeto NITRO correspondiente. Para un componente cuyo tipo es otro StyleBook, es decir, un tipo compuesto, las propiedades corresponden a los parámetros definidos en ese StyleBook. |
Ejemplo:
components:
-
name: my-lbvserver-comp
type: ns::lbvserver
properties:
name: $parameters.name
servicetype: HTTP
ipv46: $parameters.ip
port: 80
lbmethod: $parameters.lb-alg
En este ejemplo, ha definido un componente llamado
my-lbvserver-comp. Este componente es del tipo ns::lbvserver (un tipo integrado), donde "ns" es el prefijo que hace referencia al espacio de nombres netscaler.nitro.config y la versión 10.5 que especificó en la sección import-stylebooks, y lbvserver es un recurso NITRO en este espacio de nombres.
Las propiedades de esta sección incluyen cuatro atributos obligatorios y uno opcional (
lbmethod) del recurso lbvserver y le permiten especificar valores para estos atributos. En este ejemplo, está especificando valores estáticos para servicetype y el puerto, mientras que las propiedades de nombre, ipv46 y lbmethod obtienen sus valores de los parámetros de entrada. Se hace referencia a los nombres de los parámetros definidos en la sección de parámetros mediante la notación $parameters.\<name>, por ejemplo, $parameters.ip.
Para obtener más información sobre todos los recursos NITRO de NetScaler disponibles y sus atributos/propiedades, consulte la documentación de NetScaler NITRO REST API.
Nota
Debe usar minúsculas para los nombres de los atributos de los tipos de recursos NITRO (sus propiedades de componente). De lo contrario, la importación de un StyleBook fallará.