Benutzerdefinierte StyleBooks importieren
Nachdem Sie Ihr StyleBook erstellt haben, importieren Sie es in NetScaler ADM, um es zu verwenden. Mit NetScaler ADM können Sie ein einzelnes StyleBook in YAML-Form oder viele StyleBook-YAML-Dateien als Paket in einer .zip-, .tgz- oder .gz-Form 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 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目录将在内的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 ADM importieren.
Hinweis
Aktuell überprüft 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 derStyleBook-Definitionkö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
-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-examplenamespace:com.example.stylebooksversion:"1.2"display-name:Content Switching Configurationdescription:Example of a very simple content switching config that creates and binds an lb to a csheader:![](//m.giftsix.com/docs/de-de/citrix-application-delivery-management-service/stylebooks/how-to-create-custom-stylebooks/data:image/png;base64,…)
Operations performed by this StyleBook:
: circle"> Creates a Server : circle"> Creates a Service Group : circle"> Creates a LBVServer : circle"> Creates a CS Policy and Action schema-version:"1.0"
So importieren Sie Ihr StyleBook
Navigieren Sie in NetScaler ADM zuAnwendungen>Konfiguration>StyleBooks, und klicken Sie dann aufNeues 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.yml
StyleBook, das Sie inStyleBook erstellt haben, um einen virtuellen Load Balancing-Server zu erstellen。Bundle- Mit NetScaler ADM 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 ADM 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
resources
unter dem Ordner, der Ihre StyleBook-YAML-Dateien enthält. - Laden Sie Ihre Icons in den
resources
Ordner hoch.
Hinweis:
Sie können den
resources
Ordner nicht in 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:
: : : Es folgt ein Beispiel für ein StyleBook-Bundle:
Der
resources
Ordner hat die erforderlichen Symbole.In diesem Beispiel werden die Dateien
sharepoint.yaml
undskype.yaml
automatischsharepoint.jpeg
undskype.png
zugeordnet.Um
exchange.yaml
exch.png
zuzuordnen, geben Sie Folgendes in der Dateiicon_mapping.json
an:{"exchange.yaml":"exch.png"}
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 aufInhalt ü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 unterHow To Create Your Own StyleBooks。
Hinweis:
Sie können Ihr StyleBook auch in Ihrem bevorzugten Editor erstellen und dann den Inhalt kopieren und zur Validierung und zum Import in den YAML-Editor einfügen.
Sync Repository- Wenn Sie Ihre StyleBooks in GitHub erstellen und verwalten, verwenden Sie diese Option für NetScaler ADM, um neue oder aktualisierte StyleBooks in Ihrem Repository zu finden. Wählen Sie das Repository aus, das Sie mit NetScaler ADM synchronisieren möchten.
可选的您能象征毛皮静脉样本uswählen.
UnterAnwendungen > Konfiguration > StyleBookswird das importierte StyleBook mit diesem Symbol angezeigt.
Klicken Sie aufErstellen。
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 derStyleBooks-Seiteaufgefü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 nicht besteht.
Weitere Informationen zur StyleBook-Grammatik und Syntax der verschiedenen Konstrukte und Attribute finden Sie unterStyleBook Grammar。
Klicken Sie auf den LinkKonfiguration erstellen, um Konfigurationen aus diesem StyleBook zu erstellen.
DieStyleBook-Seitewird geöffnet und Sie können die Werte für alle in diesem StyleBook definierten Parameter eingeben.
您死erforderlichen Werte für die Parameter an.
Im folgenden Beispiel wird
Geben Sie denAnwendungsnamenund die erforderliche负载Balancer-IP-Adressean.
Wählen Sie denLoadBalancing-Algorithmusaus der Liste. Standardmäßig istROUNDROBINausgewählt.
Wählen Sie unterZielinstanzendie 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 entdeckten NetScaler-Instanzen in NetScaler ADM zuTarget Instanceshinzuzufügen, gehen Sie zur SeiteStyleBooksund klicken Sie auf das Aktualisierungssymbol rechts auf der Seite.
Wenn Sie vor der Bereitstellung der Konfiguration an den NetScaler (NITRO) -Konfigurationsobjekten testen möchten, klicken Sie aufTrockenlauf。
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 aufErstellen, 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.