Configuration de StyleBook

Créer un StyleBook pour effectuer des opérations non CRUD

StyleBooks gère les configurations NetScaler en calculant les objets de configuration nécessaires sur les instances NetScaler. Ces objets sont ajoutés, mis à jour ou supprimés de l’instance chaque fois que vous créez ou mettez à jour un ConfigPack. C’est à ce moment que vous spécifiez l’« état désiré. »

Toutefois, certains objets de configuration NetScaler prennent en charge quelques opérations autres que la création, la mise à jour ou la suppression (opérations CRUD). Par exemple, un objet d’équilibrage de charge (lbvserver) ou un objet de fonctionnalité NetScaler (nsfeature) peut prendre en charge l’opération « activer » ou « désactiver ». De même, NetScaler certkeys prend en charge les opérations « lier » et « dissocier » pour lier ou dissocier un certificat à un autre certificat. Ces opérations sur des objets NetScaler sont appelées opérations non CRUD.

Cette section décrit comment effectuer des opérations non CRUD sur des objets de configuration qui les prennent en charge à l’aide de StyleBooks.

Remarque

La liaison entre les objets de configuration (par exemple, lier un certkey à un lbvserver) n’est pas une opération non CRUD car les liaisons NITRO sont représentées comme des objets de configuration à part entière. Ces objets sont créés et supprimés comme n’importe quel autre objet de configuration NetScaler.

Soutenir les opérations non CRUD

Une construction appelée meta-properties est ajoutée dans le composant au même niveau que la properties construction. L’attribut pris en charge dans cette construction est appelé action. Cet attribut peut prendre des valeurs telles que enabledisablelinkunlink, import, export, create, archive, et apply.

components:
 -
  name: my-lbvserver-comp
  type: ns::lbvserver
  meta-properties
   action: enable
  properties:
    name: $parameters.name
    servicetype: HTTP
    ipv46: $parameters.ip
    port: 80
    lbmethod: $parameters.lb-alg
<!--NeedCopy-->

Dans cet exemple, le my-lbvserver-comp composant est du type ns::lbvserver. Le « ns » est le préfixe qui fait référence à l’espace de noms netscaler.nitro.config et à la version ** 10.5 que vous avez spécifiés dans la section import-stylebooks. La lbvserver est une ressource NITRO dans cet espace de noms. En tant qu’action implicite, le StyleBook crée lbvserver puis termine l’opération « activation » sur celui-ci.

Les action méta-propriétés sont effectuées sur l’objet de configuration uniquement lors de la création du ConfigPack. Les mises à jour du ConfigPack n’effectuent aucune action autre que CRUD.

Vous pouvez spécifier des expressions pour une méta-propriété. Ces expressions appliquent dynamiquement les actions de méta-propriétés valides pour les objets NetScaler.

Exemple :

parameters:
-
    name: meta-action-lbvserver
    type: string
    default: disable
    allowed-values:
      - enable
      - disable

components:
  -
    name: c1
    type: ns::lbvserver
    meta-properties:
      action: $parameters.meta-action-lbvserver
    properties:
      name: $parameters.lbvserver
      ipv46: $parameters.ip
      port: 80
      servicetype: HTTP
<!--NeedCopy-->

Dans cet exemple, un utilisateur de StyleBook peut spécifier une action de méta-propriété valide lors de la création d’un pack de configuration.

Créer un StyleBook pour effectuer des opérations non CRUD