Utiliser des sources de données personnalisées
Outre les instances NetScaler 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 à plusieurs reprises pour créer plusieurs configurations. Vous pouvez enregistrer les données d’entrée dans la console NetScaler 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 :
- Ajoutez un type de source de données.
- Ajoutez une source de données.
- Ajoutez un type de collection.
- 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.
-
Dans Applications > Configuration > Sources de données.
-
Sélectionnez le type de source de données.
-
Spécifiez le nom et la description du type de source de données.
-
Cliquez sur Créer.
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.
-
Accédez à Applications > Configuration > Sources de données.
-
Cliquez sur Ajouter.
-
Spécifiez le nom de la sourcede données, le type de source dedonnées et la description.
-
Cliquez sur Créer.
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.
-
Accédez à Applications > Configuration > Sources de données.
-
Sélectionnez les types de collection.
-
Cliquez sur Ajouter.
-
Spécifiez le nom d’un type de collection.
-
Sélectionnez le type de source de données.
-
Ajoutez le nom et le type de l’attribut.
-
Cliquez sur Créer.
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é.
-
Accédez à Applications > Configuration > Sources de données.
-
Dans Types de collection, sélectionnez le type de collection auquel vous souhaitez ajouter des collections.
-
Spécifiez le nom d’une collection.
-
Sélectionnez la source de données.
-
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.
-
Cliquez sur Créer.
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.
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 d’extraitde code :
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 d’extrait :
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.