Composants

July 1, 2020

Contribution de: C

La construction Composants dans un StyleBook est considérée comme la section la plus importante du StyleBook. Dans cette section, vous définissez les objets de configuration qui doivent être créés. À l’aide de cette construction, vous pouvez créer un ou plusieurs objets de configuration du même type.

La construction des composants peut utiliser l’entrée fournie dans la section Paramètres pour adapter la configuration générée par le StyleBook. Il s’agit d’une section facultative, bien que la plupart des StyleBooks aient une section Composants.

Le tableau suivant décrit les principaux attributs d’un composant.

Attribut	Description
nom	Nom du composant. Vous pouvez spécifier un nom alphanumérique. Le nom doit commencer par un alphabet et peut inclure des alphabets supplémentaires, des nombres, un trait d’union (-) ou un trait de soulignement (_).
description	Description du rôle de ce composant dans le StyleBook.
type	Le type détermine les propriétés que ce composant fournit. Les composants ont deux types de types : Type intégré : Ce type est fourni par le système et vous n’avez pas à le définir, par exemple, les types d’entités NITRO « lbvserver » ou « servicegroup ». Lorsqu’un composant dispose d’un attribut type intégré, il crée un objet de configuration de ce type sur Citrix ADC. Par exemple, si un composant fait référence au type intégré « lbvserver », ce composant crée un serveur virtuel d’équilibrage de charge sur l’instance de Citrix ADC qui est la cible de la configuration. Type composite : ce type fait référence à un StyleBook existant que vous avez créé et importé dans Citrix Application Delivery Management (ADM). Lorsqu’un composant possède un attribut de type composite, il crée tous les objets de configuration, qui sont spécifiés dans le StyleBook référencé, sur l’instance Citrix ADC qui est la cible de la configuration. Cela vous permet de combiner plusieurs StyleBooks où chaque StyleBook crée une partie de la configuration finale. Pour plus d’informations sur les StyleBooks composites, reportez-vous à la section Créer un StyleBook composite.
propriétés	Sous-attributs pouvant être utilisés pour un attribut de type de composant. Les propriétés valides pour un composant sont dictées par son type. Pour un type intégré, il s’agit des propriétés ou des attributs de l’objet Nitro correspondant. Pour un composant dont le type est un autre StyleBook, c’est-à-dire un type composite, les propriétés correspondent aux paramètres définis dans ce StyleBook.

Exemple :


components:

   -

     name: my-lbvserver-comp

     type: ns::lbvserver

     properties:

        name: $parameters.name

        servicetype: HTTP

        ipv46: $parameters.ip

        port: 80

        lbmethod: $parameters.lb-alg

Dans cet exemple, vous avez défini un composant appelé my-lbvserver-comp. Ce composant est de type ns ::lbvserver (un type intégré), où « ns » est le préfixe qui fait référence à l’espace de noms netscaler.nitro.config et à la version 10.5 que vous aviez spécifiés dans la section import-stylebooks, et « lbvserver » est une ressource NITRO dans cet espace de noms.

Les propriétés de cette section incluent quatre attributs obligatoires et un attribut facultatif (lbmethod) de la ressource « lbvserver » et vous permet de spécifier des valeurs pour ces attributs. Dans cet exemple, vous spécifiez des valeurs statiques pour le type de service et le port tandis que les propriétés name, ipv46 et lbmethod obtiennent leurs valeurs à partir des paramètres d’entrée. Vous faites référence aux noms de paramètres définis dans la section paramètres en utilisant $parameters. <name>, par exemple, $parameters.ip.

Pour en savoir plus sur toutes les ressources Citrix ADC NITRO disponibles et leurs attributs/propriétés, consultez la documentation API REST NITRO Citrix ADC.

Remarque

Vous devez utiliser des minuscules pour les noms d’attributs des types de ressources NITRO (ses propriétés de composant). Sinon, l’importation d’un StyleBook échouera.

La version officielle de ce document est en anglais. Certains contenus de la documentation Citrix ont été traduits de façon automatique à des fins pratiques uniquement. Citrix n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Citrix à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Citrix, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Citrix ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Composants

July 1, 2020

Contribution de: C

Dans cet article

Éditer cette page