Catégories de StyleBook
Dans NetScaler Console, il existe deux catégories de StyleBook : par défaut et personnalisées, qui peuvent être publiques ou privées. NetScaler Console vous permet de visualiser tous les StyleBooks présents dans le système et la manière dont ils sont connectés les uns aux autres.
Ce document explique les différents types de StyleBooks et les actions suivantes que vous pouvez effectuer sur les StyleBooks depuis NetScaler Console :
-
Téléchargez un StyleBook personnalisé et apportez des modifications, ou créez un StyleBook basé sur un StyleBook existant.
-
Masquez les StyleBooks par défaut de NetScaler Console.
-
Supprimez un StyleBook personnalisé de NetScaler Console.
-
Ajoutez des balises aux StyleBooks.
StyleBooks par défaut et personnalisés
-
Les StyleBooks par défaut sont les StyleBooks fournis avec NetScaler Console et ils vous permettent de créer des configurations que vous pouvez déployer sur vos instances NetScaler. Vous ne pouvez pas supprimer les StyleBooks par défaut, mais vous pouvez les masquer de l'interface graphique de NetScaler Console.
-
Les StyleBooks personnalisés sont vos propres StyleBooks que vous avez importés dans NetScaler Console.
Les StyleBooks par défaut et personnalisés peuvent être publics ou privés.
StyleBooks publics et privés
Les StyleBooks à partir desquels vous pouvez créer des packs de configuration peuvent être classés comme StyleBooks publics. C'est-à-dire qu'ils sont tous disponibles pour votre utilisation directe afin de créer des configurations à partir de l'interface graphique et des API de NetScaler Console.
Cependant, certains StyleBooks sont utilisés comme blocs de construction pour d'autres StyleBooks. Ces StyleBooks sont marqués comme privés. Les StyleBooks privés ne peuvent pas être directement utilisés pour créer des packs de configuration à partir de l'interface graphique de NetScaler Console. Mais vous pouvez toujours afficher et consulter ces StyleBooks sur NetScaler Console. Pour marquer l'un de vos StyleBooks personnalisés comme privé, définissez l'attribut privé dans le StyleBook sur true. Vous pouvez toujours utiliser des StyleBooks privés pour créer des packs de configuration à l'aide des API de NetScaler Console.
Exemple de StyleBook marqué comme privé
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true
Afficher les StyleBooks
Le nombre de StyleBooks – à la fois par défaut et privés – augmente dans NetScaler Console. Vous pourriez vouloir rechercher le StyleBook particulier auquel vous souhaitez accéder. Vous pourriez également vouloir afficher les deux types de StyleBooks séparément.
Dans NetScaler Console, lorsque vous accédez à Applications > Configuration > StyleBooks, vous pouvez afficher une liste des StyleBooks présents dans le système.
Un StyleBook public par défaut a l'icône suivante sur son panneau :
Tandis qu'un StyleBook privé par défaut a une icône qui le déclare comme un StyleBook privé :
Bien que vous puissiez afficher la définition et les dépendances d'un StyleBook privé, vous ne pouvez pas créer de pack de configuration à partir d'un StyleBook privé à l'aide de l'interface graphique. L'objectif principal d'un StyleBook privé est de l'utiliser comme bloc de construction pour un autre StyleBook. L'utilisation des StyleBooks en tant que blocs de construction encourage la réutilisation des modèles de configuration courants.
Un StyleBook public personnalisé a une icône différente, comme le montre l'image suivante :
Tandis qu'un StyleBook privé personnalisé apparaît avec cette icône :
En haut à droite de la page, vous pouvez voir une option pour sélectionner le type de StyleBooks à afficher. Il y a trois options : tous, publics ou privés. Cliquez sur l'une des options.
Vous pouvez également rechercher un StyleBook particulier en cliquant sur l'icône de recherche. Vous pouvez rechercher par nom, espace de noms et attributs de version ou une combinaison de ces options. L'opération de recherche n'est pas sensible à la casse.
Télécharger des StyleBooks personnalisés
Pour télécharger les StyleBooks personnalisés depuis NetScaler Console, accédez à Applications > Configuration > Packs de configuration. Dans la liste des StyleBooks affichés dans le panneau de droite, cochez l'option pour télécharger les StyleBooks définis par l'utilisateur. Cliquez sur Télécharger. Si le StyleBook a des StyleBooks personnalisés dépendants, vous pouvez inclure les StyleBooks dépendants dans le bundle téléchargé.
Remarque
Vous pouvez télécharger des StyleBooks personnalisés qui sont marqués comme publics ou privés.
Remarque
Vous ne pouvez pas télécharger les StyleBooks par défaut de NetScaler Console. Vous pouvez afficher leurs définitions et dépendances. Pour ce faire, cliquez sur les liens Afficher la définition et Afficher les dépendances dans le panneau StyleBook.
Mettre à jour un StyleBook personnalisé
Vous pouvez mettre à jour les définitions de StyleBook personnalisées directement depuis l'interface graphique de NetScaler Console. Ainsi, vous pouvez modifier le StyleBook sans changer sa version. Vous pouvez également mettre à jour les définitions importées d'un bundle StyleBook.
Important
Avant de mettre à jour la définition du StyleBook depuis l'interface graphique de NetScaler Console, assurez-vous que la définition du StyleBook n'a pas de StyleBooks dépendants.
Vous pouvez mettre à jour une définition de StyleBook qui contient des packs de configuration. Assurez-vous que la définition du StyleBook est rétrocompatible. Ainsi, tous les paramètres sont conservés dans le StyleBook mis à jour et les paramètres nouvellement ajoutés apparaissent comme facultatifs.
-
Accédez à Applications > Configuration > StyleBooks.
-
Sélectionnez l'onglet StyleBooks personnalisés.
-
Sélectionnez Mettre à jour la définition sur le StyleBook que vous souhaitez mettre à jour.
-
Mettez à jour la définition selon les besoins et cliquez sur Mettre à jour.

