Importer des StyleBooks personnalisés
Après avoir créé votre StyleBook, vous devez l’importer dans NetScaler Application Delivery Management (ADM) pour l’utiliser. NetScaler ADM vous permet d’importer un seul StyleBook au format YAML ou plusieurs fichiers StyleBook YAML sous forme de bundle au format .zip, .tgz ou .gz. Le système NetScaler ADM valide vos StyleBooks lors de l’importation. Le StyleBook est maintenant prêt à être utilisé pour créer des configurations.
NetScaler ADM dispose également d’un éditeur YAML intégré que vous pouvez utiliser pour composer le contenu YAML de StyleBook. L’éditeur YAML vous permet de valider vos constructions YAML à partir de l’interface graphique NetScaler ADM elle-même. Vous n’avez pas besoin d’utiliser un outil distinct pour ces contrôles de validation. Le contenu est validé par rapport aux normes YAML et tout écart est mis en évidence. Vous pouvez ensuite corriger le contenu et tenter d’importer le StyleBook dans NetScaler ADM. L’éditeur YAML intégré offre deux avantages lors de l’écriture de votre propre StyleBook.
- Code couleur. L’éditeur affiche le contenu du StyleBook analysé conformément aux directives YAML, et le codage couleur vous aide à différencier facilement les clés et les valeurs définies dans le contenu YAML.
- Validation YAML. Le contenu est validé pour toute erreur YAML au fur et à mesure que vous saisissez et tout écart est immédiatement mis en évidence. Cette validation vous permet d’écrire du texte conforme aux directives YAML avant même d’importer le StyleBook dans l’ADM.
Note
Actuellement, l’éditeur valide le contenu selon les directives YAML. Il ne valide pas l’exactitude du code et les erreurs typographiques.
Pour importer votre StyleBook
-
Dans NetScaler ADM, accédez à Applications > Configuration > StyleBooks, puis cliquez sur Importer un nouveau StyleBook.
-
Cliquez sur l’une des options suivantes pour importer un StyleBook.
- Fichier - sélectionnez le fichier requis ou le groupe de fichiers à partir de votre stockage local.
Note
Dans cet exemple, importez le
lb-vserver.ymlStyleBook que vous avez créé dans StyleBook pour créer un serveur virtuel d’équilibrage de charge.
- **Bundle** - NetScaler ADM vous permet d'importer plusieurs StyleBooks au format YAML. Vous pouvez importer plusieurs fichiers YAML StyleBook compressés au format zip (.zip) ou tarball (.tgz, .gz).
Vous pouvez désormais inclure des icônes dans chaque StyleBook du bundle. Assurez-vous d'avoir le dossier de ressources contenant des icônes aux formats PNG, GIF ou JPEG. Si le nom du fichier d'icône correspond au nom du StyleBook, les icônes sont automatiquement mappées aux StyleBooks. Sinon, procédez comme suit :
1. Ajoutez le fichier `icon_mapping.json` dans le dossier des ressources.
2. Cartographiez les StyleBooks et les icônes dans le fichier `icon_mapping.json` comme suit :
```yaml
<StyleBook file name> : <icon file name>
<!--NeedCopy--> ```
Voici un exemple de bundle StyleBook :
Le dossier `resources` contient les icônes requises.
Dans cet exemple, les fichiers `sharepoint.yaml` et `skype.yaml` sont automatiquement mappés vers `sharepoint.jpeg` et `skype.png` respectivement.
Pour mapper `exchange.yaml` à `exch.png`, spécifiez ce qui suit dans le fichier `icon_mapping.json`:
```json
{
"exchange.yaml":"exch.png" }
<!--NeedCopy--> ```
Si vous spécifiez l'entrée `defaulticon` , les StyleBooks sont mappés sur l'icône par défaut, sauf s'ils sont mappés sur une icône différente.
```yaml
icône par défaut : <icon file name>
<!--NeedCopy--> ```
Dans **Applications > StyleBooks**, les StyleBooks importés apparaissent avec les icônes mappées.
- **Brut** - Composez le contenu de votre StyleBook dans l'éditeur YAML.
Vous pouvez valider le contenu du StyleBook pour vérifier les erreurs de grammaire du StyleBook. Pour valider le contenu du StyleBook, cliquez sur **Valider le contenu**. > **Note** > > Lors de la rédaction de StyleBook, assurez-vous de connaître les concepts suivants : > > - API NITRO > - YAML
Pour plus d'informations sur la façon d'écrire vos propres StyleBooks, consultez [Comment créer vos propres StyleBooks](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/how-to-create-custom-stylebooks.html).
- **Synchroniser le référentiel** - Cette option répertorie les référentiels ajoutés à ADM. Sélectionnez le référentiel que vous souhaitez synchroniser avec ADM. > **Note** > > Vous pouvez également copier et coller le contenu d'un fichier StyleBook YAML dans l'éditeur YAML.
-
Facultatif, sélectionnez une icône pour un StyleBook.
Dans Applications > StyleBook, le StyleBook importé apparaît avec cette icône.
-
Cliquez sur Créer.
NetScaler ADM valide désormais votre StyleBook pour toutes les erreurs syntaxiques et sémantiques conformément à la grammaire StyleBook. Votre StyleBook n’est pas importé dans NetScaler ADM s’il y a des erreurs.
S’il n’y a pas d’erreurs, le StyleBook est importé avec succès et répertorié sur la page StyleBooks . Vous pouvez identifier le StyleBook par le nom d’affichage que vous avez défini dans la section d’en-tête du StyleBook.
Note
Si vous importez un ensemble de fichiers, NetScaler ADM décompresse le dossier zippé et valide tous les StyleBooks. Le bundle n’est pas importé même si un fichier StyleBook échoue au test de validation.
Pour plus d'informations sur la grammaire et la syntaxe StyleBook des différentes constructions et attributs, voir [Grammaire StyleBook](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/stylebooks-grammar.html).
-
Cliquez sur le lien Créer une configuration pour créer des configurations à partir de ce StyleBook.
Le StyleBook s’ouvre comme une page d’interface utilisateur sur laquelle vous pouvez saisir les valeurs de tous les paramètres définis dans ce StyleBook.
-
Spécifiez les valeurs requises pour les paramètres.
Dans l’exemple suivant,
-
Spécifiez les champs obligatoires nom de l’application et adresse IP de l’équilibreur de charge .
-
Sélectionnez l’algorithme d’équilibrage de charge ** dans la liste. Par défaut, **ROUNDROBIN est sélectionné.
-
-
Sous Instances cibles, sélectionnez l’adresse IP de l’instance NetScaler sur laquelle vous souhaitez déployer la configuration.
Vous pouvez également déployer la configuration sur plusieurs NetScaler, en spécifiant autant d’instances cibles que nécessaire.
-
Si vous souhaitez tester les objets de configuration NetScaler (NITRO) avant de déployer la configuration, cliquez sur Dry Run.
Si la configuration est valide, les objets de configuration sont créés en fonction des valeurs spécifiées.
Dans cet exemple, le StyleBook crée un seul objet de type
lbvserver. Ce serveur d’équilibrage de charge était le seul composant défini dans cet exemple de StyleBook de base.Plus tard, cliquez sur Créer pour déployer la configuration sur les instances NetScaler sélectionnées.
Une fois la configuration déployée avec succès, un nouveau pack de configuration apparaît dans la page Configurations .
Note
Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter les instances NetScaler récemment découvertes dans NetScaler ADM à la liste des instances disponibles dans cette fenêtre.
Rechercher des StyleBooks personnalisés
NetScaler ADM vous permet désormais de rechercher des StyleBooks en fonction de leur type. Autrement dit, vous pouvez désormais rechercher des StyleBooks par défaut ou des StyleBooks personnalisés. Cette option est particulièrement utile lorsque vous devez rechercher vos StyleBooks définis par l’utilisateur parmi de nombreux StyleBooks par défaut.
Pour rechercher des StyleBooks personnalisés
-
Dans NetScaler ADM, accédez à Applications > Configurations > StyleBooks.
-
Cliquez sur l’icône de recherche en haut à droite.
-
Dans la barre de recherche, sélectionnez Tapez puis sélectionnez Personnalisé dans la sous-liste.
-
NetScaler ADM affiche uniquement les StyleBooks définis par l’utilisateur.