Importieren von benutzerdefinierten StyleBooks

Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in Citrix Application Delivery Management (ADM) importieren, um es zu verwenden. Mit Citrix ADM können Sie ein einzelnes StyleBook in YAML-Form oder mehrere StyleBook-YAML-Dateien als Bundle in einem Zip-, TGZ- oder GZ-Formular importieren. Das Citrix ADM -System validiert Ihre StyleBooks beim Import. Das StyleBook kann nun zum Erstellen von Konfigurationen verwendet werden.

Citrix ADM verfügt auch über einen integrierten YAML-Editor, mit dem Sie die StyleBook YAML-Inhalte erstellen können. Mit dem YAML-Editor können Sie Ihre YAML-Konstrukte von Citrix ADM GUI selbst überprüfen. Sie müssen kein separates Tool für diese Validierungsprüfungen verwenden. Der Inhalt wird nach YAML-Standards validiert und jede Abweichung wird hervorgehoben. Anschließend können Sie den Inhalt korrigieren und versuchen, das StyleBook in Citrix ADM zu importieren. Der integrierte YAML-Editor bietet zwei Vorteile beim Schreiben Ihres eigenen StyleBook.

  • Farbcodiert. Der Editor zeigt den StyleBook-Inhalt gemäß YAML-Richtlinien analysiert, und die Farbcodierung hilft Ihnen, leicht zwischen den Tasten und den Werten zu unterscheiden, die im YAML-Inhalt definiert sind.
  • YAML-Validierung. Der Inhalt wird bei der Eingabe auf YAML-Fehler überprüft und jede Abweichung wird sofort hervorgehoben. Mit dieser Validierung können Sie Text schreiben, der den YAML-Richtlinien entspricht, noch bevor Sie das StyleBook in Citrix ADM importieren.

Hinweis

Aktuell überprüft der Editor den Inhalt gemäß den YAML-Richtlinien. Es validiert nicht auf Code Korrektheit und typografische Fehler.

