StyleBook-Kategorien
Es gibt zwei StyleBook-Kategorien in NetScaler® Application Delivery Management (ADM): Standard-StyleBooks und benutzerdefinierte StyleBooks. Unabhängig davon, ob es sich um ein Standard- oder ein benutzerdefiniertes StyleBook handelt, ist ein StyleBook 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 StyleBooks anzeigen.
Dieses Dokument erläutert die verschiedenen Arten von StyleBooks. Außerdem werden die folgenden Aktionen beschrieben, die Sie in NetScaler ADM für StyleBooks ausführen können:
- Ein benutzerdefiniertes StyleBook herunterladen und Änderungen vornehmen oder ein StyleBook basierend auf einem vorhandenen erstellen.
- ADM-Standard-StyleBooks ausblenden.
- Ein benutzerdefiniertes StyleBook aus NetScaler ADM löschen.
- Tags zu den StyleBooks hinzufügen.
Standard- und benutzerdefinierte StyleBooks
- Standard-StyleBooks sind die mit NetScaler ADM ausgelieferten StyleBooks, 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 Attribut private 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
<!--NeedCopy-->
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.
Wenn Sie in NetScaler ADM zu Applications > StyleBooks navigieren, können Sie eine Liste der im System vorhandenen StyleBooks anzeigen.
Ein öffentliches Standard-StyleBook hat das folgende Symbol auf seinem Panel:
Ein privates Standard-StyleBook hingegen hat ein Symbol, das es als privates StyleBook kennzeichnet:
Während Sie die Definition und Abhängigkeiten eines privaten StyleBooks anzeigen können, können Sie über die GUI keine Konfigurationspakete aus einem privaten StyleBook erstellen. Der Hauptzweck eines privaten StyleBooks ist die Verwendung als Baustein für ein anderes StyleBook. 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:
Ein benutzerdefiniertes privates StyleBook erscheint mit diesem Symbol:
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, Namespace und Versionsattributen oder einer Kombination dieser Optionen suchen. Die Suchoperation ist nicht zwischen Groß- und Kleinschreibung zu unterscheiden.
Benutzerdefinierte StyleBooks herunterladen
Um die benutzerdefinierten StyleBooks von NetScaler ADM herunterzuladen, navigieren Sie zu Applications > StyleBooks > Configurations. In der Liste der StyleBooks, die im rechten Bereich angezeigt werden, aktivieren Sie die Option zum Herunterladen der benutzerdefinierten StyleBooks. Klicken Sie auf Download. Wenn das StyleBook abhängige benutzerdefinierte StyleBooks hat, 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 keine NetScaler ADM-Standard-StyleBooks herunterladen. Sie können deren Definitionen und Abhängigkeiten anzeigen. Klicken Sie dazu auf die Links View Definition und View Dependencies auf dem 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 studieren, 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 unter Verwendung anderer StyleBooks als Bausteine erstellt wurden. Durch die Betrachtung des Abhängigkeitsdiagramms ist es möglich, die Beziehungen und Abhängigkeiten zwischen mehreren StyleBooks zu erkennen.
Ein StyleBook, das von anderen StyleBooks verwendet wird, kann nicht aus dem System entfernt werden, da dies die vorhandenen StyleBooks beschädigen würde. Mithilfe der Anzeige des Abhängigkeitsdiagramms können Sie identifizieren, 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
Die Registerkarte Forward Dependencies ermöglicht Ihnen die Anzeige der verschiedenen Standard-StyleBooks, 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
Die Registerkarte Reverse Dependencies ermöglicht Ihnen die grafische Anzeige der StyleBooks, 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 Konfigurationsdrift 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 Applications > StyleBooks > Configurations.
-
Klicken Sie auf Configuration Audit.
Die Seite “Configuration Audit” zeigt die erstellten und geprüften Objekte an.
Ein 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 beim Suchen oder Filtern von StyleBooks in NetScaler ADM verwenden.
So fügen Sie dem StyleBook ein Tag hinzu:
-
Navigieren Sie zu Applications > 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 Key- und Value-Informationen an, die Ihnen beim Filtern des StyleBooks helfen.
Zum Beispiel: Key=team und Value=bizdata
Um weitere Tags hinzuzufügen, klicken Sie auf +.
-
Klicken Sie auf Create.
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 ein Tag mit key=team und value=bizdata haben:
Sie können die StyleBook-Tags mit dem zugehörigen Konfigurationspaket verknüpfen. 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 Association:
-
Associate all present and future StyleBook tags with the configuration – Diese Option verknüpft alle StyleBook-Tags mit einem Konfigurationspaket. Sie stellt auch sicher, dass neue Tags, die Sie in Zukunft zu den StyleBooks hinzufügen, verknüpft werden.
-
Select tags – Diese Option zeigt die Tags des ausgewählten StyleBooks an. Sie können die erforderlichen StyleBook-Tags auswählen und mit einem Konfigurationspaket verknüpfen.
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 mithilfe von Standard-StyleBooks, Business Application 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 StyleBook mithilfe der NetScaler CLI zu konfigurieren.
In diesem Artikel
- Standard- und benutzerdefinierte StyleBooks
- Öffentliche und private StyleBooks
- StyleBooks anzeigen
- Benutzerdefinierte StyleBooks herunterladen
- Benutzerdefinierte StyleBooks löschen
- StyleBook-Abhängigkeiten anzeigen
- Vorwärtsabhängigkeiten
- Rückwärtsabhängigkeiten
- ADC-Konfiguration mit Konfigurationspaket prüfen
- Ein Tag für das StyleBook erstellen
- So konfigurieren Sie ein StyleBook mithilfe von CLI-Befehlen