Application Delivery Management

Importieren und Synchronisieren von StyleBooks aus GitHub-Repository

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 und die Verwaltung dieser StyleBooks erstellt. Diese StyleBooks sind auch in Citrix Applications and Delivery Management (ADM) erforderlich. 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 sowohl in ADM als auch in GitHub manuell synchronisieren.

Sie können nun ein Repository in NetScaler ADM definieren, das ein GitHub-Repository darstellt. Geben Sie die GitHub-Repository-URL sowie Ihren in GitHub erstellten Benutzernamen und Ihr Kennwort (oder API-Token) an. Das bedeutet, dass nur autorisierte Benutzer, die ein gültiges Konto in GitHub haben, 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 wurden. ADM validiert dann die StyleBooks und fügt sie der Liste der StyleBooks in NetScaler ADM hinzu. StyleBooks werden NetScaler ADM nicht hinzugefügt, wenn die Validierung fehlschlägt. Korrigieren Sie die Fehler und übertragen Sie aktualisierte Versionen in Ihr GitHub-Repository. Später können Sie versuchen, sie zu importieren oder erneut mit NetScaler ADM zu synchronisieren.

Hinweis

  • StyleBooks-Dateien können aus jedem Zweig eines GitHub-Repositorys importiert und synchronisiert werden.

  • Sie können StyleBooks importieren und synchronisieren, denen auch abhängige StyleBooks zugeordnet sind.

  • Die Synchronisation von StyleBooks aus einem GitHub-Repository muss manuell über die NetScaler ADM GUI oder API initiiert werden. Das heißt, derzeit geschieht das Importieren und Synchronisieren von StyleBooks nicht automatisch basierend auf GitHub Commit-Aktivität.

Fügen Sie ein Repository hinzu und importieren Sie StyleBooks aus dem GitHub-Repository

Bevor Sie beginnen, stellen Sie sicher, dass Sie über ein gültiges Konto in GitHub verfügen.

Sie können StyleBook-Dateien aus jedem Ordner im GitHub-Repository in ADM importieren.

  1. Navigieren Sie in NetScaler ADM zuApplications > StyleBooks > Repositories.

  2. Klicken Sie auf Hinzufügen. Geben Sie im Fenster Repository hinzufügen die folgenden Parameter ein:

    • Name. Geben Sie den Namen des Repositorys ein. Dieser Name kann mit dem Repository-Namen in GitHub oder einem anderen Namen identisch sein.

    • Repository-URL. Geben Sie die GitHub-Repository-URL ein.

    • Benutzername und Kennwort. Geben Sie den Benutzernamen und das Kennwort ein, mit dem Sie auf das GitHub-Konto zugreifen.

    Hinweis:

    Sie können das API-Token auch anstelle eines Kennworts angeben. API-Token können anstelle eines Kennworts 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.

  3. Klicken Sie auf Erstellen.

    GIT-Repository hinzufügen

    Das Repository wird in NetScaler ADM erstellt.

  4. Um StyleBooks zu importieren oder zu synchronisieren, wählen Sie das Repository auf der SeiteRepositoriesaus und klicken Sie auf Synchronisieren.

Die anderen Aktionen, die Sie hier verwenden können, sind:

  • Bearbeiten: Sie können die Repository-URL, den Benutzernamen und das Kennwort (oder das API-Token) bearbeiten.

  • Löschen. 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 StyleBooks mit ConfigPacks verknüpft sind. Löschen Sie zunächst alle Konfigurationspakete dieser StyleBooks. Sie können das Repository später aus NetScaler ADM entfernen, um die StyleBooks aus diesem Repository zu bereinigen.

  • Zurücksetzen. Sie können alle StyleBooks in NetScaler ADM entfernen, die aus diesem Repository synchronisiert wurden, ohne den Repository-Eintrag tatsächlich aus NetScaler ADM zu löschen.

  • Dateien auflisten. Sie können eine Liste aller in NetScaler ADM vorhandenen StyleBooks anzeigen, die aus dem GitHub-Repository stammen.

Importieren und Synchronisieren von StyleBooks aus GitHub-Repository