Citrix Application Delivery Management

Importation et synchronisation de StyleBooks à partir d’un référentiel GitHub

Considérez que vous utilisez des processus CI/CD pour votre développement ou que vous gérez tous les objets de déploiement dans GitHub. Vous avez peut-être créé plusieurs StyleBooks pour déployer vos configurations Citrix ADC, et vous gérez les StyleBooks dans les référentiels GitHub. Vous pouvez désormais importer directement ces livres de style dans Citrix Applications and Delivery Management (ADM.) Vous n’avez pas besoin de les copier manuellement de GitHub et de les télécharger dans Citrix ADM.

Vous pouvez désormais définir un référentiel dans Citrix ADM qui représente un référentiel GitHub en fournissant l’URL du référentiel GitHub. Vous devez fournir votre nom d’utilisateur et votre mot de passe (ou jeton API) créés dans GitHub. Cela signifie que seuls les utilisateurs autorisés disposant d’un compte valide dans GitHub peuvent importer et synchroniser StyleBooks.

Après avoir créé le référentiel, vous pouvez synchroniser Citrix ADM avec votre référentiel GitHub. Citrix ADM importe StyleBooks trouvés dans ce référentiel puis les valide et les ajoute à la liste des StyleBooks dans Citrix ADM. Les styleBooks ne sont pas ajoutés à Citrix ADM s’ils échouent la validation. Vous devez corriger les erreurs et valider les versions mises à jour dans votre référentiel GitHub. Plus tard, vous pouvez essayer de les importer ou de les synchroniser à nouveau dans Citrix ADM.

Remarque

  • Actuellement, vous pouvez uniquement importer et synchroniser des StyleBooks qui ne sont pas associés à des StyleBooks dépendants. En d’autres termes, le StyleBook doit avoir toutes les configurations dont il doit être défini dans un seul fichier.
  • La synchronisation à partir d’un référentiel GitHub doit être initiée manuellement à partir de l’interface graphique ou de l’API Citrix ADM. C’est-à-dire, actuellement, l’importation de StyleBooks ne se produit pas automatiquement en fonction de l’activité de validation GitHub.

Vous pouvez actuellement importer des fichiers StyleBooks à partir de la branche maître uniquement.

Conditions préalables

  • Vous devez disposer d’un compte valide dans GitHub.

  • Les fichiers StyleBook doivent exister dans le dossier racine de la branche maître du référentiel GitHub.

Ajout d’un référentiel et importation de StyleBooks à partir de GitHub

  1. Dans Citrix ADM, accédez à Applications > Configurations > Référentiels.

  2. Cliquez sur Ajouter. Dans la fenêtre Ajouter un référentiel, entrez les paramètres suivants :

    • Nom. Saisissez le nom du référentiel. Ce nom peut être le même que le nom du référentiel dans GitHub ou un autre.

    • URL du référentiel. Saisissez l’URL du référentiel GitHub.

    • Nom d’utilisateur et mot de passe. Saisissez le nom d’utilisateur et le mot de passe avec lequel vous accédez au compte GitHub.

    Remarque Vous pouvez également fournir le jeton d’API à la place d’un mot de passe. Les jetons API peuvent être utilisés à la place d’un mot de passe pour GitHub sur HTTPS. Vous pouvez également les utiliser pour vous authentifier auprès de l’API via l’authentification de base.

  3. Cliquez sur Créer.

    image localisée

    Le référentiel est créé dans Citrix ADM.

  4. Pour importer ou synchroniser StyleBooks, sélectionnez le référentiel dans la page Référentiels, puis cliquez sur Synchroniser .

Les autres actions que vous pouvez utiliser ici sont :

  • Modifier. Vous pouvez modifier l’URL du référentiel, le nom d’utilisateur et le mot de passe (ou le jeton API).

  • Supprimer. Vous pouvez supprimer le référentiel ainsi que tous les StyleBooks présents dans Citrix ADM qui ont été importés précédemment à partir de ce référentiel GitHub.

    Remarque

    Vous ne pouvez pas supprimer un référentiel de Citrix ADM s’il a des StyleBooks auxquels ConfigPacks est associé.

  • Réinitialiser. Vous pouvez supprimer tous les StyleBooks dans Citrix ADM synchronisés à partir de ce référentiel sans réellement supprimer l’entrée de référentiel de Citrix ADM.

  • Liste des fichiers. Vous pouvez voir une liste de tous les StyleBooks présents dans Citrix ADM qui proviennent du référentiel GitHub.

image localisée

Importation et synchronisation de StyleBooks à partir d’un référentiel GitHub