Importieren und Synchronisieren von StyleBooks aus GitHub-Repository

Betrachten Sie ein Szenario, 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 Citrix ADC 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 Citrix ADM importieren. Sie müssen sie nicht manuell aus GitHub kopieren und dann in Citrix ADM hochladen oder die Dateien in ADM und GitHub manuell synchronisieren.

Sie können nun ein Repository in Citrix ADM definieren, das ein GitHub-Repository darstellt. Geben Sie die GitHub-Repository-URL und Ihren Benutzernamen und Ihr Kennwort (oder API-Token) an, die in GitHub erstellt wurden. 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 Citrix ADM mit Ihrem GitHub-Repository synchronisieren. Citrix ADM stellt eine Verbindung mit 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 Citrix ADM hinzu. StyleBooks werden Citrix 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 Citrix 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 Synchronisierung von StyleBooks aus einem GitHub-Repository muss manuell von der Citrix 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.

Hinzufügen eines Repositorys und Importieren von StyleBooks aus 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 einem beliebigen Ordner im GitHub-Repository in ADM importieren.

  1. Navigieren Sie in Citrix ADM zu Anwendungen > 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 bereitstellen. 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 fürErstellen persönlicher Zugriffstoken.

  3. Klicken Sie auf Erstellen.

    lokalisiertes Bild

    Das Repository wird in Citrix ADM erstellt.

  4. Um StyleBooks zu importieren oder zu synchronisieren, wählen Sie das Repository auf der Seite Repositories aus, 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 Citrix ADM vorhandenen StyleBooks löschen, die zuvor aus diesem GitHub-Repository importiert wurden.

    Hinweis:

    Sie können ein Repository nicht aus Citrix 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 Citrix ADM entfernen, um die StyleBooks aus diesem Repository zu bereinigen.

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

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

lokalisiertes Bild

Importieren und Synchronisieren von StyleBooks aus GitHub-Repository