Componentes
La construcción Componentes de un StyleBook se considera la sección más importante del StyleBook. En esta sección, definirá 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. Se trata de una sección opcional, aunque la mayoría de los StyleBooks tienen una sección de componentes.
En la tabla siguiente se describen los principales atributos de un componente.
| Atributo | Descripción |
|---|---|
name |
El nombre del componente. Puede especificar un nombre alfanumérico. El nombre debe comenzar con un alfabeto y puede incluir alfabetos adicionales, números, guiones (-) o guiones bajos (_). |
description |
Descripción de la función de este componente en el StyleBook. |
type |
El tipo determina las propiedades que proporciona este componente. Los componentes tienen dos tipos de tipos: 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. Tipocompuesto : este tipo hace referencia a un StyleBook existente que creó e importó a NetScaler Console. Cuando un componente tiene un atributo de tipo compuesto, crea todos los objetos de configuración, que se especifican en el StyleBook al que se hace referencia, en la instancia 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 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. Al especificar expresiones para una metapropiedad, se aplican dinámicamente las acciones de metapropiedad válidas para los objetos de NetScaler. Este atributo se puede usar en un StyleBook cuando desee 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 que son 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
<!--NeedCopy-->
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 a la versión 10.5 que especificó en la sección import-stylebooks, y lbvserver es un recurso de NITRO en este espacio de nombres.
Las propiedades de esta sección incluyen cuatro atributos obligatorios y uno opcional (lbmethod) del lbvserver recurso y le permiten especificar valores para estos atributos. En este ejemplo, está especificando valores estáticos para servicetype y port, mientras que el nombre, ipv46 y lbmethod las propiedades obtienen sus valores de los parámetros de entrada. Para hacer referencia a los nombres de los parámetros definidos en la sección de parámetros, utilice la notación $parameters.\<name>, por ejemplo, $parameters.ip.
Para obtener más información sobre todos los recursos de NetScaler NITRO disponibles y sus atributos y propiedades, consulte la documentación de la API REST de NetScaler NITRO.
Nota
Debe utilizar minúsculas para los nombres de los atributos de los tipos de recursos NITRO (sus propiedades de componentes). De lo contrario, la importación de un StyleBook fallará.