-
Actualisez la page pour voir les dernières modifications.
Supprimer les StyleBooks personnalisés
Vous pouvez également supprimer un StyleBook personnalisé en cliquant sur le bouton Supprimer. Une fenêtre contextuelle vous invite à confirmer si vous souhaitez supprimer le StyleBook de NetScaler Console. Si le StyleBook utilise d'autres StyleBooks personnalisés, vous pouvez choisir de supprimer ces StyleBooks en cochant la case.
Remarque :
Ne supprimez pas un StyleBook personnalisé s'il a des StyleBooks dépendants dans NetScaler Console. Cette action peut rompre les StyleBooks existants.
Afficher les dépendances des StyleBooks
Une caractéristique importante et puissante des StyleBooks est qu'ils peuvent être utilisés comme blocs de construction pour d'autres StyleBooks.
Vous pouvez :
-
Importer un StyleBook dans un autre StyleBook - Un StyleBook importé est déclaré comme un type et est utilisé par les composants ou les paramètres du second StyleBook. Affichez les StyleBooks par défaut existants dans NetScaler Console pour savoir comment un StyleBook peut être construit à partir d'un autre StyleBook.
-
Afficher une représentation graphique de la façon dont les StyleBooks sont connectés les uns aux autres - Cette représentation est utile pour les StyleBooks complexes qui sont construits à l'aide d'autres StyleBooks comme blocs de construction. Le graphique de dépendance vous permet de voir les relations et les dépendances entre les StyleBooks.
Remarque :
Vous ne pouvez pas supprimer un StyleBook utilisé par d'autres StyleBooks car cette action peut endommager les StyleBooks existants. Utilisez l'affichage du graphique de dépendances pour identifier les StyleBooks qui empêchent la suppression d'un StyleBook.
Pour afficher les dépendances de StyleBook
Dans NetScaler Console, accédez à Applications > Configuration > StyleBooks. La page StyleBooks affiche tous les StyleBooks disponibles pour votre utilisation dans NetScaler Console. Faites défiler vers le bas et trouvez votre StyleBook. Cliquez sur Afficher les dépendances pour afficher les StyleBooks dépendants.
Dépendances en amont
L'onglet Dépendances en amont vous permet d'afficher les différents StyleBooks par défaut que votre StyleBook utilise. Suivez les flèches pour trouver le StyleBook qu'un StyleBook utilise. Lorsque vous pointez votre souris sur l'une des flèches, la flèche et les StyleBooks connectés les uns aux autres sont mis en surbrillance. Vous pouvez également cliquer sur un StyleBook pour afficher la définition de ce StyleBook.
Dépendances en aval
L'onglet Dépendances en aval vous permet d'afficher graphiquement les StyleBooks qui utilisent votre StyleBook. Si vous suivez les flèches, vous pouvez voir que tous les StyleBooks affichés pointent vers votre StyleBook. Certains StyleBooks peuvent utiliser directement le StyleBook et d'autres StyleBooks peuvent utiliser le StyleBook via un autre StyleBook.
Auditer la configuration NetScaler par rapport aux packs de configuration
Vous pouvez comparer les modifications apportées par un pack de configuration StyleBook à la configuration NetScaler actuelle. Grâce à cette comparaison, vous pouvez effectuer les opérations suivantes :
-
Détecter la dérive de configuration entre le pack de configuration StyleBook et la configuration NetScaler.
-
Identifier tout objet modifié et supprimé sur le NetScaler qui n'affiche pas les modifications apportées par le pack de configuration.
Pour comparer les modifications du pack de configuration à la configuration de l'instance NetScaler, procédez comme suit :
-
Accédez à Applications > Configuration > Packs de configuration.
-
Cliquez sur Audit de configuration.La page Audit de configuration affiche les objets créés et audités.

