StyleBook-Kategorien
Es gibt zwei StyleBook-Kategorien in NetScaler® Application Delivery Management (ADM): Standard-StyleBooks und benutzerdefinierte StyleBooks. Ob Standard oder benutzerdefiniert, ein StyleBook ist entweder ein öffentliches oder ein privates StyleBook. In NetScaler ADM können Sie alle im System vorhandenen StyleBooks anzeigen, unabhängig von ihrem Typ oder Sichtbarkeitsstatus. Sie können auch eine grafische Darstellung der Verbindungen zwischen den StyleBooks anzeigen.
Dieses Dokument erläutert die verschiedenen Typen von StyleBooks. Außerdem werden die folgenden Aktionen beschrieben, die Sie mit den StyleBooks in NetScaler ADM ausführen können:
-
Ein benutzerdefiniertes StyleBook herunterladen und Änderungen vornehmen oder ein StyleBook basierend auf einem vorhandenen erstellen.
-
Standard-StyleBooks von ADM ausblenden.
-
Ein benutzerdefiniertes StyleBook aus NetScaler ADM löschen.
-
Tags zu den StyleBooks hinzufügen.
Related information
Standard- und benutzerdefinierte StyleBooks
-
Standard-StyleBooks sind die StyleBooks, die mit NetScaler ADM ausgeliefert werden und mit denen Sie Konfigurationen erstellen können, die Sie auf Ihren NetScaler-Instanzen bereitstellen können. Sie können Standard-StyleBooks nicht löschen, aber Sie können sie in der ADM-GUI ausblenden.
-
Benutzerdefinierte StyleBooks sind Ihre eigenen StyleBooks, die Sie in NetScaler ADM importiert haben.
Sowohl Standard- als auch benutzerdefinierte StyleBooks können entweder öffentlich oder privat sein.
Öffentliche und private StyleBooks
StyleBooks, aus denen Sie Konfigurationspakete erstellen können, werden als öffentliche StyleBooks kategorisiert. Das heißt, sie stehen Ihnen alle zur direkten Verwendung zur Verfügung, um Konfigurationen über die NetScaler ADM GUI und APIs zu erstellen.
Einige StyleBooks werden jedoch als Bausteine für andere StyleBooks verwendet. Solche StyleBooks sind als privat gekennzeichnet. Die privaten StyleBooks können nicht direkt verwendet werden, um Konfigurationspakete über die NetScaler ADM GUI zu erstellen. Sie können diese StyleBooks jedoch weiterhin in NetScaler ADM anzeigen. Um eines Ihrer benutzerdefinierten StyleBooks als privat zu kennzeichnen, setzen Sie das private Attribut im StyleBook auf true. Sie können private StyleBooks weiterhin verwenden, um Konfigurationspakete mithilfe der NetScaler ADM APIs zu erstellen.
Beispiel eines als privat gekennzeichneten StyleBooks
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true
StyleBooks anzeigen
Die Anzahl der StyleBooks – sowohl Standard- als auch private – nimmt in NetScaler ADM zu. Möglicherweise möchten Sie nach dem bestimmten StyleBook suchen, auf das Sie zugreifen möchten. Möglicherweise möchten Sie auch beide Arten von StyleBooks separat anzeigen.
In NetScaler ADM können Sie, wenn Sie zu Applications > StyleBooks navigieren, eine Liste der im System vorhandenen StyleBooks anzeigen.
Ein öffentliches Standard-StyleBook hat das folgende Symbol auf seinem Panel:
Wohingegen ein privates Standard-StyleBook ein Symbol hat, das es als privates StyleBook kennzeichnet:
Während Sie die Definition und Abhängigkeiten eines privaten StyleBooks anzeigen können, können Sie keine Konfigurationspakete aus einem privaten StyleBook über die GUI erstellen. Der Hauptzweck eines privaten StyleBooks besteht darin, es als Baustein für ein anderes StyleBook zu verwenden. Die Verwendung von Baustein-StyleBooks fördert die Wiederverwendung gängiger Konfigurationsmuster.
Ein benutzerdefiniertes öffentliches StyleBook hat ein anderes Symbol, wie in der folgenden Abbildung gezeigt:
Während ein benutzerdefiniertes privates StyleBook mit diesem Symbol erscheint:
Oben rechts auf der Seite sehen Sie eine Option zur Auswahl des anzuzeigenden StyleBook-Typs. Es gibt drei Optionen – alle, öffentliche oder private StyleBooks. Klicken Sie auf eine der Optionen.
Sie können auch nach einem bestimmten StyleBook suchen, indem Sie auf das Suchsymbol klicken. Sie können nach Namen, Namespaces und Versionsattributen oder einer Kombination dieser Optionen suchen. Die Suchoperation unterscheidet nicht zwischen Groß- und Kleinschreibung.
Benutzerdefinierte StyleBooks herunterladen
Um die benutzerdefinierten StyleBooks von NetScaler ADM herunterzuladen, navigieren Sie zu Applications > StyleBooks > Configurations. Wählen Sie in der Liste der StyleBooks, die im rechten Bereich angezeigt werden, die Option zum Herunterladen der benutzerdefinierten StyleBooks aus. Klicken Sie auf Download. Wenn das StyleBook abhängige benutzerdefinierte StyleBooks enthält, können Sie die abhängigen StyleBooks in das heruntergeladene Paket aufnehmen.
Hinweis:
Sie können benutzerdefinierte StyleBooks herunterladen, die entweder als öffentlich oder privat gekennzeichnet sind.
Hinweis:
Sie können die Standard-StyleBooks von NetScaler ADM nicht herunterladen. Sie können deren Definitionen und Abhängigkeiten anzeigen. Klicken Sie dazu auf die Links View Definition und View Dependencies im StyleBook-Panel.
Benutzerdefinierte StyleBooks löschen
Sie können ein benutzerdefiniertes StyleBook auch löschen, indem Sie auf die Schaltfläche Delete klicken. Ein Pop-up-Fenster fordert Sie auf zu bestätigen, ob Sie das StyleBook aus NetScaler ADM entfernen möchten. Wenn das StyleBook andere benutzerdefinierte StyleBooks verwendet, können Sie diese StyleBooks durch Aktivieren des Kontrollkästchens entfernen.
Hinweis:
Löschen Sie kein benutzerdefiniertes StyleBook, wenn es abhängige StyleBooks in NetScaler ADM hat. Andernfalls würden die vorhandenen StyleBooks beschädigt.
StyleBook-Abhängigkeiten anzeigen
Ein wichtiges und leistungsstarkes Merkmal von StyleBooks ist, dass sie als Bausteine für andere StyleBooks verwendet werden können. Sie können ein StyleBook in ein anderes StyleBook importieren. Ein importiertes StyleBook wird als Typ deklariert und von Komponenten oder Parametern des zweiten StyleBooks verwendet. Sie können die vorhandenen Standard-StyleBooks in NetScaler ADM untersuchen, um zu erfahren, wie ein StyleBook auf einem anderen StyleBook aufgebaut werden kann.
NetScaler ADM ermöglicht Ihnen eine grafische Darstellung der Verbindungen zwischen StyleBooks. Diese Darstellung ist besonders nützlich für komplexe StyleBooks, die aus anderen StyleBooks als Bausteine erstellt wurden. Durch die Betrachtung des Abhängigkeitsdiagramms lassen sich die Beziehungen und Abhängigkeiten zwischen mehreren StyleBooks erkennen.
Ein StyleBook, das von anderen StyleBooks verwendet wird, kann nicht aus dem System entfernt werden, da dies die bestehenden StyleBooks beschädigen würde. Mithilfe der Anzeige des Abhängigkeitsdiagramms können Sie feststellen, welche StyleBooks die Entfernung eines StyleBooks verhindern.
So zeigen Sie StyleBook-Abhängigkeiten an
Navigieren Sie in NetScaler ADM zu Applications > StyleBooks. Die Seite „StyleBooks“ zeigt alle StyleBooks an, die Ihnen in NetScaler ADM zur Verfügung stehen. Scrollen Sie nach unten und suchen Sie Ihr StyleBook. Die Kachel StyleBook zeigt Links zum Erstellen einer Konfiguration, zum Anzeigen der StyleBook-Definition und zum Anzeigen der StyleBook-Abhängigkeiten. Klicken Sie auf View Dependencies.
Vorwärtsabhängigkeiten
Auf der Registerkarte Forward Dependencies können Sie die verschiedenen Standard-StyleBooks anzeigen, die Ihr StyleBook verwendet. Folgen Sie den Pfeilen, um das StyleBook zu finden, das ein StyleBook verwendet. Wenn Sie mit der Maus auf einen der Pfeile zeigen, werden der Pfeil und die miteinander verbundenen StyleBooks hervorgehoben. Sie können auch auf die StyleBook-Namen klicken, um die Definition dieses StyleBooks anzuzeigen.
Rückwärtsabhängigkeiten
Auf der Registerkarte Reverse Dependencies können Sie grafisch die StyleBooks anzeigen, die Ihr StyleBook verwenden. Wenn Sie den Pfeilen folgen, können Sie sehen, dass alle StyleBooks in der Anzeige auf Ihr StyleBook zeigen. Einige StyleBooks verwenden das StyleBook möglicherweise direkt, und einige StyleBooks verwenden das StyleBook möglicherweise über ein anderes StyleBook.
ADC-Konfiguration mit Konfigurationspaket prüfen
Sie können die Änderungen, die ein StyleBook-Konfigurationspaket vorgenommen hat, mit der aktuellen ADC-Konfiguration vergleichen. Mit diesem Vergleich können Sie Folgendes tun:
-
Erkennen Sie die Konfigurationsabweichung zwischen dem StyleBook-Konfigurationspaket und der ADC-Konfiguration.
-
Identifizieren Sie alle geänderten und gelöschten Objekte auf dem ADC, die die vom Konfigurationspaket vorgenommenen Änderungen nicht widerspiegeln.
Um die Änderungen des Konfigurationspakets mit der ADC-Konfiguration zu vergleichen, gehen Sie wie folgt vor.
-
Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.
-
Klicken Sie auf Konfigurationsprüfung.Die Seite Konfigurationsprüfung zeigt die erstellten und geprüften Objekte an.
Einen Tag für das StyleBook erstellen
Sie können jedem StyleBook in NetScaler ADM Tags hinzufügen. Tags sind Schlüssel-Wert-Paare, mit denen Sie StyleBooks nach verschiedenen Kriterien gruppieren können. Sie können diese Tags verwenden, wenn Sie in NetScaler ADM nach StyleBooks suchen oder diese filtern.
So fügen Sie dem StyleBook einen Tag hinzu:
-
Navigieren Sie zu Anwendungen > StyleBooks.
-
Wählen Sie Tags für das StyleBook aus, dem Sie Tags hinzufügen möchten.
Sie können Tags zu allen Arten von StyleBooks hinzufügen. -
Geben Sie die erforderlichen Informationen für Schlüssel und Wert an, die Ihnen beim Filtern des StyleBooks helfen.Zum Beispiel: Schlüssel=team und Wert=bizdata
Um weitere Tags hinzuzufügen, klicken Sie auf +. -
Klicken Sie auf Erstellen.
Um StyleBooks mithilfe von Tags zu filtern, klicken Sie in der Suchleiste auf Tags und wählen Sie Schlüssel und Wert aus der Liste aus. Die StyleBooks, die dem angegebenen Tag entsprechen, werden angezeigt.
Das Folgende ist ein Beispiel für die Suche nach StyleBooks, die einen Tag haben, bei dem
key=team und value=bizdata:
Sie können die StyleBook-Tags dem zugehörigen Konfigurationspaket zuordnen. So können Sie die Konfigurationspakete mithilfe der StyleBook-Tags selbst durchsuchen.
Wenn Sie ein Konfigurationspaket erstellen, verwenden Sie eine der folgenden Optionen im Abschnitt Tag-Zuordnung:
-
Alle vorhandenen und zukünftigen StyleBook-Tags der Konfiguration zuordnen – Diese Option ordnet alle StyleBook-Tags einem Konfigurationspaket zu. Sie stellt auch sicher, dass neue Tags zugeordnet werden, die Sie möglicherweise in Zukunft zu den StyleBooks hinzufügen.
-
Tags auswählen – Diese Option zeigt die Tags des ausgewählten StyleBooks an. Sie können die erforderlichen StyleBook-Tags auswählen und einem Konfigurationspaket zuordnen.
So konfigurieren Sie ein StyleBook mithilfe von CLI-Befehlen
Wenn Sie ein StyleBook mithilfe von CLI-Befehlen konfigurieren möchten, gehen Sie wie folgt vor:
-
Führen Sie den Befehl
show ns runningConfigin NetScaler aus. -
Erstellen Sie in NetScaler ADM eine Konfiguration entweder mit Standard-StyleBooks, Business-Anwendungs-StyleBooks oder benutzerdefinierten StyleBooks.
-
Führen Sie den Befehl
show ns runningConfigin NetScaler erneut aus.
Der Unterschied zwischen den beiden Ausgaben zeigt die CLI-Befehle an, die Sie verwenden können, um ein beliebiges StyleBook mithilfe der NetScaler CLI zu konfigurieren.