Configuration de StyleBook

Utiliser des sources de données personnalisées

Outre les instances ADC gérées en tant que source de données, vous pouvez définir et utiliser des sources de données personnalisées si les données d’entrée sont utilisées de manière répétée pour créer plusieurs configurations. Vous pouvez enregistrer les données d’entrée dans ADM en tant que source de données. De plus, vous pouvez modifier StyleBooks pour consommer ces données sans que les utilisateurs de StyleBook n’aient à fournir des entrées à plusieurs reprises.

Avant d’utiliser une source de données personnalisée dans votre définition StyleBook, procédez comme suit pour définir une source de données personnalisée :

  1. Ajoutez un type de source de données.
  2. Ajoutez une source de données.
  3. Ajoutez un type de collection.
  4. Ajoutez une collection.

Après avoir ajouté une source de données, vous pouvez l’utiliser dans la définition de StyleBook. Pour plus d’informations, voir Utiliser des sources de données personnalisées dans la définition de StyleBook.

Ajouter un type de source de données

Spécifiez un type de source de données pour distinguer la source à partir de laquelle les données sont extraites.

  1. Dans Applications > Configuration > Sources de données.

  2. Sélectionnez le type de source de données.

  3. Spécifiez le nom et la description du type de source de données.

  4. Cliquez sur Créer.

Type de source de données

Dans cet exemple, le type de source de données est défini sur Environnement. Ce type peut être utilisé pour définir les environnements d’applications en tant que sources de données.

Ajouter une source de données

Définissez une source de données pour un type de source de données spécifique.

  1. Accédez à Applications > Configuration > Sources de données.

  2. Cliquez sur Ajouter.

  3. Spécifiez le nom de la sourcede données, le type de source dedonnées et la description.

  4. Cliquez sur Créer.

Source de données personnalisée

Dans cet exemple, l’environnement de production est ajouté en tant que source de données.

Ajouter un type de collection

Ajoutez un type de collection pour décrire le type de données qui peuvent être stockées dans une collection.

  1. Accédez à Applications > Configuration > Sources de données.

  2. Sélectionnez les types de collection.

  3. Cliquez sur Ajouter.

  4. Spécifiez le nom d’un type de collection.

  5. Sélectionnez le type de source de données.

  6. Ajoutez le nom et le type de l’attribut.

  7. Cliquez sur Créer.

Type de collection

Dans cet exemple, le type de collection App-Virtual-Servers possède quatre attributs. Ainsi, la collection que vous souhaitez stocker doit avoir ces attributs des types de données définis.

Ajouter une collection

Ajoutez des collections correspondant au type de collection sélectionné.

  1. Accédez à Applications > Configuration > Sources de données.

  2. Dans Types de collection, sélectionnez le type de collection auquel vous souhaitez ajouter des collections.

  3. Spécifiez le nom d’une collection.

  4. Sélectionnez la source de données.

  5. Ajoutez des données à la collection. Vous pouvez soit ajouter des données une par une, soit télécharger un fichier CSV.

    Si vous chargez un fichier CSV, assurez-vous que les noms des colonnes correspondent aux noms d’attributs du type de collection.

  6. Cliquez sur Créer.

Collections

Utiliser une source de données personnalisée sans collecte

La parameters section suivante explique comment définir une source de données personnalisée dans la définition de StyleBook sans collecte.

parameters:
    -
      name: selected-environment
      label: Select a custom datasource environment
      type: datum
      required: true
      data-source:
        type: "Environment"
<!--NeedCopy-->

L’interface graphique du pack de configuration affiche les sources de données applicables et les utilisateurs de StyleBook peuvent sélectionner n’importe laquelle d’entre elles pour créer un pack de configuration.

Source de données personnalisée sans collecte

Dans cet exemple, il utilise la source de Production données pour récupérer des données.

Dans le type de source de Environment données, pour accéder au type de App-virtual-servers collection, utilisez l’expression suivante :

$parameters.selected-environment.collections.App-virtual-servers
<!--NeedCopy-->

Exemple de fragment :

components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    repeat: $parameters.selected-environment.collections.App-virtual-servers
    repeat-item: app
    properties:
      name: $app.attributes.Name + "-lb"
      ipv46: ip($app.attributes.IPv46 )
      port: $app.attributes.Port
      servicetype: $app.attributes.Protocol
    components:

      -
        name: servicegroup-comp
        type: ns::servicegroup
        properties:
          servicegroupname: $parent.properties.name + "-svcgrp"
          servicetype: $parent.properties.servicetype

        components:
          -
            name: lbvserver-svg-binding
            type: ns::lbvserver_servicegroup_binding
            properties:
              name: $parent.parent.properties.name
              servicegroupname: $parent.properties.servicegroupname
<!--NeedCopy-->

Utiliser des sources de données personnalisées pour la collecte

La parameters section suivante explique comment définir une source de données personnalisée dans la définition de StyleBook. Il permet aux utilisateurs de StyleBook de sélectionner un élément spécifique d’une collection.

parameters:
  -
    name: selected-app-vserver
    label: Select a collection from the datasource
    type: datum
    required: true
    data-source:
      type: Environment
      collection: App-virtual-servers
<!--NeedCopy-->

Dans cet exemple, le datum paramètre est utilisé pour définir la source de données personnalisée. Il utilise la source de Production données pour récupérer les données du type de App-virtual-servers collection.

Dans le type de source de Environment données, pour accéder au protocole depuis la App-virtual-servers collection, utilisez l’expression suivante :

$parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->

Exemple de fragment :

components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    properties:
      name: $parameters.selected-app-vserver.attributes.Name
      ipv46: $parameters.selected-app-vserver.attributes.IPv46
      port: $parameters.selected-app-vserver.attributes.Port
      servicetype: $parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->

Lorsque vous définissez un type de collection dans la parameters section, les utilisateurs de StyleBook peuvent sélectionner la source de données et la collection.

Source de données personnalisée avec collection

Utiliser des sources de données personnalisées