Remarque :
Lors de la mise à jour d'un pack de configuration StyleBook déployé sur une instance NetScaler, il peut présenter des différences par rapport à son état déployé. Et, la mise à jour du pack de configuration échoue. Le moteur StyleBook réconcilie automatiquement ces différences et met à jour le pack de configuration.
Télécharger le bundle de support d'un pack de configuration
Le bundle de support d'un pack de configuration aide l'équipe de support technique de Citrix à visualiser, analyser et dépanner les problèmes liés au pack de configuration. Pour télécharger le bundle de support, suivez les étapes suivantes :
-
Accédez à Applications > Configuration > Packs de configuration.
-
Sélectionnez le pack de configuration pour lequel vous souhaitez télécharger le bundle de support.
-
Dans Sélectionner une action, cliquez sur Bundle de support.Vous pouvez compresser le bundle au format de fichier Zip ou TGZ.
-
Facultatif, spécifiez la phrase secrète pour chiffrer le fichier du bundle.
-
Cliquez sur Télécharger.
Créer une balise pour le StyleBook
Vous pouvez ajouter des balises à n'importe quel StyleBook dans NetScaler Console. Les balises sont des paires clé-valeur qui vous permettent de regrouper les StyleBooks selon différents critères. Vous pouvez utiliser ces balises lors de la recherche ou du filtrage des StyleBooks dans NetScaler Console.
Pour ajouter une balise au StyleBook :
-
Accédez à Applications > Configuration > StyleBooks.
-
Sélectionnez Balises sur le StyleBook auquel vous souhaitez ajouter des balises.
Vous pouvez ajouter des balises à tous les types de StyleBooks. -
Spécifiez les informations requises Clé et Valeur qui vous aident à filtrer le StyleBook.Par exemple, Clé=équipe et Valeur=bizdata
Pour ajouter d'autres balises, cliquez sur +. -
Cliquez sur Créer.
Pour filtrer les StyleBooks à l'aide de balises, cliquez sur Balises dans la barre de recherche et sélectionnez une clé et une valeur dans la liste. Les StyleBooks correspondant à la balise spécifiée sont affichés.
Voici un exemple de recherche des StyleBooks qui ont une balise où
key=team et value=bizdata :
Vous pouvez associer les balises StyleBook à son pack de configuration. Ainsi, vous pouvez rechercher les packs de configuration en utilisant les balises StyleBook elles-mêmes.
Lorsque vous créez un pack de configuration, utilisez l'une des options suivantes dans la section Association de balises :
-
Associer toutes les balises StyleBook actuelles et futures à la configuration – Cette option associe toutes les balises StyleBook à un pack de configuration. Elle garantit également l'association des nouvelles balises que vous pourriez ajouter aux StyleBooks à l'avenir.
-
Sélectionner les balises – Cette option affiche les balises du StyleBook sélectionné. Vous pouvez sélectionner les balises StyleBook requises et les associer à un pack de configuration.
Cloner un StyleBook
En tant qu'administrateurs, vous pouvez créer un duplicata d'un StyleBook, ainsi que de ses StyleBooks dépendants. Vous pouvez ensuite utiliser ce bundle pour des personnalisations telles que la mise à jour des sections
parameters et components.
Pour cloner un StyleBook :
-
Accédez à Applications > Configuration > StyleBooks.
-
Sélectionnez Cloner sur le StyleBook par défaut ou personnalisé que vous souhaitez dupliquer.

-
Dans la page Cloner un StyleBook, entrez un espace de noms et une version pour le StyleBook et les StyleBooks dépendants. Vous pouvez également choisir les espaces de noms et les versions suggérés.
Remarque :Le StyleBook cloné et ses StyleBooks dépendants doivent avoir des espaces de noms et des versions différents pour les distinguer des StyleBooks existants. Vous ne pouvez pas utiliser d'espaces de noms NetScaler Console réservés pour les StyleBooks clonés. -
Cliquez sur Cloner. Le package StyleBook cloné est importé dans NetScaler Console et apparaît sur la page StyleBooks.