StyleBooks aus GitHub-Repository importieren und synchronisieren
Stellen Sie sich ein Szenario vor, in dem Sie CI/CD-Prozesse für Ihre Entwicklung verwenden. Oder ein Szenario, in dem Sie den gesamten Anwendungsquellcode und die Bereitstellungsobjekte in GitHub verwalten.
Im GitHub-Repository haben Sie möglicherweise mehrere StyleBooks für die Bereitstellung der NetScaler-Konfigurationen erstellt und diese StyleBooks verwaltet. Diese StyleBooks werden auch in Citrix Applications and Delivery Management (ADM) benötigt. Jetzt können Sie diese StyleBooks direkt in NetScaler ADM importieren. Sie müssen sie nicht manuell von GitHub kopieren und dann in NetScaler ADM hochladen oder die Dateien in ADM und GitHub manuell synchronisieren.
Sie können jetzt in NetScaler® ADM ein Repository definieren, das ein GitHub-Repository darstellt. Geben Sie die GitHub-Repository-URL sowie Ihren in GitHub erstellten Benutzernamen und Ihr Passwort (oder API-Token) an. Das bedeutet, dass nur autorisierte Benutzer mit einem gültigen GitHub-Konto StyleBooks importieren und synchronisieren können.
Nachdem Sie das Repository erstellt haben, können Sie NetScaler ADM mit Ihrem GitHub-Repository synchronisieren. NetScaler ADM stellt eine Verbindung zu GitHub her und importiert StyleBooks, die in diesem Repository gefunden werden. ADM validiert dann die StyleBooks und fügt sie der Liste der StyleBooks in NetScaler ADM hinzu. StyleBooks werden nicht zu NetScaler ADM hinzugefügt, wenn die Validierung fehlschlägt. Korrigieren Sie die Fehler und committen Sie aktualisierte Versionen in Ihr GitHub-Repository. Später können Sie versuchen, sie erneut in NetScaler ADM zu importieren oder zu synchronisieren.
Hinweis
StyleBook-Dateien können aus jedem Branch eines GitHub-Repositorys importiert und synchronisiert werden.
Sie können auch StyleBooks importieren und synchronisieren, die abhängige StyleBooks zugeordnet haben.
Die Synchronisierung von StyleBooks aus einem GitHub-Repository muss manuell über die NetScaler ADM GUI oder API initiiert werden. Das heißt, das Importieren und Synchronisieren von StyleBooks erfolgt derzeit nicht automatisch basierend auf GitHub-Commit-Aktivitäten.
Repository hinzufügen und StyleBooks aus GitHub-Repository importieren
Stellen Sie vor dem Start sicher, dass Sie ein gültiges GitHub-Konto besitzen.
Sie können StyleBook-Dateien aus jedem Ordner im GitHub-Repository in ADM importieren.
-
Navigieren Sie in NetScaler ADM zu Applications > StyleBooks > Repositories.
-
Klicken Sie auf Add. Geben Sie im Fenster Add Repository die folgenden Parameter ein:
-
Name. Geben Sie den Namen des Repositorys ein. Dieser Name kann derselbe sein wie der Repository-Name in GitHub oder ein anderer.
-
Repository URL. Geben Sie die GitHub-Repository-URL ein.
-
User name and password. Geben Sie den Benutzernamen und das Passwort ein, mit denen Sie auf das GitHub-Konto zugreifen.
Hinweis
Sie können auch das API-Token anstelle eines Passworts angeben. API-Token können anstelle eines Passworts für GitHub über HTTPS verwendet werden. Informationen zum Erstellen von API-Token für Ihr GitHub-Repository finden Sie in der GitHub-Dokumentation zum Erstellen persönlicher Zugriffstoken.
-
-
Klicken Sie auf Create.
Das Repository wird in NetScaler ADM erstellt.
-
Um StyleBooks zu importieren oder zu synchronisieren, wählen Sie das Repository auf der Seite Repositories aus und klicken Sie auf Sync.
Die weiteren Aktionen, die Sie hier verwenden können, sind:
-
Edit. Sie können die Repository-URL, den Benutzernamen und das Passwort (oder API-Token) bearbeiten.
-
Delete. Sie können das Repository zusammen mit allen in NetScaler ADM vorhandenen StyleBooks löschen, die zuvor aus diesem GitHub-Repository importiert wurden.
Hinweis
Sie können ein Repository nicht aus NetScaler ADM löschen, wenn es StyleBooks enthält, denen ConfigPacks zugeordnet sind. Löschen Sie zuerst alle Konfigurationspakete dieser StyleBooks. Sie können das Repository später aus NetScaler ADM entfernen, um die StyleBooks aus diesem Repository zu bereinigen.
-
Reset. Sie können alle in NetScaler ADM synchronisierten StyleBooks aus diesem Repository entfernen, ohne den Repository-Eintrag tatsächlich aus NetScaler ADM zu löschen.
-
List files. Sie können eine Liste aller in NetScaler ADM vorhandenen StyleBooks anzeigen, die aus dem GitHub-Repository stammen.