StyleBook-Kategorien
In NetScaler Console gibt es zwei StyleBook-Kategorien: Standard und Benutzerdefiniert, die entweder öffentlich oder privat sein können. NetScaler Console ermöglicht es Ihnen, alle im System vorhandenen StyleBooks anzuzeigen und zu sehen, wie sie miteinander verbunden sind.
Dieses Dokument erläutert die verschiedenen Arten von StyleBooks und die folgenden Aktionen, die Sie mit den StyleBooks von NetScaler Console ausführen können:
-
Ein benutzerdefiniertes StyleBook herunterladen und Änderungen vornehmen oder ein StyleBook basierend auf einem vorhandenen erstellen.
-
Standard-StyleBooks von NetScaler Console ausblenden.
-
Ein benutzerdefiniertes StyleBook aus NetScaler Console löschen.
-
Tags zu den StyleBooks hinzufügen.
Standard- und benutzerdefinierte StyleBooks
-
Standard-StyleBooks sind die mit NetScaler Console 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 NetScaler Console-GUI ausblenden.
-
Benutzerdefinierte StyleBooks sind Ihre eigenen StyleBooks, die Sie in NetScaler Console 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 Console-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 Console-GUI zu erstellen. Sie können diese StyleBooks jedoch weiterhin in NetScaler Console anzeigen und einsehen. 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 Console-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 Console zu. Möglicherweise möchten Sie nach dem bestimmten StyleBook suchen, auf das Sie zugreifen möchten. Sie möchten möglicherweise auch beide Arten von StyleBooks separat anzeigen.
In NetScaler Console können Sie, wenn Sie zu Applications > Configuration > StyleBooks navigieren, 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:
Obwohl Sie die Definition und Abhängigkeiten eines privaten StyleBooks anzeigen können, können Sie über die GUI kein Konfigurationspaket aus einem privaten StyleBook 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:
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, Namensräumen 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 Console herunterzuladen, navigieren Sie zu Applications > Configuration > Confg Packs. Aktivieren Sie in der Liste der StyleBooks, die im rechten Bereich angezeigt werden, die Option zum Herunterladen der benutzerdefinierten StyleBooks. Klicken Sie auf Download. Wenn das StyleBook abhängige benutzerdefinierte StyleBooks enthält, können Sie die abhängigen StyleBooks in das heruntergeladene Bundle aufnehmen.
Hinweis
Sie können benutzerdefinierte StyleBooks herunterladen, die entweder als öffentlich oder privat gekennzeichnet sind.
Hinweis
Sie können die Standard-StyleBooks der NetScaler Console nicht herunterladen. Sie können deren Definitionen und Abhängigkeiten anzeigen. Klicken Sie dazu auf die Links View Definition und View Dependencies im StyleBook-Bereich.
Benutzerdefiniertes StyleBook aktualisieren
Sie können die Definitionen der benutzerdefinierten StyleBooks direkt über die NetScaler Console GUI aktualisieren. So können Sie das StyleBook ändern, ohne dessen Version zu ändern. Sie können auch die Definitionen aktualisieren, die aus einem StyleBook-Bundle importiert wurden.
Wichtig
Bevor Sie die StyleBook-Definition über die NetScaler Console GUI aktualisieren, stellen Sie sicher, dass die StyleBook-Definition keine abhängigen StyleBooks hat.
Sie können eine StyleBook-Definition aktualisieren, die Konfigurationspakete enthält. Stellen Sie sicher, dass die StyleBook-Definition abwärtskompatibel ist. So bleiben alle Parameter im aktualisierten StyleBook erhalten und die neu hinzugefügten Parameter erscheinen als optional.
-
Navigieren Sie zu Applications > Configuration > StyleBooks.
-
Wählen Sie die Registerkarte Custom StyleBooks aus.
-
Wählen Sie Definition aktualisieren für das StyleBook, das Sie aktualisieren möchten.
-
Aktualisieren Sie die Definition nach Bedarf und klicken Sie auf Aktualisieren.
-
Aktualisieren Sie die Seite, um die neuesten Änderungen anzuzeigen.
Benutzerdefinierte StyleBooks löschen
Sie können ein benutzerdefiniertes StyleBook auch löschen, indem Sie auf die Schaltfläche Löschen klicken. Ein Pop-up-Fenster fordert Sie auf, zu bestätigen, ob Sie das StyleBook aus der NetScaler Console 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 der NetScaler Console hat. Diese Aktion kann die vorhandenen StyleBooks beschädigen.
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 den Komponenten oder Parametern des zweiten StyleBooks verwendet. Zeigen Sie die vorhandenen Standard-StyleBooks in der NetScaler Console an, um zu erfahren, wie ein StyleBook auf einem anderen StyleBook aufgebaut werden kann.
-
Eine grafische Darstellung der Verbindung von StyleBooks untereinander anzeigen — Diese Darstellung ist nützlich für komplexe StyleBooks, die unter Verwendung anderer StyleBooks als Bausteine erstellt werden. Der Abhängigkeitsgraph ermöglicht es Ihnen, die Beziehungen und Abhängigkeiten zwischen den StyleBooks zu sehen.
Hinweis:
Sie können ein StyleBook, das von anderen StyleBooks verwendet wird, nicht löschen, da diese Aktion die vorhandenen StyleBooks beschädigen kann. Verwenden Sie die Abhängigkeitsgrafik, um zu ermitteln, welche StyleBooks das Entfernen eines StyleBooks verhindern.
So zeigen Sie StyleBook-Abhängigkeiten an
Navigieren Sie in NetScaler Console zu Applications > Configuration > StyleBooks. Die Seite „StyleBooks“ zeigt alle StyleBooks an, die Ihnen in NetScaler Console zur Verfügung stehen. Scrollen Sie nach unten und suchen Sie Ihr StyleBook. Klicken Sie auf View Dependencies, um die abhängigen StyleBooks anzuzeigen.
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 ein StyleBook klicken, um die Definition dieses StyleBooks anzuzeigen.
Rückwärtsabhängigkeiten
Auf der Registerkarte Reverse Dependencies können Sie die StyleBooks grafisch 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.
NetScaler-Konfiguration anhand von Konfigurationspaketen prüfen
Sie können die Änderungen, die ein StyleBook-Konfigurationspaket vorgenommen hat, mit der aktuellen NetScaler-Konfiguration vergleichen. Mit diesem Vergleich können Sie Folgendes tun:
-
Erkennen Sie die Konfigurationsabweichung zwischen StyleBook-Konfigurationspaket und NetScaler-Konfiguration.
-
Identifizieren Sie alle geänderten und gelöschten Objekte auf dem NetScaler, die die vom Konfigurationspaket vorgenommenen Änderungen nicht anzeigen.
Um die Änderungen des Konfigurationspakets mit der NetScaler-Instanzkonfiguration zu vergleichen, gehen Sie wie folgt vor:
-
Navigieren Sie zu Applications > Configuration > Config Packs.
-
Klicken Sie auf Konfigurationsprüfung.Die Seite „Konfigurationsprüfung“ zeigt die erstellten und geprüften Objekte an.NetScaler-Konfiguration anhand des Konfigurationspakets prüfen(/en-us/netscaler-console-service/media/configuration-audit-configpack.png)
Hinweis:
Beim Aktualisieren eines StyleBook-Konfigurationspakets, das auf einer NetScaler-Instanz bereitgestellt ist, kann es Unterschiede zu seinem bereitgestellten Zustand aufweisen. Und die Aktualisierung des Konfigurationspakets schlägt fehl. Die StyleBook-Engine gleicht diese Unterschiede automatisch ab und aktualisiert das Konfigurationspaket.
Support-Bundle eines Konfigurationspakets herunterladen
Das Support-Bundle eines Konfigurationspakets hilft dem technischen Supportteam von Citrix, Probleme mit Konfigurationspaketen anzuzeigen, zu analysieren und zu beheben. Führen Sie die folgenden Schritte aus, um das Support-Bundle herunterzuladen:
-
Gehen Sie zu Anwendungen > Konfiguration > Konfigurationspakete.
-
Wählen Sie das Konfigurationspaket aus, für das Sie das Support-Bundle herunterladen möchten.
-
Klicken Sie unter Aktion auswählen auf Support-Bundle.Sie können das Bundle im Zip- oder TGZ-Dateiformat komprimieren.
-
Optional können Sie die Passphrase zum Verschlüsseln der Bundle-Datei angeben.
-
Klicken Sie auf Herunterladen.
Support-Bundle(/en-us/netscaler-console-service/media/support-bundle-configpack.png)
Ein Tag für das StyleBook erstellen
Sie können jedem StyleBook in NetScaler Console 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 Console verwenden.
So fügen Sie dem StyleBook einen Tag hinzu:
-
Navigieren Sie zu Applications > Configuration > 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 Key und Value 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 einen Schlüssel und einen Wert aus der Liste aus. Die StyleBooks, die dem angegebenen Tag entsprechen, werden angezeigt.
Das Folgende ist eine Beispielsuche für StyleBooks, die einen Tag haben, bei dem
key=team und value=bizdata:
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-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 zukünftig 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.
Ein StyleBook klonen
Als Administratoren können Sie ein Duplikat eines StyleBooks zusammen mit seinen abhängigen StyleBooks erstellen. Sie können dieses Bundle dann zur Anpassung verwenden, z. B. zum Aktualisieren der Abschnitte
parameters und components.
So klonen Sie ein StyleBook:
-
Navigieren Sie zu Applications > Configuration > StyleBooks.
-
Wählen Sie Klonen für das Standard- oder benutzerdefinierte StyleBook, das Sie duplizieren möchten.
-
Geben Sie auf der Seite StyleBook klonen einen Namespace und eine Version für das StyleBook und die abhängigen StyleBooks ein. Sie können auch die vorgeschlagenen Namespaces und Versionen auswählen.
Hinweis:Das geklonte StyleBook und seine abhängigen StyleBooks müssen unterschiedliche Namespaces und Versionen haben, um sie von den vorhandenen StyleBooks zu unterscheiden. Sie können keine reservierten NetScaler Console-Namespaces für die geklonten StyleBooks verwenden. -
Klicken Sie auf Klonen. Das geklonte StyleBook-Paket wird in NetScaler Console importiert und erscheint auf der Seite StyleBooks.