Importer des StyleBooks personnalisés

• 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 détecter toute erreur YAML au fur et à mesure que vous tapez, et toute déviation est immédiatement mise en évidence. Cette validation vous permet d'écrire du texte conforme aux directives YAML avant même d'importer le StyleBook dans l'ADM.

Pour importer votre StyleBook

1. Dans NetScaler ADM, accédez à Applications > Configuration > StyleBooks, puis cliquez sur Importer un nouveau StyleBook.
2. Cliquez sur l'une des options suivantes pour importer un StyleBook.
   • Fichier - sélectionnez le fichier requis ou le bundle de fichiers depuis votre stockage local.
     Remarque
     Dans cet exemple, importez le lb-vserver.yml StyleBook que vous aviez 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 de StyleBook compressés au format zip (.zip) ou tarball (.tgz, .gz).
     
     Vous pouvez maintenant inclure des icônes pour chaque StyleBook dans le bundle. Assurez-vous d'avoir le dossier de ressources qui contient les 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 de ressources.
     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 bundle StyleBook :
     
     Le dossier resources contient les icônes requises.
     
     Dans cet exemple, les fichiers sharepoint.yaml et skype.yaml sont automatiquement mappés à sharepoint.jpeg et skype.png respectivement.
     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 :
     • NITRO API
     • 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 YAML StyleBook dans l'éditeur YAML.

3. Facultatif, sélectionnez une icône pour un StyleBook.
   Dans Applications > StyleBook, le StyleBook importé apparaît avec cette icône.
4. Cliquez sur Créer.
   NetScaler ADM valide maintenant 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 ensemble de fichiers, NetScaler ADM décompresse le dossier compressé et valide tous les StyleBooks. L'ensemble 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.
5. 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.
6. 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é.
7. 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.
8. 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 ce StyleBook d'exemple de base.
   Ensuite, cliquez sur Créer pour déployer la configuration sur les instances NetScaler sélectionnées.

Rechercher des StyleBooks personnalisés