Citrix Application Delivery Management

Importer des StyleBooks personnalisés

Après avoir créé votre StyleBook, vous devez l’importer dans Citrix Application Delivery Management (ADM) pour l’utiliser. Citrix ADM vous permet d’importer un seul StyleBook sous forme YAML ou plusieurs fichiers YAML StyleBook sous forme de bundle sous forme de .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 graphique Citrix ADM elle-même. 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 toute déviation est mise en évidence. Vous pouvez ensuite corriger le contenu et tenter d’importer le StyleBook dans Citrix ADM. L’éditeur YAML intégré offre deux avantages lors de l’écriture de votre propre StyleBook.

  • Code couleur. L’éditeur affiche le contenu StyleBook analysé selon les directives YAML, et le codage couleur vous aide à différencier facilement entre 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. Cette validation vous permet d’écrire du texte conforme aux directives YAML avant même d’importer le StyleBook dans l’ADM.

Remarque

Actuellement, l’éditeur valide le contenu conformément aux directives YAML. Il ne valide pas l’exactitude du code et les erreurs typographiques.

Pour 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 options suivantes pour importer un StyleBook.

    • Fichier : sélectionnez le fichier requis ou l’ensemble de fichiers à partir de votre stockage local.

      Remarque

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

      Importer un fichier StyleBook

    • Bundle - 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 tarball (.tgz, .gz).

      Importer une offre groupée StyleBook

      Vous pouvez désormais inclure des icônes à chaque StyleBook de l’offre groupée. Assurez-vous d’avoir le dossier des ressources contenant des icônes au format PNG, GIF ou JPEG. Si le nom du fichier d’icônes correspond au nom de StyleBook, les icônes sont automatiquement mappées aux StyleBooks. Sinon, procédez comme suit :

      1. Ajoutez le icon_mapping.json fichier dans le dossier ressources.

      2. Mappez des StyleBooks et des icônes dans le icon_mapping.json fichier comme suit :

        <StyleBook file name> : <icon file name>
        <!--NeedCopy-->
        

      Voici un exemple de pack StyleBook :

      Pack StyleBook avec icônes

      Le resources dossier contient les icônes requises.

      Icônes dans le dossier des ressources

      Dans cet exemple, sharepoint.yaml et skype.yaml les fichiers sont automatiquement mappés à sharepoint.jpeg et skype.png respectivement.

      Pour exchange.yaml mapper à exch.png, spécifiez les éléments suivants dans le icon_mapping.json fichier :

       {
       "exchange.yaml":"exch.png"
       }
       <!--NeedCopy-->
      

      Si vous spécifiez l’ defaulticon entrée, les StyleBooks sont mappés à l’icône par défaut, à moins qu’ils ne soient mappés à une autre icône.

       defaulticon: <icon file name>
       <!--NeedCopy-->
      

      Dans Applications > StyleBooks, les StyleBooks importés apparaissent avec les icônes mappées.

    • Raw - Composez le contenu de votre StyleBook dans l’éditeur YAML.

      Vous pouvez valider le contenu du StyleBook pour vérifier les erreurs de grammaire du StyleBook. Pour valider le contenu du StyleBook, cliquez sur Valider le contenu.

      Remarque

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

      • API NITRO
      • YAML

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

      Création d'un StyleBook à l'aide de l'éditeur ADM YAML

    • Référentiel de synchronisation - Cette option répertorie les référentiels ajoutés à ADM. Sélectionnez le référentiel à synchroniser avec ADM.

      Synchroniser les référentiels dans ADM

    Remarque

    Vous pouvez également copier et coller le contenu d’un fichier YAML StyleBook dans l’éditeur YAML.

  3. Facultatif, sélectionnez une icône pour un StyleBook.

    Dans Applications > StyleBook, le StyleBook importé apparaît avec cette icône.

    Importer StyleBook avec une icône

  4. Cliquez sur Cré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 correctement importé et répertorié sur la page StyleBooks. Vous pouvez identifier le StyleBook par le nom complet que vous aviez défini dans la section d’en-tête du StyleBook.

    Exemple StyleBook

    Remarque

    Si vous importez un ensemble de fichiers, Citrix ADM décompresse le dossier zippé 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 StyleBook et la syntaxe des différentes constructions et attributs, voir Grammaire StyleBook.

  5. Cliquez sur le lien Créer une configuration pour créer des configurations à partir de ce StyleBook.

    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.

  6. Spécifiez les valeurs requises pour les paramètres.

    Dans l’exemple suivant,

    1. Spécifiez le nom de l’application et l’ adresse IP de l’équilibreur de charge.

    2. Sélectionnez l’ algorithme d’équilibrage de charge dans la liste. Par défaut, ROUNDROBIN est sélectionné.

      Exemple de déploiement de configuration

  7. Sous Instances cibles, sélectionnez l’adresse IP de l’instance Citrix ADC sur laquelle vous souhaitez déployer la configuration.

    Vous pouvez également déployer la configuration sur plus d’un Citrix ADC, en spécifiant autant d’instances cibles que nécessaire.

  8. Si vous souhaitez tester les objets de configuration Citrix ADC (NITRO) avant de déployer la configuration, cliquez sur Exécuter à sec.

    Si la configuration est valide, les objets de configuration sont créés en fonction des valeurs spécifiées.

    Dans cet exemple, le StyleBook ne crée qu’un seul objet de type lbvserver. Ce serveur d’équilibrage de charge était le seul composant défini dans cet exemple de base StyleBook.

    Plus tard, cliquez sur Créer pour déployer la configuration sur les instances Citrix ADC sélectionnées.

Une fois la configuration déployée avec succès, un nouveau pack de configuration apparaît dans 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.

Un nouveau pack de configuration

Rechercher StyleBooks personnalisés

Citrix ADM vous permet désormais de rechercher StyleBooks en fonction de leur type. Autrement dit, vous pouvez maintenant rechercher StyleBooks par défaut ou StyleBooks personnalisés. Cette option est particulièrement utile lorsque vous devez rechercher vos StyleBooks définis par l’utilisateur parmi de nombreux 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, sélectionnez Type, puis Personnalisé dans la sous-liste.

  4. Citrix ADM affiche uniquement les StyleBooks définis par l’utilisateur.

Rechercher des StyleBooks personnalisés

Importer des StyleBooks personnalisés