Importer et synchroniser des StyleBooks à partir d’un dépôt GitHub
Imaginez un scénario où vous utilisez des processus CI/CD pour votre développement. Ou un scénario où vous gérez tout le code source de l’application et les objets de déploiement dans GitHub.
Dans le dépôt GitHub, vous avez peut-être créé plusieurs StyleBooks pour déployer les configurations NetScaler et gérer ces StyleBooks. Ces StyleBooks sont également nécessaires 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, ni de synchroniser manuellement les fichiers dans ADM et GitHub.
Vous pouvez désormais définir un dépôt dans NetScaler® ADM qui représente un dépôt GitHub. Fournissez l’URL du dépôt GitHub ainsi que 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 des StyleBooks.
Après avoir créé le dépôt, vous pouvez synchroniser NetScaler ADM avec votre dépôt GitHub. NetScaler ADM se connecte à GitHub et importe les StyleBooks trouvés dans ce dépôt. 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 tenter de les importer ou de les synchroniser à nouveau dans NetScaler ADM.
Remarque
Les fichiers StyleBooks peuvent être importés et synchronisés à partir de n’importe quelle branche d’un dépôt GitHub.
Vous pouvez également importer et synchroniser des StyleBooks qui ont des StyleBooks dépendants associés.
La synchronisation des StyleBooks à partir d’un dépôt GitHub doit être lancée manuellement depuis l’interface graphique (GUI) ou l’API de NetScaler ADM. Autrement dit, actuellement, l’importation et la synchronisation des StyleBooks ne se produisent pas automatiquement en fonction de l’activité de validation GitHub.
Ajouter un dépôt et importer des StyleBooks à partir d’un dépôt GitHub
Avant de commencer, assurez-vous de disposer d’un compte valide dans GitHub.
Vous pouvez importer des fichiers StyleBook dans ADM à partir de n’importe quel dossier du dépôt GitHub.
-
Dans NetScaler ADM, accédez à Applications > StyleBooks > Dépôts.
-
Cliquez sur Ajouter. Dans la fenêtre Ajouter un dépôt, saisissez les paramètres suivants :
-
Nom. Saisissez le nom du dépôt. Ce nom peut être identique à celui du dépôt dans GitHub ou différent.
-
URL du dépôt. Saisissez l’URL du dépôt GitHub.
-
Nom d’utilisateur et mot de passe. Saisissez 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 via HTTPS. Pour plus d’informations sur la création de jetons API pour votre dépôt GitHub, consultez la documentation GitHub relative à la création de jetons d’accès personnels.
-
-
Cliquez sur Créer.
Le dépôt est créé dans NetScaler ADM.
-
Pour importer ou synchroniser des StyleBooks, sélectionnez le dépôt dans la page Dépôts, puis cliquez sur Synchroniser.
Les autres actions que vous pouvez utiliser ici sont :
-
Modifier. Vous pouvez modifier l’URL du dépôt, le nom d’utilisateur et le mot de passe (ou le jeton API).
-
Supprimer. Vous pouvez supprimer le dépôt ainsi que tous les StyleBooks présents dans NetScaler ADM qui avaient été précédemment importés depuis ce dépôt GitHub.
Remarque
Vous ne pouvez pas supprimer un dépôt 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 pourrez ensuite supprimer le dépôt de NetScaler ADM pour nettoyer les StyleBooks de ce dépôt.
-
Réinitialiser. Vous pouvez supprimer tous les StyleBooks dans NetScaler ADM synchronisés à partir de ce dépôt sans réellement supprimer l’entrée du dépôt de NetScaler ADM.
-
Lister les fichiers. Vous pouvez voir une liste de tous les StyleBooks présents dans NetScaler ADM qui proviennent du dépôt GitHub.