Catégories de StyleBook
Il existe deux catégories de StyleBook dans NetScaler® Application Delivery Management (ADM) : les StyleBooks par défaut et les StyleBooks personnalisés. Qu’il soit par défaut ou personnalisé, un StyleBook est soit un StyleBook public, soit un StyleBook privé. Dans NetScaler ADM, vous pouvez afficher tous les StyleBooks présents dans le système, quel que soit leur type ou leur statut de visibilité. Vous pouvez également afficher une représentation graphique de la manière dont les StyleBooks sont connectés les uns aux autres.
Ce document explique les différents types de StyleBooks. Il explique également les actions suivantes que vous pouvez effectuer sur les StyleBooks à partir de NetScaler ADM :
- Télécharger un StyleBook personnalisé et apporter des modifications, ou créer un StyleBook basé sur un StyleBook existant.
- Masquer les StyleBooks par défaut d’ADM.
- Supprimer un StyleBook personnalisé de NetScaler ADM.
- Ajouter des balises aux StyleBooks.
StyleBooks par défaut et personnalisés
- Les StyleBooks par défaut sont les StyleBooks fournis avec NetScaler ADM 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 d’ADM.
- Les StyleBooks personnalisés sont vos propres StyleBooks que vous avez importés dans NetScaler ADM.
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 catégorisé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 ADM.
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 ADM. Mais vous pouvez toujours afficher et visualiser ces StyleBooks sur NetScaler ADM. Pour marquer l’un de vos StyleBooks personnalisés comme privé, définissez l’attribut private dans le StyleBook sur true. Vous pouvez toujours utiliser les StyleBooks privés pour créer des packs de configuration à l’aide des API de NetScaler ADM.
Exemple de StyleBook marqué comme privé
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
Ce StyleBook définit une configuration d'équilibrage de charge simple et constitue un bloc de construction pour créer d'autres configurations d'équilibrage de charge.
schema-version: "1.0"
private: true
<!--NeedCopy-->
Afficher les StyleBooks
Le nombre de StyleBooks – par défaut et privés – augmente dans NetScaler ADM. 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 ADM, lorsque vous accédez à Applications > StyleBooks, vous pouvez afficher une liste des StyleBooks présents dans le système.
Un StyleBook public par défaut possède l’icône suivante sur son panneau :
Tandis qu’un StyleBook privé par défaut possède une icône le déclarant 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 packs 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 de StyleBooks comme blocs de construction encourage la réutilisation de modèles de configuration courants.
Un StyleBook public personnalisé possède une icône différente, comme illustré dans 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 permettant de sélectionner le type de StyleBooks à afficher. Il existe 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 les StyleBooks personnalisés
Pour télécharger les StyleBooks personnalisés depuis NetScaler ADM, accédez à Applications > StyleBooks > Configurations. Dans la liste des StyleBooks affichés dans le panneau de droite, cochez l’option pour télécharger les StyleBooks personnalisés. 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 ADM. Vous pouvez afficher leurs définitions et leurs dépendances. Pour ce faire, cliquez sur les liens Afficher la définition et Afficher les dépendances sur le panneau StyleBook.
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 ADM. 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 ADM. Sinon, cela casserait les StyleBooks existants.
Afficher les dépendances des StyleBooks
Une fonctionnalité 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. Vous pouvez étudier les StyleBooks par défaut existants dans NetScaler ADM pour apprendre comment un StyleBook peut être construit sur un autre StyleBook.
NetScaler ADM vous permet d’afficher une représentation graphique de la manière dont les StyleBooks sont connectés les uns aux autres. Cette représentation est particulièrement utile pour les StyleBooks complexes qui sont construits en utilisant d’autres StyleBooks comme blocs de construction. En examinant le graphique de dépendances, il est possible de voir les relations et les dépendances entre plusieurs StyleBooks.
Un StyleBook utilisé par d’autres StyleBooks ne peut pas être supprimé du système car cela casserait les StyleBooks existants. En utilisant l’affichage du graphique de dépendances, vous pouvez identifier quels StyleBooks empêchent la suppression d’un StyleBook.
Pour afficher les dépendances des StyleBooks
Dans NetScaler ADM, accédez à Applications > StyleBooks. La page StyleBooks affiche tous les StyleBooks disponibles pour votre utilisation dans NetScaler ADM. Faites défiler vers le bas et trouvez votre StyleBook. La vignette StyleBook affiche des liens pour créer une configuration, pour afficher la définition du StyleBook et pour afficher les dépendances du StyleBook. Cliquez sur Afficher les dépendances.
Dépendances directes
L’onglet Dépendances directes 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 évidence. Vous pouvez également cliquer sur les noms des StyleBooks pour afficher leur définition.
Dépendances inverses
L’onglet Dépendances inverses 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 certains StyleBooks peuvent utiliser le StyleBook via un autre StyleBook.
Auditer la configuration ADC par rapport au pack de configuration
Vous pouvez comparer les modifications apportées par un pack de configuration StyleBook à la configuration ADC 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 ADC.
-
Identifier les objets modifiés et supprimés sur l’ADC qui ne reflètent pas les modifications apportées par le pack de configuration.
Pour comparer les modifications du pack de configuration à la configuration des ADC, procédez comme suit.
-
Accédez à Applications > StyleBooks > Configurations.
-
Cliquez sur Audit de configuration.
La page Audit de configuration affiche les objets créés et audités.
Créer une balise pour le StyleBook
Vous pouvez ajouter des balises à n’importe quel StyleBook dans NetScaler ADM. 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 ADM.
Pour ajouter une balise au StyleBook :
-
Accédez à Applications > StyleBooks.
-
Sélectionnez Balises sur le StyleBook pour lequel 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=données_commerciales
Pour ajouter d’autres balises, cliquez sur +.
-
Cliquez sur Créer.
Pour filtrer les StyleBooks à l’aide de balises, dans la barre de recherche, cliquez sur Balises et sélectionnez la clé et la valeur dans la liste. Les StyleBooks correspondant à la balise spécifiée sont affichés.
Voici un exemple de recherche pour les 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 présentes et futures à la configuration – Cette option associe toutes les balises StyleBook à un pack de configuration. Elle s’assure également d’associer les 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.
Pour configurer un StyleBook à l’aide de commandes CLI
Si vous souhaitez configurer un StyleBook à l’aide de commandes CLI, procédez comme suit :
- Exécutez la commande
show ns runningConfigdans NetScaler. - Dans NetScaler ADM, créez une configuration à l’aide de StyleBooks par défaut, de StyleBooks d’application métier ou de StyleBooks personnalisés.
- Exécutez à nouveau la commande
show ns runningConfigdans NetScaler.
La différence entre les deux sorties affiche les commandes CLI que vous pouvez utiliser pour configurer n’importe quel StyleBook à l’aide de l’interface de ligne de commande de NetScaler.
Dans cet article
- StyleBooks par défaut et personnalisés
- StyleBooks publics et privés
- Afficher les StyleBooks
- Télécharger les StyleBooks personnalisés
- Supprimer les StyleBooks personnalisés
- Afficher les dépendances des StyleBooks
- Dépendances directes
- Dépendances inverses
- Auditer la configuration ADC par rapport au pack de configuration
- Créer une balise pour le StyleBook
- Pour configurer un StyleBook à l’aide de commandes CLI