Benutzerdefinierte StyleBooks importieren
Nachdem Sie Ihr StyleBook erstellt haben, importieren Sie es in die NetScaler Console, um es zu verwenden. Mit NetScaler Console können Sie ein einzelnes StyleBook im YAML-Format oder viele StyleBook-YAML-Dateien als Paket in einem ZIP-, .tgz- oder .gz-Format importieren. Das NetScaler Console-System validiert Ihre StyleBooks beim Import. Das StyleBook kann jetzt für die Erstellung von Konfigurationen verwendet werden.
NetScaler Console 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 von der NetScaler Console-GUI selbst aus 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. Anschließend können Sie den Inhalt korrigieren und versuchen, das StyleBook in die NetScaler Console zu importieren. Der integrierte YAML-Editor bietet zwei Vorteile beim Schreiben Ihres eigenen StyleBooks.
- Farbcodiert. Der Editor zeigt den StyleBook-Inhalt an, der gemäß den YAML-Richtlinien analysiert wurde. 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 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 NetScaler Console importieren.
Hinweis:
Derzeit validiert der Editor den Inhalt gemäß den YAML-Richtlinien. Es validiert nicht auf Code Korrektheit und typografische Fehler.
Verwenden Sie HTML-Formatierungs-Tags in der StyleBook-Beschreibung und in
In der StyleBook-Definition können Sie ein Header-Feld einschließen und HTML-Formatierungs-Tags für den Text verwenden. Sie können auch Bilder als Teil der Kopfzeile hinzufügen. Der HTML-Inhalt im Header-Feld wird oben auf der Konfigurationsseite angezeigt, wenn Sie eine Konfiguration erstellen oder aktualisieren. Mit dieser Funktion können Sie Infografiken für das StyleBook hinzufügen, um die StyleBook-Konfiguration zu verstehen. Wenn Sie Bilder in der Kopfzeile verwenden, stellen Sie sicher, dass das base64-codierte Bildformat im <img>-Tag verwendet wird.
Um Bilder in Ihrem HTML-Inhalt verwenden zu können, müssen die Bilder inline sein, wie im folgenden Beispiel gezeigt. Sie können Online-Tools verwenden, um Ihre Bilder in ihre Base64-kodierte Form zu konvertieren.
name: cs-example
namespace: com.example.stylebooks
version: "1.2"
display-name: Content Switching Configuration
description: Example of a very simple content switching config that creates and binds an lb to a cs
header: <img id="b64img" src="data:image/png;base64,…" />
<h3>Operations performed by this StyleBook:</h3>
<ul>
<li style="list-style-type: circle"> Creates a Server </li>
<li style="list-style-type: circle"> Creates a Service Group </li>
<li style="list-style-type: circle"> Creates a LBVServer </li>
<li style="list-style-type: circle"> Creates a CS Policy and Action </li>
</ul>
schema-version: "1.0"
<!--NeedCopy-->
So importieren Sie Ihr StyleBook
-
Navigieren Sie in der NetScaler Console 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
lb-vserver.ymlin diesem Beispiel das StyleBook, das Sie in StyleBook erstellt haben, um einen virtuellen Load Balancing-Server zu erstellen .
-
Bundle- Mit NetScaler Console können Sie viele 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.
Ein StyleBook, das in NetScaler Console importiert wird, wird mit einem Standardsymbol auf der StyleBooks-GUI angezeigt. Sie können diese Standardsymbole mit Ihren eigenen Bildern anpassen.
Vorgehensweise:
- Erstellen Sie einen Ordner mit dem Namen
resourcesunter dem Ordner, der Ihre StyleBook-YAML-Dateien enthält. - Laden Sie Ihre Icons in den
resourcesOrdner hoch.
Hinweis:
Sie können den Ordner nicht
resourcesin einen anderen Namen umbenennen.- Wenn die Symboldatei und die entsprechende StyleBook-Datei denselben Namen haben, wird das Symbol automatisch dem StyleBook zugeordnet.
- Wenn die Symboldatei und die entsprechende StyleBook-Datei (z. B. exchange.yaml und exch.png) nicht übereinstimmen, erstellen Sie eine JSON-Datei mit dem Namen ‘icon_mapping.json
resources‘ im Ordner wie folgt:
<StyleBook file name> : <icon file name> <StyleBook file1 name> : <icon file1 name> <StyleBook file2 name> : <icon file2 name> <!--NeedCopy-->Es folgt ein Beispiel für ein StyleBook-Bundle:
Der
resourcesOrdner hat 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 im StyleBook-Bundle kein Symbol verfügbar ist, wird das Standardsymbol angezeigt.
- Erstellen Sie einen Ordner mit dem Namen
-
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 den StyleBook-Inhalt zu überprüfen, klicken Sie auf Inhalt überprüfen.
Hinweis:
Stellen Sie beim Verfassen eines 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.
Hinweis:
Sie können Ihr StyleBook auch in Ihrem bevorzugten Editor erstellen und den Inhalt dann zur Validierung und zum Import in den YAML-Editor kopieren und einfügen.
-
Repositorysynchronisieren — Wenn Sie Ihre StyleBooks in GitHub erstellen und verwalten, verwenden Sie diese Option für NetScaler Console, um neue oder aktualisierte StyleBooks in Ihrem Repository zu entdecken. Wählen Sie das Repository aus, das Sie mit NetScaler Console synchronisieren möchten.
-
-
Optional können Sie ein Symbol für ein StyleBook auswählen.
Unter Anwendungen > Konfiguration > StyleBookswird das importierte StyleBook mit diesem Symbol angezeigt.
-
Klicken Sie auf Erstellen.
NetScaler Console überprüft jetzt Ihr StyleBook auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird nicht in NetScaler Console 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 Bündel von Dateien importieren, dekomprimiert NetScaler Console den komprimierten Ordner und validiert alle StyleBooks. Das Bundle wird nicht importiert, auch wenn eine StyleBook-Datei den Validierungstest nicht besteht.
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.
Die StyleBook-Seite wird geöffnet und Sie können die Werte für alle in diesem StyleBook definierten Parameter eingeben.
-
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.
Hinweis:
Um alle kürzlich erkannten NetScaler-Instanzen in NetScaler Console zu Target Instances hinzuzufügen, gehen Sie zur StyleBooks-Seite und klicken Sie auf das Aktualisierungssymbol auf der rechten Seite der Seite.
-
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 Seite “ Konfigurationen “ ein neues Konfigurationspaket angezeigt.