So importieren Sie Ihr StyleBook

  1. Navigieren Sie in Citrix ADM zu Anwendungen > Konfiguration > StyleBooks, und klicken Sie dann auf Neues StyleBook importieren.

  2. Klicken Sie auf eine der folgenden Optionen, um ein StyleBook zu importieren.

    • Datei - Wählen Sie die gewünschte Datei oder das Bündel von Dateien aus Ihrem lokalen Speicher aus.

      Hinweis: Importieren Sie

      in diesem Beispiel das lb-vserver.ymlStyleBook, das Sie in erstellt haben StyleBook zum Erstellen eines virtuellen Load Balancing Servers.

      Importieren einer StyleBook-Datei

    • Bundle - Mit Citrix ADM können Sie mehrere StyleBooks im YAML-Format importieren. Sie können mehrere YAML StyleBook-Dateien importieren, die im ZIP-Format (.zip) oder Tarball-Format (.tgz, .gz) komprimiert sind.

      Importieren eines StyleBook-Pakets

    • Raw - Verfassen Sie den Inhalt Ihres StyleBook im YAML-Editor.

      Sie können den StyleBook-Inhalt überprüfen, um die StyleBook-Grammatikfehler zu überprüfen. Um StyleBook-Inhalte zu überprüfen, klicken Sie auf Inhalt überprüfen.

      Hinweis Achten Sie

      beim Komponieren von StyleBook darauf, die folgenden Konzepte zu kennen:

      • NITRO API
      • YAML

      Weitere Informationen zum Schreiben eigener StyleBooks finden Sie unterSo erstellen Sie Ihre eigenen StyleBooks.

      Erstellen eines StyleBook mit ADM YAML Editor

    • Sync Repository - Diese Option listet die Repositories auf, die ADM hinzugefügt wurden. Wählen Sie das Repository aus, das Sie mit ADM synchronisieren möchten.

      Synchronisieren von Repositories in ADM

    Hinweis

    Sie können den Inhalt auch aus einer StyleBook YAML-Datei kopieren und in den YAML-Editor einfügen.

  3. Optional können Sie ein Symbol für ein StyleBook auswählen.

    In Anwendungen > StyleBookwird das importierte StyleBook mit diesem Symbol angezeigt.

    StyleBook mit einem Symbol importieren

  4. Klicken Sie auf Erstellen.

    Citrix ADM überprüft jetzt Ihr StyleBook auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird bei Fehlern nicht in Citrix ADM importiert.

    Wenn keine Fehler auftreten, wird das StyleBook erfolgreich importiert und auf der Seite StyleBooks aufgeführt. Sie können das StyleBook anhand des Anzeigenamens identifizieren, den Sie im Kopfbereich des StyleBook definiert haben.

    Beispiel StyleBook

    Hinweis

    Wenn Sie ein Paket von Dateien importieren, dekomprimiert Citrix ADM den gezippten Ordner und validiert alle StyleBooks. Das Bundle wird nicht importiert, auch wenn eine StyleBook-Datei den Validierungstest fehlschlägt.

    Weitere Hinweise zur StyleBook-Grammatik und Syntax der verschiedenen Konstrukte und Attribute finden Sie unterStyleBook Grammatik.

  5. Klicken Sie auf den Link Konfiguration erstellen, um Konfigurationen aus diesem StyleBook zu erstellen.

    Das StyleBook öffnet sich als Benutzeroberflächenseite, auf der Sie die Werte für alle in diesem StyleBook definierten Parameter eingeben können.

  6. Geben Sie die erforderlichen Werte für die Parameter an.

    Im folgenden Beispiel wird

    1. Geben Sie den Anwendungsnamen und die** Pflichtfelder für die IP-Adresse des **Lastausgleichs an.

    2. Wählen Sie den LoadBalancing-Algorithmus aus der Liste aus. Standardmäßig** ist **ROUNDROBIN ausgewählt.

      !![Beispiel-Konfigurationsbereitstellung] (/de-de/citrix-application-delivery-management-service/media/nmas-stylebooks-yaml-editor-4.png)

  7. Wählen Sie unter Zielinstanzendie IP-Adresse der Citrix ADC Instanz aus, in der Sie die Konfiguration bereitstellen möchten.

    Sie können die Konfiguration auch auf mehreren Citrix ADC bereitstellen, indem Sie beliebig viele Zielinstanzen angeben.

  8. Wenn Sie die Citrix ADC (NITRO) -Konfigurationsobjekte testen möchten, bevor Sie die Konfiguration bereitstellen, klicken Sie auf Dry Run.

    Wenn die Konfiguration gültig ist, werden die Konfigurationsobjekte basierend auf den angegebenen Werten erstellt.

    In diesem Beispiel erstellt das StyleBook nur ein Objekt vom Typ lbvserver. Dieser Lastenausgleichsserver war die einzige Komponente, die in diesem grundlegenden Beispiel StyleBook definiert wurde.

    Klicken Sie später auf Erstellen, um die Konfiguration auf den ausgewählten Citrix ADC Instanzen bereitzustellen.

Nachdem Sie die Konfiguration erfolgreich bereitgestellt haben, wird auf der Seite “Konfigurationen” ein neues Konfigurationspaket angezeigt.

Hinweis:

Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich erkannte Citrix ADC Instanzen in Citrix ADM zur verfügbaren Liste der Instanzen in diesem Fenster hinzuzufügen.

Ein neues Konfigurationspaket

Benutzerdefinierte StyleBooks suchen

Mit Citrix ADM können Sie jetzt basierend auf ihrem Typ nach StyleBooks suchen. Das heißt, Sie können jetzt entweder nach Standard-StyleBooks oder benutzerdefinierten StyleBooks suchen. Diese Option ist besonders hilfreich, wenn Sie in vielen Standard-StyleBooks nach Ihren benutzerdefinierten StyleBooks suchen müssen.

So suchen Sie nach benutzerdefinierten StyleBooks

  1. Navigieren Sie in Citrix ADM zu Anwendungen > Konfigurationen > StyleBooks.

  2. Klicken Sie oben rechts auf das Suchsymbol.

  3. Wählen Sie in der Suchleiste Typ aus, und wählen Sie dann Benutzerdefiniert aus der Unterliste aus.

  4. Citrix ADM zeigt nur die benutzerdefinierten StyleBooks an.

Benutzerdefinierte StyleBooks suchen