Catégories de StyleBook
NetScaler Application Delivery Management (ADM) comporte deux catégories de StyleBook. Il s’agit des StyleBooks par défaut et des StyleBooks personnalisés. Qu’il s’agisse d’un livre par défaut ou personnalisé, un StyleBook est un StyleBook public ou privé. Dans NetScaler ADM, vous pouvez afficher tous les StyleBooks présents dans le système, quel que soit leur type ou leur état de visibilité. Vous pouvez également afficher un affichage graphique de la manière dont 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 depuis NetScaler ADM :
- Téléchargez un StyleBook personnalisé et apportez des modifications, ou créez un StyleBook basé sur un livre existant.
- Masquer les StyleBooks par défaut d’ADM.
- Supprimez un StyleBook personnalisé de NetScaler ADM.
- Ajoutez des balises aux StyleBooks.
StyleBooks personnalisés et par défaut
- LesStyleBooks 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 livres StyleBooks par défaut, mais vous pouvez les masquer dans l’interface graphique ADM.
- LesStyleBooks 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 classés dans la catégorie des StyleBooks publics . En d’autres termes, ils sont tous disponibles pour que vous puissiez les utiliser directement pour créer des configurations à partir de l’interface graphique et des API NetScaler ADM.
Mais certains StyleBooks sont utilisés comme blocs de construction pour d’autres StyleBooks. De tels StyleBooks sont marqués comme privés. Les StyleBooks privés ne peuvent pas être utilisés directement pour créer un pack de configuration à partir de l’interface graphique NetScaler ADM. Toutefois, vous pouvez toujours afficher et consulter 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 des StyleBooks privés pour créer des packs de configuration à l’aide des API NetScaler ADM.
Exemple d’un 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
<!--NeedCopy-->
Voir StyleBooks
Le nombre de StyleBooks, qu’ils soient par défaut ou privés, augmente dans NetScaler ADM. Vous pouvez rechercher le StyleBook particulier auquel vous souhaitez accéder. Vous pouvez également afficher les deux types de StyleBooks séparément.
Dans NetScaler ADM, lorsque vous accédez à Applications > StyleBooks, vous pouvez afficher la liste des StyleBooks présents dans le système.
Un StyleBook public par défaut possède les icônes suivantes sur son panneau :
Attendu qu’un StyleBook privé par défaut possède une icône qui le déclare en tant que StyleBook privé :
Bien que vous puissiez consulter 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. Le but principal d’un StyleBook privé est de l’utiliser comme bloc de construction pour un autre StyleBook. L’utilisation de Building-blocks-Stylebooks encourage la réutilisation des modèles de configuration courants.
Un StyleBook public personnalisé a une icône différente, comme indiqué dans l’image suivante :
Alors 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 y a trois options - toutes, publiques ou privées StyleBooks. Cliquez sur l’une des options.
Vous pouvez également rechercher un StyleBook particulier en cliquant sur l’icône de recherche. Vous pouvez effectuer une recherche 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 à partir de NetScaler ADM, accédez à Applications > StyleBooks > Configurations. Dans la liste des StyleBooks affichés dans le panneau de droite, cochez l’option permettant de télécharger les StyleBooks personnalisés. Cliquez sur Download (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 marqués comme publics ou privés.
Remarque :
Vous ne pouvez pas télécharger les StyleBooks par défaut. Vous pouvez afficher leurs définitions et dépendances. Pour ce faire, cliquez sur les liensAfficher la définitionet Afficher les dépendances dans le panneau StyleBook.
Mettre à jour le StyleBook personnalisé
Vous pouvez mettre à jour les définitions personnalisées du StyleBook à partir de l’interface graphique NetScaler ADM elle-même. Ainsi, il vous aide à apporter des modifications au StyleBook sans changer de version. Vous pouvez également mettre à jour les définitions importées depuis un bundle StyleBook.
Important :
- Avant de mettre à jour la définition de StyleBook à partir de l’interface graphique de NetScaler ADM, assurez-vous que la définition de StyleBook ne possède aucun StyleBooks dépendant.
- Vous pouvez mettre à jour une définition de StyleBook contenant des packs de configuration.
- Assurez-vous que la définition du StyleBook est rétrocompatible. Tous les paramètres du StyleBook existant sont ensuite conservés dans le StyleBook mis à jour et les paramètres ajoutés apparaissent comme facultatifs.
-
Accédez à Applications > Configuration > StyleBooks.
-
Sélectionnez l’onglet StyleBooks personnalisés.
-
Sélectionnez Mettre à jour la définition dans le StyleBook que vous souhaitez mettre à jour.
-
Mettez à jour la définition selon les besoins et cliquez sur Mettre à jour.
-
Actualisez la page pour afficher les dernières modifications.
Supprimer des 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 possède des StyleBooks dépendants dans NetScaler ADM. Sinon, il casserait les StyleBooks existants.
Afficher les dépendances StyleBook
Une caractéristique importante et puissante de 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é en tant que 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 découvrir comment un StyleBook peut être créé sur un autre StyleBook.
NetScaler ADM vous permet d’afficher un affichage 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 regardant le graphique des 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 il briserait les StyleBooks existants. À l’aide de l’affichage du graphique des dépendances, vous pouvez identifier les StyleBooks qui empêchent la suppression d’un StyleBook.
Pour afficher les dépendances de StyleBook
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 permettant de créer une configuration, d’afficher la définition de StyleBook et d’afficher les dépendances StyleBook. Cliquez sur Afficher les dépendances.
Dépendances de transfert
L’onglet Forward Dependencies vous permet de visualiser les différents StyleBooks par défaut que votre StyleBook utilise. Suivez les flèches pour trouver le StyleBook utilisé par un StyleBook. Lorsque vous pointez votre souris sur l’une des flèches, la flèche et les StyleBooks connectés les uns aux autres sont surlignés. Vous pouvez également cliquer sur les noms du StyleBook pour afficher la définition de ce StyleBook.
Inverser les dépendances
L’onglet Dépendances inversées vous permet d’afficher graphiquement les StyleBooks qui utilisent votre StyleBook. Si vous suivez les flèches, vous pouvez voir que tous les StyleBooks dans l’affichage pointent vers votre StyleBook. Certains StyleBooks utilisent directement le StyleBook et certains StyleBook peuvent l’utiliser via un autre StyleBook.
Audit de 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. Avec cette comparaison, vous pouvez effectuer les opérations suivantes :
-
Détectez la dérive de configuration entre le pack de configuration StyleBook et la configuration ADC.
-
Identifiez tous 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 aux configurations 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.
Téléchargez le pack de support d’un pack de configuration
Le pack de support d’un pack de configuration permet à l’équipe de support technique de NetScaler de visualiser, d’analyser et de résoudre les problèmes liés au pack de configuration.
-
Dans Applications > Configuration > Config Packs > Support Bundles, sélectionnez un pack de configuration. Cliquez sur Download (Télécharger).
-
Sur la page Télécharger le pack d’assistance, spécifiez :
-
Chiffrer les données de configuration à l’aide d’une phrase secrète : sélectionnez cette option si vous souhaitez spécifier une phrase secrète pour chiffrer le fichier du bundle.
-
Phrase secrète : spécifiez une phrase secrète pour chiffrer le bundle d’exportation. Cette phrase secrète sécurise les données sensibles d’un pack de configuration. La phrase secrète doit comporter au moins 20 caractères.
-
Type de fichier de compression - Vous pouvez compresser l’ensemble au format de fichier ZIP ou TGZ.
-
-
Cliquez sur Download (Télécharger).
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 des StyleBooks à l’aide de critères différents. Vous pouvez utiliser ces balises lors de la recherche ou du filtrage de StyleBooks dans NetScaler ADM.
Pour ajouter une balise au StyleBook :
-
Accédez à Applications > StyleBooks .
-
Sélectionnez Balises dans le StyleBook pour lequel vous souhaitez ajouter des balises.
Vous pouvez ajouter des balises à tous les types de StyleBooks.
-
Spécifiez les informations de clé et de valeur requises qui vous aident à filtrer le StyleBook.
Par exemple, key=Team et Value=BizData
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 Tags et sélectionnez une clé et une valeur dans la liste. Les StyleBooks qui correspondent à 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 à l’aide des balises StyleBook elles-mêmes.
Lorsque vous créez un pack de configuration, utilisez l’une des options suivantes dans la section Tag Association :
-
Associer toutes les balises StyleBook présentes et futures à la configuration — Cette option associe toutes les balises StyleBook à un pack de configuration. Il veille également à 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 des StyleBooks par défaut, des StyleBooks de l’application métier ou des 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 la CLI NetScaler.
Dans cet article
- StyleBooks personnalisés et par défaut
- StyleBooks publics et privés
- Voir StyleBooks
- Télécharger des StyleBooks personnalisés
- Mettre à jour le StyleBook personnalisé
- Supprimer des StyleBooks personnalisés
- Afficher les dépendances StyleBook
- Dépendances de transfert
- Inverser les dépendances
- Audit de la configuration ADC par rapport au pack de configuration
- Téléchargez le pack de support d’un pack de configuration
- Créer une balise pour le StyleBook
- Pour configurer un StyleBook à l’aide de commandes CLI