Importieren Sie benutzerdefinierte StyleBooks

Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in NetScaler Application Delivery Management (ADM) importieren, um es zu verwenden. Mit NetScaler ADM können Sie ein einzelnes StyleBook im YAML-Format oder mehrere StyleBook-YAML-Dateien als Paket im .zip-, .tgz- oder .gz-Format importieren. Das NetScaler ADM-System validiert Ihre StyleBooks beim Import. Das StyleBook kann nun zum Erstellen von Konfigurationen verwendet werden.

NetScaler ADM verfügt außerdem ü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 direkt über die NetScaler ADM-GUI validieren. Sie müssen für diese Validierungsprüfungen kein separates Tool verwenden. Der Inhalt wird anhand der YAML-Standards validiert und jede Abweichung wird hervorgehoben. Anschließend können Sie 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 gemäß den YAML-Richtlinien analysierten StyleBook-Inhalt an und die Farbcodierung hilft Ihnen, leicht zwischen den Schlüsseln und den im YAML-Inhalt definierten Werten zu unterscheiden.
• YAML-Validierung. Der Inhalt wird während der Eingabe auf etwaige YAML-Fehler überprüft und jede Abweichung wird sofort hervorgehoben. Diese Validierung ermöglicht es Ihnen, bereits vor dem Import des StyleBooks in das ADM einen Text zu schreiben, der den YAML-Richtlinien entspricht.

Notiz

Derzeit validiert der Editor den Inhalt gemäß den YAML-Richtlinien. Es erfolgt keine Überprüfung auf Codekorrektheit und Tippfehler.

So importieren Sie Ihr StyleBook

1. Navigieren Sie in NetScaler ADM zu Anwendungen > Konfiguration > StyleBooksund 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 Dateipaket aus Ihrem lokalen Speicher aus.

Notiz

Importieren Sie in diesem Beispiel das StyleBook lb-vserver.yml , das Sie in StyleBook erstellt haben, um einen virtuellen Lastenausgleichsserverzu erstellen.

    ![Importieren einer StyleBook-Datei](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-1-citrix.png)

-  **Bundle** – NetScaler ADM ermöglicht Ihnen den Import mehrerer StyleBooks im YAML-Format. Sie können mehrere YAML-StyleBook-Dateien importieren, die im ZIP-Format (.zip) oder Tarball-Format (.tgz, .gz) komprimiert sind.

    ![Importieren eines StyleBook-Pakets](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-5-citrix.png)

    Sie können jetzt jedem StyleBook im Paket Symbole hinzufügen. Stellen Sie sicher, dass der Ressourcenordner Symbole im PNG-, GIF- oder JPEG-Format enthält. Wenn der Symboldateiname mit dem StyleBook-Namen übereinstimmt, werden die Symbole automatisch den StyleBooks zugeordnet. Andernfalls gehen Sie wie folgt vor:

    1.  Fügen Sie die Datei `icon_mapping.json` im Ressourcenordner hinzu.

    2.  Ordnen Sie StyleBooks und Symbole in der Datei `icon_mapping.json` wie folgt zu:

        ```yaml
        <StyleBook file name> : <icon file name>
        <!--NeedCopy--> ```

    Das Folgende ist ein Beispiel für ein StyleBook-Paket:

    ![StyleBook-Paket mit Symbolen](/en-us/netscaler-application-delivery-management-software/media/stylebook-icons-bundle.png)

    Der Ordner `resources` enthält die erforderlichen Symbole.

    ![Symbole im Ressourcenordner](/en-us/netscaler-application-delivery-management-software/media/stylebook-resources-folder.png)

    In diesem Beispiel werden die Dateien `sharepoint.yaml` und `skype.yaml` automatisch den Dateien `sharepoint.jpeg` und `skype.png` zugeordnet.

    Um `exchange.yaml` auf `exch.png`abzubilden, geben Sie Folgendes in der Datei `icon_mapping.json` an:

    ```json
    {
    "exchange.yaml":"exch.png" }
    <!--NeedCopy--> ```

    Wenn Sie den Eintrag `defaulticon` angeben, werden die StyleBooks dem Standardsymbol zugeordnet, sofern sie nicht einem anderen Symbol zugeordnet sind.

    ```yaml
    Standardsymbol: <icon file name>
    <!--NeedCopy--> ```

    In **Anwendungen > StyleBooks**werden die importierten StyleBooks mit den zugeordneten Symbolen angezeigt.

-  **Raw** – Erstellen Sie den Inhalt Ihres StyleBooks im YAML-Editor.

    Sie können den StyleBook-Inhalt validieren, um die Grammatikfehler im StyleBook zu überprüfen. Um StyleBook-Inhalte zu validieren, klicken Sie auf **Inhalt validieren**. > **Notiz** > > Achten Sie beim Erstellen eines StyleBooks darauf, die folgenden Konzepte zu kennen: > > -  NITRO API > -  YAML

    Weitere Informationen zum Schreiben eigener StyleBooks finden Sie unter [So erstellen Sie Ihre eigenen StyleBooks](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/how-to-create-custom-stylebooks.html).

    ![Erstellen Sie ein StyleBook mit dem ADM YAML-Editor](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-2-citrix.png)

-       **Repository synchronisieren** – Diese Option listet die zu ADM hinzugefügten Repositories auf. Wählen Sie das Repository aus, das Sie mit ADM synchronisieren möchten. > **Notiz** > > Sie können den Inhalt auch aus einer StyleBook-YAML-Datei kopieren und in den YAML-Editor einfügen.

1. Wählen Sie optional ein Symbol für ein StyleBook aus.

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

2. Klicken Sie auf Erstellen.

   NetScaler ADM überprüft Ihr StyleBook jetzt auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird nicht in NetScaler ADM importiert, wenn Fehler auftreten.

   Wenn keine Fehler auftreten, wurde 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 StyleBooks definiert haben.

Notiz

Wenn Sie ein Dateipaket importieren, dekomprimiert NetScaler ADM den ZIP-Ordner und validiert alle StyleBooks. Das Paket wird nicht importiert, selbst wenn eine StyleBook-Datei den Validierungstest nicht besteht.

Weitere Informationen zur StyleBook-Grammatik und Syntax der verschiedenen Konstrukte und Attribute finden Sie unter [StyleBook-Grammatik](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/stylebooks-grammar.html).

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

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

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

   Im folgenden Beispiel

   1. Geben Sie die Pflichtfelder Anwendungsname und IP-Adresse des Load Balancers an.

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

3. Wählen Sie unter Zielinstanzendie IP-Adresse der NetScaler-Instanz aus, auf der Sie die Konfiguration bereitstellen möchten.

   Sie können die Konfiguration auch auf mehr als einem NetScaler bereitstellen, indem Sie so viele Zielinstanzen wie nötig angeben.

4. Wenn Sie die NetScaler (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 Lastausgleichsserver 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 NetScaler-Instanzen bereitzustellen.

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

Notiz

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

Suche nach benutzerdefinierten StyleBooks

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

So suchen Sie nach benutzerdefinierten StyleBooks

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

2. Klicken Sie oben rechts auf das Suchsymbol.

3. Wählen Sie in der Suchleiste aus. Geben Sie ein und wählen Sie dann Benutzerdefiniert aus der Unterliste aus.

4. NetScaler ADM zeigt nur die benutzerdefinierten StyleBooks an.