Benutzerdefinierte StyleBooks importieren
Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in NetScaler Application Delivery Management (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 jetzt für die Erstellung von Konfigurationen verwendet werden.
NetScaler ADM verfügt auch über einen integrierten YAML-Editor, mit dem Sie die StyleBook YAML-Inhalte erstellen können. Der YAML-Editor ermöglicht es Ihnen, Ihre YAML-Konstrukte über die NetScaler ADM GUI selbst zu validieren. 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 nach YAML-Richtlinien analysierten StyleBook-Inhalt an, und die Farbcodierung hilft Ihnen, einfach zwischen den Schlüsseln und den im YAML-Inhalt definierten Werten zu unterscheiden.
- 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 das ADM importieren.
Hinweis:
Derzeit validiert der Editor den Inhalt gemäß den YAML-Richtlinien. Es validiert nicht auf Code Korrektheit und typografische Fehler.
So importieren Sie Ihr StyleBook
-
Navigieren Sie in NetScaler ADM zu Anwendungen > Konfiguration > StyleBooks, und klicken Sie dann auf Neues StyleBook importieren.
-
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 StyleBook erstellt haben, um einen virtuellen Load Balancing-Server zu erstellen .
-
Bundle - 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 Tarball-Format (.tgz, .gz) komprimiert sind.
Sie können jetzt jedem StyleBook im Bundle Symbole hinzufügen. Stellen Sie sicher, dass Sie den Ressourcenordner haben, der Symbole in den Formaten PNG, GIF oder JPEG enthält. Wenn der Name der Symboldatei mit dem StyleBook-Namen übereinstimmt, werden die Symbole automatisch den StyleBooks zugeordnet. Ansonsten machen Sie folgendes:
-
Fügen Sie die
icon_mapping.jsonDatei im Ressourcen-Ordner hinzu. -
Ordnen Sie StyleBooks und Symbole in der
icon_mapping.jsonDatei wie folgt zu:<StyleBook file name> : <icon file name> <!--NeedCopy-->
Es folgt ein Beispiel für ein StyleBook-Bundle:
Der Ordner
resourcesenthält die erforderlichen Symbole.
In diesem Beispiel werden die Dateien
sharepoint.yamlundskype.yamlautomatischsharepoint.jpegundskype.pngzugeordnet.Um
exchange.yamlexch.pngzuzuordnen, geben Sie Folgendes in der Dateiicon_mapping.jsonan:{ "exchange.yaml":"exch.png" } <!--NeedCopy-->Wenn Sie den
defaulticonEintrag angeben, werden die StyleBooks dem Standardsymbol zugeordnet, es sei denn, sie werden einem anderen Symbol zugeordnet.defaulticon: <icon file name> <!--NeedCopy-->In Applications > StyleBookswerden die importierten StyleBooks mit den zugeordneten Symbolen angezeigt.
-
-
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:
Stellen Sie beim Verfassen von StyleBook sicher, dass Sie die folgenden Konzepte kennen:
- NITRO API
- YAML
Weitere Informationen zum Schreiben eigener StyleBooks finden Sie unter How To Create Your Own StyleBooks.
-
Repository synchronisieren — Diese Option listet die zu ADM hinzugefügten Repositorys auf. Wählen Sie das Repository aus, das Sie mit ADM synchronisieren möchten.
Hinweis:
Sie können den Inhalt auch aus einer StyleBook YAML-Datei kopieren und in den YAML-Editor einfügen.
-
-
Optional können Sie ein Symbol für ein StyleBook auswählen.
Unter Applications > StyleBookwird das importierte StyleBook mit diesem Symbol angezeigt.
-
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 keine Fehler vorliegen, wurde das StyleBook erfolgreich importiert und auf der StyleBooks-Seite aufgeführt. Sie können das StyleBook anhand des Anzeigenamens identifizieren, den Sie im Header-Bereich des StyleBook definiert haben.
Hinweis:
Wenn Sie ein Paket von Dateien importieren, dekomprimiert NetScaler ADM den komprimierten 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 Grammar.
-
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.
-
Geben Sie die erforderlichen Werte für die Parameter an.
Im folgenden Beispiel wird
-
Geben Sie den Anwendungsnamen und die erforderliche Load Balancer-IP-Adresse an.
-
Wählen Sie den LoadBalancing-Algorithmus aus der Liste. Standardmäßig ist ROUNDROBIN ausgewählt.
-
-
Wählen Sie unter Zielinstanzendie IP-Adresse der NetScaler-Instanz aus, in der Sie die Konfiguration bereitstellen möchten.
Sie können die Konfiguration auch auf mehreren NetScaler bereitstellen, indem Sie beliebig viele Zielinstanzen angeben.
-
Wenn Sie vor der Bereitstellung der Konfiguration an den NetScaler (NITRO) -Konfigurationsobjekten testen möchten, klicken Sie auf Trockenlauf.
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 Load-Balancing-Server war die einzige Komponente, die in diesem einfachen 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 SeiteKonfigurationen ein neues Konfigurationspaket angezeigt.
Hinweis:
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.
Benutzerdefinierte StyleBooks suchen
Mit NetScaler ADM können Sie jetzt anhand ihres Typs 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 in vielen Standard-StyleBooks nach Ihren benutzerdefinierten StyleBooks suchen müssen.
Um nach benutzerdefinierten StyleBooks zu suchen
-
Navigieren Sie in NetScaler ADM zu Anwendungen > Konfigurationen > StyleBooks.
-
Klicken Sie oben rechts auf das Suchsymbol.
-
Wählen Sie in der Suchleiste Typ und dann Benutzerdefiniert aus der Unterliste aus.
-
NetScaler ADM zeigt nur die benutzerdefinierten StyleBooks an.