Application Delivery Management

Importer des StyleBooks personnalisés

December 12, 2025

Contributeur:

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 StyleBook unique au format YAML ou plusieurs fichiers StyleBook YAML sous forme de paquet au format .zip, .tgz ou .gz. Le système NetScaler ADM valide vos StyleBooks lors de l’importation. Le StyleBook est alors 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 du StyleBook. L’éditeur YAML vous permet de valider vos constructions YAML directement depuis l’interface graphique de NetScaler ADM. Vous n’avez pas besoin d’utiliser un outil distinct pour ces vérifications de validation. Le contenu est validé par rapport aux normes YAML et toute déviation est mise 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 la rédaction de votre propre StyleBook.

Code couleur. L’éditeur affiche le contenu du StyleBook analysé conformément aux directives YAML, et le code 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 de la saisie et toute déviation est immédiatement mise en évidence. Cette validation vous permet de rédiger un texte conforme aux directives YAML avant même d’importer le StyleBook dans ADM.

Remarque

Actuellement, l’éditeur valide le contenu conformément aux directives YAML. Il ne valide pas la correction du code ni 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 paquet de fichiers depuis votre stockage local.
  
  Remarque
  
  Dans cet exemple, importez le StyleBook lb-vserver.yml que vous avez créé dans StyleBook pour créer un serveur virtuel d’équilibrage de charge.
- Paquet - NetScaler ADM vous permet d’importer plusieurs StyleBooks au format YAML. Vous pouvez importer plusieurs fichiers StyleBook YAML compressés au format zip (.zip) ou tarball (.tgz, .gz).
  
  Vous pouvez désormais inclure des icônes pour chaque StyleBook du paquet. Assurez-vous que le dossier resources contient 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 resources.
  2. Mappez les StyleBooks et les icônes dans le fichier icon_mapping.json comme suit :
    <StyleBook file name> : <icon file name> 
  Voici un exemple de paquet StyleBook :
  
  Le dossier resources contient les icônes requises.
  
  Dans cet exemple, les fichiers sharepoint.yaml et skype.yaml sont automatiquement mappés respectivement à sharepoint.jpeg et skype.png.
  
  Pour mapper exchange.yaml à exch.png, spécifiez ce qui suit dans le fichier icon_mapping.json :
```
 {
 "exchange.yaml":"exch.png"
 }
 
```
  Si vous spécifiez l’entrée defaulticon, les StyleBooks sont mappés à l’icône par défaut, sauf s’ils sont mappés à une icône différente.
```
 defaulticon: <icon file name>
 
```
  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.
  Remarque
  
  Lors de la composition d’un StyleBook, assurez-vous de connaître les concepts suivants :
  - API NITRO
  - YAML
  Pour plus d’informations sur la façon de créer vos propres StyleBooks, consultez Comment créer vos propres StyleBooks.
- 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.
Remarque

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.

Remarque

Si vous importez un paquet de fichiers, NetScaler ADM décompresse le dossier compressé et valide tous les StyleBooks. Le paquet n’est pas importé même si un seul fichier StyleBook échoue au test de validation.

Pour plus d’informations sur la grammaire StyleBook et la syntaxe des différentes constructions et attributs, consultez Grammaire StyleBook.
Cliquez sur le lien Créer une configuration pour créer des configurations à partir de ce StyleBook.

Le StyleBook s’ouvre sous la forme d’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,
1. Spécifiez les champs obligatoires Nom de l’application et Adresse IP de l’équilibreur de charge.
2. 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 Exécution à blanc.

Si la configuration est valide, les objets de configuration sont créés en fonction des valeurs spécifiées.

Dans cet exemple, le StyleBook ne crée qu’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.

Ensuite, 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 sur la page Configurations.

Remarque

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 Type, puis sélectionnez Personnalisé dans la sous-liste.
NetScaler ADM affiche uniquement les StyleBooks définis par l’utilisateur.

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group 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 Cloud Software Group à 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 Cloud Software Group, 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. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

NetScaler Secure Deployment Guide

Importer des StyleBooks personnalisés

December 12, 2025

Contributeur:

December 12, 2025

Contributeur:

NetScaler Secure Deployment Guide