Importation et synchronisation de StyleBooks à partir du référentiel GitHub

Considérez un scénario où vous utilisez des processus CI/CD pour votre développement. Ou, un scénario dans lequel vous gérez tous le code source de l’application et les objets de déploiement dans GitHub.

Dans le référentiel GitHub, vous avez peut-être créé plusieurs StyleBooks pour déployer les configurations Citrix ADC et gérer ces StyleBooks. Ces StyleBooks sont également requis dans Citrix Applications and Delivery Management (ADM). Vous pouvez désormais importer directement ces StyleBooks dans Citrix ADM. Vous n’avez pas besoin de les copier manuellement à partir de GitHub, puis de les télécharger dans Citrix ADM ou de synchroniser manuellement les fichiers dans ADM et GitHub.

Vous pouvez désormais définir un référentiel dans Citrix ADM qui représente un référentiel GitHub. Fournissez l’URL du référentiel GitHub ainsi que votre nom d’utilisateur et votre mot de passe (ou jeton d’API) créés dans GitHub. Cela signifie que seuls les utilisateurs autorisés qui ont 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 se connecte à GitHub et importe les StyleBooks trouvés dans ce référentiel. ADM valide ensuite les StyleBooks et les ajoute à la liste des StyleBooks dans Citrix ADM. StyleBooks ne sont pas ajoutés à Citrix ADM s’ils échouent à la validation. Corrigez les erreurs et validez les versions mises à jour dans votre dépôt GitHub. Plus tard, vous pouvez essayer de les importer ou de les synchroniser à nouveau dans Citrix ADM.

Remarque

  • Les fichiers StyleBooks peuvent être importés et synchronisés à partir de n’importe quelle branche d’un référentiel GitHub.

  • Vous pouvez importer et synchroniser les StyleBooks qui ont des StyleBooks dépendants qui leur sont également associés.

  • La synchronisation de StyleBooks à partir d’un référentiel GitHub doit être initiée manuellement à partir de l’interface graphique ou de l’API Citrix ADM. Autrement dit, actuellement, l’importation et la synchronisation de StyleBooks ne se produisent pas automatiquement en fonction de l’activité de validation GitHub.

Conditions préalables

  • Vous devez avoir un compte valide dans GitHub.

  • Les fichiers StyleBook doivent exister dans le dossier racine de n’importe quelle branche 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 > StyleBooks > Référentiels .

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

    • Nom. Tapez 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. Tapez l’URL du référentiel GitHub.

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

    Remarque

    Vous pouvez également fournir le jeton 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. Pour plus d’informations sur la création de jetons API pour votre référentiel GitHub, consultez la documentation GitHub pourcréation de jetons d’accès personnels.

  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 d’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 des ConfigPacks sont associés. Tout d’abord, supprimez tous les packs de configuration de ces StyleBooks. Vous pouvez ultérieurement supprimer le référentiel de Citrix ADM pour nettoyer les StyleBooks de ce référentiel.

  • 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 provenant du référentiel GitHub.

image localisée

Importation et synchronisation de StyleBooks à partir du référentiel GitHub