Groupes StyleBook

Il existe deux groupes StyleBook dans Citrix Application Delivery Management (ADM). Il s’agit des StyleBooks par défaut et des StyleBooks personnalisés. Qu’il s’agisse d’une valeur par défaut ou personnalisée, un StyleBook est un StyleBook public ou privé. Dans Citrix 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 façon dont StyleBooks sont connectés les uns aux autres.

Ce document explique les différents types de StyleBooks. En outre, il explique les actions suivantes que vous pouvez effectuer sur les StyleBooks à partir de Citrix ADM :

  • Téléchargez un StyleBook personnalisé et apportez des modifications, ou créez un StyleBook basé sur un StyleBook existant.
  • Masquer les StyleBooks par défaut d’ADM.
  • Supprimez un StyleBook personnalisé de Citrix ADM.
  • Ajoutez des étiquettes aux StyleBooks.

StyleBooks par défaut et personnalisés

  • StyleBooks par défaut sont les StyleBooks livrés avec Citrix ADM et ils vous permettent de créer des configurations que vous pouvez déployer sur vos instances Citrix ADC. Vous ne pouvez pas supprimer StyleBooks par défaut, mais vous pouvez les masquer à partir de l’interface graphique ADM.
  • StyleBooks personnalisés sont vos propres StyleBooks que vous avez importés dans Citrix ADM.

StyleBooks par défaut et personnalisé peuvent être publics ou privés.

Livres de style publics et privés

StyleBooks à partir de laquelle vous pouvez créer des configpacks peuvent être classés en tant que StyleBooks publics. Autrement dit, ils sont tous disponibles pour votre utilisation directe pour créer des configurations à partir de l’interface graphique et des API Citrix ADM.

Mais, 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 Citrix ADM. Toutefois, vous pouvez toujours afficher et afficher ces StyleBooks sur Citrix ADM. 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 StyleBooks privés pour créer des configpacks à l’aide des API Citrix 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

Afficher StyleBooks

Le nombre de StyleBooks - par défaut et privé augmentent dans Citrix 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 Citrix ADM, lorsque vous accédez à Applications > StyleBooks, vous pouvez afficher une liste de StyleBooks présents dans le système.

Un StyleBook public par défaut a l’icône suivante sur son panneau :

image localisée

Attendu qu’un StyleBook privé par défaut a une icône qui le déclare comme un StyleBook privé :

image localisée

Bien que vous puissiez afficher la définition et les dépendances d’un StyleBook privé, vous ne pouvez pas créer un configpack à 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 des Building-Blocks-StyleBooks encourage la réutilisation des modèles de configuration courants.

Un StyleBook public personnalisé a une icône différente comme illustré dans l’image suivante :

image localisée

Alors qu’un StyleBook privé personnalisé apparaît avec cette icône :

image localisée

En haut à droite de la page, vous pouvez voir une option pour sélectionner le type de StyleBooks à afficher. Il y a trois options - toutes, publiques ou privées StyleBooks. Cliquez sur l’une des options.

image localisée

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.

image localisée

Télécharger StyleBooks personnalisés

Pour télécharger les Stylebooks personnalisés à partir de Citrix ADM, accédez à Applications > StyleBooks > Configurations. Dans la liste des StyleBooks affichés sur le panneau de droite, cochez l’option pour télécharger les StyleBooks personnalisés. Cliquez sur Download (Télécharger). Si StyleBook a des StyleBooks personnalisés dépendants, vous pouvez les inclure dans le bundle téléchargé.

Remarque

Vous pouvez télécharger StyleBooks personnalisés qui sont marqués comme publics ou privés.

image localisée

Remarque

Vous ne pouvez pas télécharger Citrix ADM StyleBooks par défaut. Vous pouvez toutefois afficher leurs définitions et dépendances en cliquant sur les liens Afficher la définition et Afficher les dépendances dans le panneau StyleBook.

Supprimer 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 Citrix ADM. Si le StyleBook utilise d’autres StyleBooks personnalisés, vous pouvez choisir de les supprimer également en cochant la case.

image localisée

image localisée

Remarque

Vous ne pouvez pas supprimer un StyleBook personnalisé qui possède d’autres StyleBooks dans Citrix ADM qui en dépendent, car cela romprait 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 Citrix ADM pour savoir comment un StyleBook peut être construit sur un autre StyleBook.

Citrix ADM vous permet d’afficher un affichage graphique de la façon dont StyleBooks sont connectés les uns aux autres. Ceci est particulièrement utile pour les StyleBooks complexes qui sont construits en utilisant d’autres StyleBooks comme blocs de construction. En regardant 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. À l’aide de l’affichage du graphique de dépendance, vous pouvez identifier les StyleBooks qui empêchent la suppression d’un StyleBook.

Pour afficher les dépendances StyleBook

Dans Citrix ADM, accédez à Applications > StyleBooks. La page StyleBooks affiche tous les StyleBooks disponibles pour votre utilisation dans Citrix ADM. Faites défiler vers le bas et trouvez votre StyleBook. Le panneau StyleBook affiche des liens permettant de créer une configuration, d’afficher la définition StyleBook et d’afficher les dépendances StyleBook. Cliquez sur Afficher les dépendances.

Dépendances de transfert

L’ onglet Dépendances de transfert vous permet d’afficher 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 mis en surbrillance. Vous pouvez également cliquer sur les noms StyleBook pour afficher la définition de ce StyleBook.

image localisée

Inverser les dépendances

L’onglet Inverser les dépendances vous permet d’afficher graphiquement les StyleBooks qui utilisent votre StyleBook. Si vous suivez les flèches, vous pouvez voir que tous les StyleBooks de l’affichage pointent vers votre StyleBook. Certains StyleBooks peuvent utiliser directement le StyleBook et certains StyleBooks peuvent utiliser le StyleBook via un autre StyleBook.

image localisée

Créer une étiquette pour le StyleBook

Vous pouvez ajouter des étiquettes à n’importe quel StyleBook dans Citrix ADM. Les étiquettes sont des paires clé-valeur qui vous permettent de regrouper StyleBooks à l’aide de critères différents. Vous pouvez utiliser ces étiquettes lors de la recherche ou du filtrage de StyleBooks dans Citrix ADM.

Pour ajouter une étiquette au StyleBook :

  1. Accédez à Applications > StyleBooks .

  2. Sélectionnez Étiquettes dans le StyleBook pour lequel vous souhaitez ajouter des étiquettes.

    Étiquettes pour un StyleBook

    Vous pouvez ajouter des étiquettes à tous les types de StyleBooks.

  3. Spécifiez les informations de clé et de valeur requises qui vous aident à filtrer le StyleBook.

    Par exemple, key=équipe et value=BizData

    Créer une étiquette pour un StyleBook

    Pour ajouter d’autres étiquettes, cliquez sur +.

  4. Cliquez sur Créer.

Pour filtrer StyleBooks à l’aide d’étiquettes, dans la barre de recherche, cliquez sur Étiquettes et sélectionnez clé et valeur dans la liste. Les StyleBooks correspondant à l’étiquette spécifiée sont affichés.

Comment utiliser les étiquettes

Voici un exemple de recherche pour les StyleBooks ayant une étiquette où key=team et value=bizdata :

Exemple pour une étiquette