StyleBook-Kategorien
In NetScaler Console gibt es zwei StyleBook-Kategorien: Standard und Benutzerdefiniert, die entweder öffentlich oder privat sein können. Mit der NetScaler Console können Sie alle StyleBooks anzeigen, die im System vorhanden sind, und wie sie miteinander verbunden sind.
In diesem Dokument werden die verschiedenen Arten von StyleBooks und die folgenden Aktionen erläutert, die Sie in den StyleBooks von der NetScaler Console aus ausführen können:
- Laden Sie ein benutzerdefiniertes StyleBook herunter und nehmen Sie Änderungen vor, oder erstellen Sie ein StyleBook basierend auf einem vorhandenen.
- Blenden Sie die Standard-StyleBooks der NetScaler Console aus.
- Löschen Sie ein benutzerdefiniertes StyleBook aus der NetScaler Console.
- Fügen Sie den StyleBooks Tags hinzu.
Standard- und benutzerdefinierte StyleBooks
- Standard-StyleBookssind die StyleBooks, die mit NetScaler Console geliefert werden. Sie ermöglichen es Ihnen, Konfigurationen zu erstellen, 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 StyleBookssind Ihre eigenen StyleBooks, die Sie in die 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, können als öffentliche StyleBooks kategorisiert werden. Das heißt, sie sind alle für Ihre direkte Verwendung verfügbar, um Konfigurationen über die NetScaler Console GUI und die APIs zu erstellen.
Einige StyleBooks werden jedoch als Bausteine für andere StyleBooks verwendet. Solche StyleBooks sind als privatgekennzeichnet. Die privaten StyleBooks können nicht direkt zum Erstellen von Konfigurationspaketen über die NetScaler Console-GUI verwendet werden. Sie können diese StyleBooks jedoch weiterhin in der NetScaler Console anzeigen und anzeigen. Um Ihre benutzerdefinierten StyleBooks als privatzu markieren, setzen Sie das private Attribut im StyleBook auf true. Sie können weiterhin private StyleBooks verwenden, um Konfigurationspakete mithilfe der NetScaler Console-APIs zu erstellen.
Beispiel für ein StyleBook, das als privat markiert ist
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 ansehen
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. Möglicherweise möchten Sie auch beide StyleBook-Typen separat anzeigen.
Wenn Sie in der NetScaler Console zu Anwendungen > Konfiguration > StyleBooks navigieren, können Sie eine Liste der StyleBooks anzeigen, die im System vorhanden sind.
Ein öffentliches Standard-StyleBook hat das folgende Symbol im Bedienfeld:
Während ein standardmäßiges privates StyleBook ein Symbol hat, das es als privates StyleBook deklariert:
Sie können zwar die Definition und die Abhängigkeiten eines privaten StyleBook anzeigen, aber Sie können mit der GUI kein Konfigurationspaket aus einem privaten StyleBook erstellen. Der Hauptzweck eines privaten StyleBook besteht darin, es als Baustein für ein anderes StyleBook zu verwenden. Die Verwendung der building-blocks-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 angezeigt wird:
Rechts oben auf der Seite sehen Sie eine Option, um den Typ der anzuzeigenden StyleBooks auszuwählen. 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. Bei der Suche wird die Groß- und Kleinschreibung nicht berücksichtigt.
Benutzerdefinierte StyleBooks herunterladen
Um die benutzerdefinierten StyleBooks von der NetScaler Console herunterzuladen, navigieren Sie zu Anwendungen > Konfiguration Config Packs. Aktivieren Sie in der Liste der StyleBooks, die auf der rechten Seite angezeigt werden, 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 Bundle aufnehmen.
Hinweis:
Sie können benutzerdefinierte StyleBooks herunterladen, die als öffentlich oder privat markiert sind.
Hinweis
Sie können die Standard-StyleBooks der NetScaler Console nicht herunterladen. Sie können ihre Definitionen und Abhängigkeiten einsehen. Klicken Sie dazu im StyleBook-Bedienfeld auf “ Definition anzeigen” und “Abhängigkeiten anzeigen”.
Aktualisieren Sie benutzerdefiniertes StyleBook
Sie können die benutzerdefinierten StyleBook-Definitionen über die NetScaler Console-GUI selbst aktualisieren. Sie können das StyleBook also ändern, ohne seine Version zu ändern. Sie können auch die aus einem StyleBook-Bundle importierten Definitionen aktualisieren.
Wichtig
Bevor Sie die StyleBook-Definition über die NetScaler Console-GUI aktualisieren, stellen Sie sicher, dass die StyleBook-Definition keine abhängigen StyleBooks enthält.
Sie können eine StyleBook-Definition aktualisieren, die Konfigurationspakete enthält. Stellen Sie sicher, dass die StyleBook-Definition abwärtskompatibel ist. Daher werden alle Parameter im aktualisierten StyleBook beibehalten und die neu hinzugefügten Parameter werden als optional angezeigt.
-
Navigieren Sie zu Anwendungen > Konfiguration > StyleBooks.
-
Wählen Sie die Registerkarte Benutzerdefinierte 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 zu sehen.
Benutzerdefinierte StyleBooks löschen
Sie können ein benutzerdefiniertes StyleBook auch löschen, indem Sie auf die Schaltfläche Löschen klicken. In einem Popup-Fenster werden Sie aufgefordert, 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 entfernen, indem Sie das Kontrollkästchen aktivieren.
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.
Anzeigen von StyleBook-Abhängigkeiten
Eine wichtige und leistungsstarke Funktion von StyleBooks ist, dass sie als Bausteine für andere StyleBooks verwendet werden können.
Sie haben folgende Möglichkeiten:
-
Importieren Sie ein StyleBook in ein anderes StyleBook - Ein importiertes StyleBook wird als Typ deklariert und von den Komponenten oder Parametern des zweiten StyleBook verwendet. Sehen Sie sich die vorhandenen Standard-StyleBooks in der NetScaler Console an, um zu erfahren, wie ein StyleBook auf einem anderen StyleBook erstellt werden kann.
-
Sehen Sie sich eine grafische Anzeige an, wie StyleBooks miteinander verbunden sind . Diese Darstellung ist nützlich für komplexe StyleBooks, die mit anderen StyleBooks als Bausteine erstellt werden. Das Abhängigkeitsdiagramm ermöglicht es Ihnen, die Beziehungen und Abhängigkeiten zwischen den StyleBooks zu sehen.
Hinweis:
Sie können kein StyleBook löschen, das von anderen StyleBooks verwendet wird, da diese Aktion die vorhandenen StyleBooks beschädigen kann. Verwenden Sie die Anzeige des Abhängigkeitsdiagramms, um zu ermitteln, welche StyleBooks das Entfernen eines StyleBook verhindern.
StyleBook-Abhängigkeiten anzeigen
Navigieren Sie in der NetScaler Console zu Anwendungen > Konfiguration > StyleBooks. Auf der StyleBooks-Seite werden alle StyleBooks angezeigt, die für Ihre Verwendung in NetScaler Console verfügbar sind. Scrollen Sie nach unten und finden Sie Ihr StyleBook. Klicken Sie auf Abhängigkeiten anzeigen, um die abhängigen StyleBooks anzuzeigen.
Abhängigkeiten weiterleiten
Auf der Registerkarte Abhängigkeiten weiterleiten 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 StyleBooks, die miteinander verbunden sind, hervorgehoben. Sie können auch auf ein StyleBook klicken, um die Definition dieses StyleBook anzuzeigen.
Umgekehrte Abhängigkeiten
Auf der Registerkarte Abhängigkeiten umkehren können Sie die StyleBooks, die Ihr StyleBook verwenden, grafisch anzeigen. Wenn Sie den Pfeilen folgen, können Sie sehen, dass alle StyleBooks in der Anzeige auf Ihr StyleBook zeigen. Einige StyleBooks verwenden möglicherweise direkt das StyleBook und einige StyleBooks verwenden das StyleBook möglicherweise über ein anderes StyleBook.
Überprüfen Sie die NetScaler-Konfiguration anhand von Konfigurationspaketen
Sie können die von einem StyleBook-Konfigurationspaket vorgenommenen Änderungen mit der aktuellen NetScaler-Konfiguration vergleichen. Mit diesem Vergleich können Sie Folgendes tun:
-
Ermitteln Sie die Konfigurationsabweichung zwischen dem StyleBook-Konfigurationspaket und der NetScaler-Konfiguration.
-
Identifizieren Sie alle geänderten und gelöschten Objekte auf dem NetScaler, die die vom Config Pack vorgenommenen Änderungen nicht anzeigen.
Gehen Sie wie folgt vor, um die Config-Pack-Änderungen mit der NetScaler-Instanzkonfiguration zu vergleichen:
-
Navigieren Sie zu Anwendungen > Konfiguration > Config Packs.
-
Klicken Sie auf Konfigurationsüberprüfung.
Auf der Seite “Konfigurationsüberwachung” werden die erstellten und überwachten Objekte angezeigt.
Hinweis:
Beim Aktualisieren eines StyleBook-Konfigurationspakets, das auf einer NetScaler-Instanz bereitgestellt wird, kann es Unterschiede zu seinem Bereitstellungsstatus aufweisen. Und das Config Pack-Update schlägt fehl. Die StyleBook-Engine gleicht diese Unterschiede automatisch ab und aktualisiert das Konfigurationspaket.
Laden Sie das Support-Paket eines Konfigurationspakets herunter
Das Support-Paket eines Config Packs hilft dem technischen Support-Team von Citrix, Probleme mit dem Config Pack anzuzeigen, zu analysieren und zu beheben. Führen Sie die folgenden Schritte aus, um das Support-Paket herunterzuladen:
-
Gehen Sie zu Anwendungen > Konfiguration > Config Packs.
-
Wählen Sie das Konfigurationspaket aus, in das Sie das Support-Paket herunterladen möchten.
-
Klicken Sie unter Aktion auswählenauf Support-Paket.
Sie können das Bundle im Zip- oder TGZ-Dateiformat komprimieren.
-
Geben Sie optional die Passphrase an, um die Bundle-Datei zu verschlüsseln.
-
Klicken Sie auf Download.
Erstellen Sie ein Tag für das StyleBook
Sie können jedem StyleBook in der 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 verwenden, wenn Sie in NetScaler Console nach StyleBooks suchen oder filtern.
So fügen Sie dem StyleBook ein Tag hinzu:
-
Navigieren Sie zu Anwendungen > Konfiguration > StyleBooks.
-
Wählen Sie im StyleBook Tags aus, für das Sie Tags hinzufügen möchten.
Sie können allen Arten von StyleBooks Tags hinzufügen.
-
Geben Sie die erforderlichen Schlüssel- und Wert-Informationen an, mit denen Sie das StyleBook filtern können.
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 einen Schlüssel und einen Wert aus der Liste aus. Die StyleBooks, die dem angegebenen Tag entsprechen, werden angezeigt.
Im Folgenden finden Sie ein Beispiel für die StyleBooks, die ein Tag wo key=team und haben value=bizdata:
Sie können die StyleBook-Tags dem Konfigurationspaket zuordnen. Sie können die Konfigurationspakete also mithilfe der StyleBook-Tags selbst durchsuchen.
Wenn Sie ein Konfigurationspaket erstellen, verwenden Sie eine der folgenden Optionen im Abschnitt Tag Association :
-
Ordnen Sie der Konfiguration alle aktuellen und zukünftigen StyleBook-Tags zu — Diese Option ordnet alle StyleBook-Tags einem Konfigurationspaket zu. Es stellt auch sicher, dass Sie die neuen Tags verknüpfen, die Sie den StyleBooks in Zukunft hinzufügen könnten.
-
Tags auswählen — Diese Option zeigt die Tags des ausgewählten StyleBook an. Sie können die erforderlichen StyleBook-Tags auswählen und einem Konfigurationspaket zuordnen.
StyleBook klonen
Als Administratoren können Sie ein Duplikat eines StyleBook zusammen mit den zugehörigen StyleBooks erstellen. Sie können dieses Paket dann für Anpassungen verwenden, z. B. zum Aktualisieren der Abschnitte parameters und components.
So klonen Sie ein StyleBook:
-
Navigieren Sie zu Anwendungen > Konfiguration > StyleBooks.
-
Wählen Sie Clone im Standard- oder benutzerdefinierten StyleBook, das Sie duplizieren möchten.
-
Geben Sie auf der Seite Clone StyleBook 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 die NetScaler Console importiert und auf der Seite StyleBooks angezeigt.
In diesem Artikel
- Standard- und benutzerdefinierte StyleBooks
- Öffentliche und private StyleBooks
- StyleBooks ansehen
- Benutzerdefinierte StyleBooks herunterladen
- Aktualisieren Sie benutzerdefiniertes StyleBook
- Benutzerdefinierte StyleBooks löschen
- Anzeigen von StyleBook-Abhängigkeiten
- Abhängigkeiten weiterleiten
- Umgekehrte Abhängigkeiten
- Überprüfen Sie die NetScaler-Konfiguration anhand von Konfigurationspaketen
- Laden Sie das Support-Paket eines Konfigurationspakets herunter
- Erstellen Sie ein Tag für das StyleBook
- StyleBook klonen