Application Delivery Management

Utiliser des StyleBooks personnalisés

Après avoir créé votre StyleBook, vous devez l’importer dans Citrix ADM pour l’utiliser. Citrix ADM vous permet d’importer un seul StyleBook sous forme YAML ou plusieurs fichiers StyleBook YAML sous la forme d’un bundle dans un formulaire .zip, .tgz ou .gz. Le système Citrix ADM valide vos StyleBooks lors de l’importation. Le Stylebook est maintenant prêt à être utilisé pour créer des configurations.

Citrix ADM dispose également d’un éditeur YAML intégré que vous pouvez utiliser pour composer le contenu de StyleBook YAML. L’éditeur YAML vous permet de valider vos constructions YAML à partir de l’interface utilisateur graphique Citrix ADM. Vous n’avez pas besoin d’utiliser un outil distinct pour ces vérifications de validation. Le contenu est validé par rapport aux normes YAML et tout écart est mis en évidence. Vous pouvez ensuite corriger le contenu et essayer d’importer le StyleBook dans Citrix ADM. L’éditeur YAML intégré offre deux avantages lors de la rédaction de votre propre StyleBook.

  • Code couleur. L’éditeur affiche le contenu StyleBook analysé selon les 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 toutes les erreurs YAML lorsque vous saisissez et toute déviation est immédiatement mise en surbrillance. Cela vous permet d’écrire du texte conforme aux directives YAML avant même d’importer le StyleBook dans Citrix ADM. Actuellement, l’éditeur valide le contenu conformément aux directives YAML. Il ne valide pas l’exactitude du code et les erreurs typographiques.

Importer votre StyleBook

  1. Dans Citrix ADM, accédez à Applications >  Configuration >  StyleBooks, puis cliquez sur Importer un nouveau StyleBook .

  2. Cliquez sur l’une des trois options disponibles pour importer le StyleBook.

    1. Dossier. Sélectionnez le fichier ou l’ensemble de fichiers requis dans votre espace de stockage local.

      Remarque

      Dans cet exemple, importez le StyleBook « lb-vserver.yaml » que vous avez créé dans StyleBook pour créer un serveur virtuel d’équilibrage de charge.

      Image localisée

    2. Forfait. Citrix ADM vous permet d’importer plusieurs StyleBooks au format YAML. Vous pouvez importer plusieurs fichiers YAML StyleBook compressés au format zip (.zip) ou archive (.tgz, .gz).

      Image localisée

    3. Cru. Composez le contenu de votre StyleBook dans l’éditeur YAML.

      Remarque

      Lors de la composition de StyleBook, assurez-vous de connaître les points suivants :

      • API NITRO
      • YAML

      Pour plus d’informations sur la façon d’écrire vos propres StyleBooks, consultez Comment créer vos propres StyleBooks.

      Image localisée

    Remarque

    Vous pouvez également copier et coller le contenu à partir d’un fichier YAML StyleBook pour valider le contenu.

  3. Cliquez surCréer.

    Citrix ADM valide désormais votre StyleBook pour toutes les erreurs syntaxiques et sémantiques selon la grammaire StyleBook. Votre StyleBook n’est pas importé dans Citrix ADM s’il y a des erreurs. S’il n’y a pas d’erreur, le StyleBook est importé avec succès et est maintenant répertorié sur la page StyleBooks. Vous pouvez identifier le StyleBook par le nom complet que vous avez défini dans la section d’en-tête du StyleBook.

    Remarque

    Si vous importez un ensemble de fichiers, Citrix ADM décompresse le dossier compressé et valide tous les StyleBooks. Le bundle n’est pas importé même si un fichier StyleBook échoue le test de validation.

    Pour plus d’informations sur la grammaire de StyleBook et la syntaxe des différentes constructions et attributs, consultez StyleBook Grammar.

  4. Pour créer des configurations à partir de ce StyleBook, cliquez sur le lien Créer une configuration . Le StyleBook s’ouvre en tant que page d’interface utilisateur sur laquelle vous pouvez entrer les valeurs de tous les paramètres définis dans ce StyleBook.

  5. Spécifiez les valeurs requises pour les paramètres. Dans l’exemple ci-dessous, vous pouvez voir que le nom de l’application et les champs d’ adresse IP de l’équilibreur de charge sont affichés en tant que champs obligatoires et peuvent accepter des valeurs utilisateur.  L’ algorithme LB ne comporte que deux valeurs parmi lesquelles vous pouvez choisir et, par défaut, ROUNDROBIN est sélectionné.

  6. Sous Instances cibles , cliquez et sélectionnez l’adresse IP de l’instance Citrix ADC sur laquelle vous souhaitez exécuter la configuration. Vous pouvez également déployer la configuration sur plusieurs Citrix ADC, en spécifiant autant d’instances cibles que nécessaire.

Si vous souhaitez consulter les objets de configuration Citrix ADC (Nitro) qui seraient créés sur votre Citrix ADC avant de créer la configuration, cliquez sur Exécuter à sec. Si votre configuration est valide, les objets de configuration qui seraient créés sur la base des valeurs que vous avez fournies sont affichés. Dans cet exemple, un seul objet de type lbvserver est créé par cet exemple StyleBook. Ce serveur lbvserver était le seul composant qui a été défini dans cet exemple de base StyleBook. Vous pouvez ensuite cliquer sur Créer pour créer réellement la configuration sur les instances Citrix ADC sélectionnées.

Une fois la création terminée, le nouveau ConfigPack est répertorié sur la page Configurations.

Remarque

Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter des instances Citrix ADC récemment découvertes dans Citrix ADM à la liste des instances disponibles dans cette fenêtre.

Rechercher des StyleBooks personnalisés

Citrix ADM vous permet désormais de rechercher StyleBooks en fonction de leur type. Autrement dit, vous pouvez désormais rechercher des StyleBooks par défaut ou des StyleBooks personnalisés. Cette option est particulièrement utile lorsque vous devez rechercher vos StyleBooks définis par l’utilisateur parmi un grand nombre de StyleBooks par défaut.

Pour rechercher des StyleBooks personnalisés

  1. Dans Citrix ADM, accédez à Applications > Configurations > StyleBooks.
  2. Cliquez sur l’icône de recherche en haut à droite.
  3. Dans la barre de recherche qui apparaît, sélectionnez Type dans la première liste, puis Personnalisé dans la liste d’options suivante.
  4. Citrix ADM affiche uniquement les StyleBooks définis par l’utilisateur.
Utiliser des StyleBooks personnalisés