Importer et synchroniser les StyleBooks à partir du référentiel GitHub
Envisagez un scénario dans lequel 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 NetScaler 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 NetScaler ADM. Vous n’avez pas besoin de les copier manuellement depuis GitHub, puis de les charger dans NetScaler ADM ou de synchroniser manuellement les fichiers dans ADM et GitHub.
Vous pouvez désormais définir un référentiel dans NetScaler 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 disposant d’un compte valide dans GitHub peuvent importer et synchroniser les StyleBooks.
Après avoir créé le référentiel, vous pouvez synchroniser NetScaler ADM avec votre référentiel GitHub. NetScaler 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 NetScaler ADM. Les StyleBooks ne sont pas ajoutés à NetScaler ADM s’ils échouent à la validation. Corrigez les erreurs et validez les versions mises à jour dans votre dépôt GitHub. Vous pourrez ensuite essayer de les importer ou de les synchroniser à nouveau dans NetScaler ADM.
Remarque
Les fichiers StyleBooks peuvent être importés et synchronisés depuis n’importe quelle branche d’un référentiel GitHub.
Vous pouvez également importer et synchroniser des StyleBooks auxquels des StyleBooks dépendants sont associés.
La synchronisation de StyleBooks à partir d’un référentiel GitHub doit être lancée manuellement à partir de l’interface graphique ou de l’API NetScaler ADM. Autrement dit, actuellement, l’importation et la synchronisation de StyleBooks ne se produisent pas automatiquement en fonction de l’activité de validation de GitHub.
Ajouter un référentiel et importer StyleBooks depuis le référentiel GitHub
Avant de commencer, assurez-vous d’avoir un compte valide dans GitHub.
Vous pouvez importer des fichiers StyleBook vers ADM à partir de n’importe quel dossier du référentiel GitHub.
-
Dans NetScaler ADM, accédez à Applications > StyleBooks > Référentiels.
-
Cliquez sur Ajouter. Dans la fenêtre Ajouter un référentiel, entrez les paramètres suivants :
-
Nom. Entrez 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. 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. Pour plus d’informations sur la création de jetons d’API pour votre référentiel GitHub, consultez la documentation GitHub relative à la création de jetons d’accès personnels.
-
-
Cliquez sur Créer.
Le référentiel est créé dans NetScaler ADM.
-
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 les suivantes :
-
Modifier. Vous pouvez modifier l’URL, le nom d’utilisateur et le mot de passe (ou le jeton API) du référentiel.
-
Supprimer. Vous pouvez supprimer le référentiel ainsi que tous les StyleBooks présents dans NetScaler ADM qui ont été importés précédemment depuis ce référentiel GitHub.
Remarque
Vous ne pouvez pas supprimer un référentiel de NetScaler ADM s’il contient des StyleBooks auxquels des ConfigPacks sont associés. Tout d’abord, supprimez tous les packs de configuration de ces StyleBooks. Vous pouvez ensuite supprimer le référentiel de NetScaler ADM pour nettoyer les StyleBooks de ce référentiel.
-
Réinitialiser. Vous pouvez supprimer tous les StyleBooks de NetScaler ADM synchronisés à partir de ce référentiel sans supprimer réellement l’entrée du référentiel de NetScaler ADM.
-
Liste des fichiers. Vous pouvez voir une liste de tous les StyleBooks présents dans NetScaler ADM qui proviennent du référentiel GitHub.