Application Delivery Management

Benutzerdefinierte StyleBooks verwenden

Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in NetScaler ADM importieren, um es verwenden zu können. Mit NetScaler 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 NetScaler ADM-System validiert Ihre StyleBooks beim Import. Das Stylebook kann nun zum Erstellen von Konfigurationen verwendet werden.

NetScaler 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 anhand der YAML-Standards validiert und jede Abweichung wird hervorgehoben. Sie können dann den Inhalt korrigieren und versuchen, das StyleBook in NetScaler ADM zu importieren. Der integrierte YAML-Editor bietet zwei Vorteile beim Schreiben Ihres eigenen StyleBooks.

  • 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. Auf diese Weise können Sie Text schreiben, der den YAML-Richtlinien entspricht, noch bevor Sie das StyleBook in NetScaler ADM importieren. Derzeit validiert der Editor den Inhalt gemäß den YAML-Richtlinien. Es validiert nicht auf Code Korrektheit und typografische Fehler.

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 drei verfügbaren Optionen, um das StyleBook zu importieren.

    1. Datei. Wählen Sie die erforderliche Datei oder das Dateipaket aus Ihrem lokalen Speicher aus.

      Hinweis

      Importieren Sie in diesem Beispiel das StyleBook „lb-vserver.yaml“, das Sie in StyleBook erstellt haben, um einen virtuellen Load Balancing-Server zu erstellen.

      Lokalisierte Abbildung

    2. Bündel. Mit NetScaler ADM können Sie mehrere StyleBooks im YAML-Format importieren. Sie können mehrere YAML StyleBook-Dateien importieren, die im ZIP-Format (.zip) oder im Tarballformat (.tgz,.gz) komprimiert sind.

      Lokalisierte Abbildung

    3. Roh. Verfassen Sie den Inhalt Ihres StyleBook im YAML-Editor.

      Hinweis

      Stellen Sie beim Verfassen von StyleBook sicher, dass Sie über folgende Kenntnisse verfügen:

      • NITRO API
      • YAML

      Weitere Informationen zum Schreiben eigener StyleBooks finden Sie unter How To Create Your Own StyleBooks.

      Lokalisierte Abbildung

    Hinweis

    Sie können den Inhalt auch aus einer StyleBook YAML-Datei kopieren und einfügen, um den Inhalt zu validieren.

  3. Klicken Sie auf Erstellen.

    NetScaler ADM überprüft jetzt Ihr StyleBook auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird nicht in NetScaler ADM importiert, wenn Fehler auftreten. Wenn es keine Fehler gibt, wird das StyleBook erfolgreich importiert und nun auf der Seite StyleBooks aufgeführt. Sie können das StyleBook anhand des Anzeigenamens identifizieren, den Sie im Header-Bereich des StyleBook definiert haben.

    Hinweis:

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

    Weitere Informationen zur StyleBook-Grammatik und Syntax der verschiedenen Konstrukte und Attribute finden Sie unter StyleBook-Grammatik .

  4. Um Konfigurationen aus diesem StyleBook zu erstellen, klicken Sie auf den Link Konfiguration erstellen . Das StyleBook öffnet sich als Benutzeroberflächenseite, auf der Sie die Werte für alle in diesem StyleBook definierten Parameter eingeben können.

  5. Geben Sie die erforderlichen Werte für die Parameter an. **Im folgenden Beispiel können Sie sehen, dass der Anwendungsname und die **IP-Adressfelder des Load Balancers als Pflichtfelder angezeigt werden und Benutzerwerte akzeptieren können.  Der LB-Algorithmus hat nur zwei Werte, aus denen Sie wählen können, und standardmäßig ist ROUNDROBIN ausgewählt.

  6. **Klicken Sie unter Zielinstanzen auf die IP-Adresse der Citrix ADC-Instanz, auf der Sie die Konfiguration ausführen möchten, und wählen Sie sie aus. Sie können die Konfiguration auch auf mehreren NetScaler ADC bereitstellen, indem Sie beliebig viele Zielinstanzen angeben.

Wenn Sie sich die Citrix ADC (Nitro) -Konfigurationsobjekte ansehen möchten, die auf Ihrem Citrix ADC erstellt werden, bevor Sie die Konfiguration tatsächlich erstellen, klicken Sie auf Dry Run. Wenn Ihre Konfiguration gültig ist, werden die Konfigurationsobjekte angezeigt, die auf der Grundlage der von Ihnen angegebenen Werte erstellt würden. In diesem Beispiel wird nur ein Objekt vom Typ lbvserver durch dieses Beispiel StyleBook erstellt. Dieser lbvserver war die einzige Komponente, die in diesem grundlegenden Beispiel StyleBook definiert wurde. Sie können später auf Erstellen klicken , um die Konfiguration auf den ausgewählten Citrix ADC-Instanzen tatsächlich zu erstellen.

Sobald die Erstellung abgeschlossen ist, wird das neue ConfigPack auf der Seite Konfigurationen aufgeführt.

Hinweis

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

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 nach benutzerdefinierten StyleBooks suchen. Diese Option ist besonders hilfreich, wenn Sie Ihre benutzerdefinierten StyleBooks inmitten einer großen Anzahl von Standard-StyleBooks suchen müssen.

Um nach benutzerdefinierten StyleBooks zu suchen

  1. Navigieren Sie in NetScaler ADM zu Anwendungen > Konfigurationen > StyleBooks.
  2. Klicken Sie oben rechts auf das Suchsymbol.
  3. Wählen Sie in der angezeigten Suchleiste in der ersten Liste die Option Typ aus, und wählen Sie Benutzerdefiniert aus der nächsten Optionsliste aus.
  4. Citrix ADM zeigt nur die benutzerdefinierten StyleBooks an.
Benutzerdefinierte StyleBooks verwenden