Application Delivery Management

StyleBook-Kategorien

In NetScaler Application Delivery Management (ADM) gibt es zwei StyleBook-Kategorien. Sie sind die Standard-StyleBooks und die benutzerdefinierten StyleBooks. Unabhängig davon, ob es sich um ein Standard- oder ein benutzerdefiniertes StyleBook handelt, ist ein StyleBook entweder ein öffentliches oder ein privates In NetScaler ADM können Sie alle StyleBooks anzeigen, die im System vorhanden sind, unabhängig von ihrem Typ oder Sichtbarkeitsstatus. Sie können auch eine grafische Darstellung anzeigen, wie StyleBooks miteinander verbunden sind.

Dieses Dokument erklärt die verschiedenen Arten von StyleBooks. Außerdem werden die folgenden Aktionen erklärt, die Sie mit den StyleBooks von NetScaler ADM 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 ADM-Standard-StyleBooks aus.
  • Löschen Sie ein benutzerdefiniertes StyleBook aus NetScaler ADM.
  • Fügen Sie den StyleBooks Tags hinzu.

Standard- und benutzerdefinierte StyleBooks

  • Default StyleBooks sind die StyleBooks, die mit NetScaler ADM geliefert werden, und 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 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, können als öffentliche StyleBooks kategorisiert werden. Das heißt, sie stehen Ihnen alle direkt zur Verfügung, um Konfigurationen über die NetScaler ADM-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 verwendet werden, um ein Konfigurationspaket über die NetScaler ADM-GUI zu erstellen. Sie können diese StyleBooks jedoch weiterhin auf NetScaler ADM 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 ADM-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 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 StyleBook-Typen separat anzeigen.

Wenn Sie in NetScaler ADM zu Applications > StyleBooksnavigieren, können Sie eine Liste der StyleBooks anzeigen, die im System vorhanden sind.

Ein öffentliches Standard-StyleBook hat die folgenden Symbole in seinem Panel:

Standard-öffentliche StyleBooks

Während ein privates Standard-StyleBook ein Symbol hat, das es als privates StyleBook deklariert:

Privat Icon

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:

Standardsymbol für das öffentliche

Während ein benutzerdefiniertes privates StyleBook mit diesem Symbol angezeigt wird:

Standardsymbol für Privat

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.

Filtern von StyleBooks nach öffentlichen und privaten

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.

Suche nach StyleBooks

Benutzerdefinierte StyleBooks herunterladen

Um die benutzerdefinierten StyleBooks von NetScaler ADM herunterzuladen, navigieren Sie zu Anwendungen > StyleBooks > Configurations. 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 entweder als öffentlich oder privat gekennzeichnet sind.

Herunterladen StyleBooks

Hinweis:

Sie können die Standard-StyleBooks 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 ADM GUI selbst aktualisieren. So können Sie Änderungen am StyleBook vornehmen, ohne dessen Version zu ändern. Sie können auch die aus einem StyleBook-Bundle importierten Definitionen aktualisieren.

Wichtig:

  • Bevor Sie die StyleBook-Definition über die NetScaler ADM-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. Alle Parameter des vorhandenen StyleBook werden dann im aktualisierten StyleBook beibehalten und die hinzugefügten Parameter werden als optional angezeigt.
  1. Navigieren Sie zu Anwendungen > Konfiguration > StyleBooks.

  2. Wählen Sie die Registerkarte Benutzerdefinierte StyleBooks aus.

  3. Wählen Sie Definition aktualisieren für das StyleBook, das Sie aktualisieren möchten.

  4. Aktualisieren Sie die Definition nach Bedarf und klicken Sie auf Aktualisieren.

    Aktualisieren Sie benutzerdefiniertes StyleBook

  5. 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 NetScaler ADM entfernen möchten. Wenn das StyleBook andere benutzerdefinierte StyleBooks verwendet, können Sie diese StyleBooks entfernen, indem Sie das Kontrollkästchen aktivieren.

StyleBooks löschen

Hinweis:

Löschen Sie kein benutzerdefiniertes StyleBook, wenn es abhängige StyleBooks in NetScaler ADM hat. Andernfalls würde es 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 können ein StyleBook in ein anderes StyleBook importieren. Ein importiertes StyleBook ist als Typ deklariert und wird von Komponenten oder Parametern des zweiten StyleBook 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.

Mit NetScaler ADM können Sie eine grafische Darstellung der Verbindung von StyleBooks anzeigen. Diese Darstellung ist besonders nützlich für komplexe StyleBooks, die mit anderen StyleBooks als Bausteine erstellt werden. Wenn Sie das Abhängigkeitsdiagramm betrachten, ist es möglich, die Beziehungen und Abhängigkeiten zwischen mehreren StyleBooks zu sehen.

Ein von anderen StyleBooks verwendetes StyleBook kann nicht aus dem System entfernt werden, da es die vorhandenen StyleBooks beschädigen würde. Mithilfe der Abhängigkeitsdiagrammanzeige können Sie ermitteln, welche StyleBooks das Entfernen eines StyleBook verhindern.

StyleBook-Abhängigkeiten anzeigen

Navigieren Sie in NetScaler ADM zu Applications > StyleBooks. Auf der StyleBooks-Seite werden alle StyleBooks angezeigt, die für Ihre Verwendung in NetScaler ADM verfügbar sind. Scrollen Sie nach unten und finden Sie Ihr StyleBook. Die StyleBook-Kachel zeigt Links zum Erstellen einer Konfiguration, zum Anzeigen der StyleBook-Definition und zum Anzeigen der StyleBook-Abhängigkeiten an. Klicken Sie auf Abhängigkeiten anzeigen.

Vorwärtsabhängigkeiten

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 die StyleBook-Namen klicken, um die Definition dieses StyleBooks anzuzeigen.

Abhängigkeiten weiterleiten

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.

Umgekehrte Abhängigkeiten

Überprüfen Sie die ADC-Konfiguration anhand des Konfigurationspakets

Sie können die von einem StyleBook-Konfigurationspaket vorgenommenen Änderungen 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.

Gehen Sie wie folgt vor, um die Änderungen des Konfigurationspakets mit den ADC-Konfigurationen zu vergleichen:

  1. Navigieren Sie zu Anwendungen > StyleBooks > Konfigurationen.

  2. Klicken Sie auf Konfigurationsüberprüfung.

    Auf der Seite Konfigurationsüberwachung werden die erstellten und geprüften Objekte angezeigt.

    Überprüfen Sie die ADC-Konfiguration anhand des Konfigurationspakets

Laden Sie das Support-Paket eines Konfigurationspakets herunter

Das Support-Paket eines Konfigurationspakets hilft dem technischen Support-Team von NetScaler, Probleme mit dem Konfigurationspaket anzuzeigen, zu analysieren und zu beheben.

  1. Wählen Sie unter Anwendungen > Konfiguration > Config Packs > Support Bundlesein Konfigurationspaket aus. Klicken Sie auf Download.

  2. Geben Sie auf der Seite Support-Paket herunterladen Folgendes an:

    • Verschlüsseln Sie die Konfigurationsdaten mit einer Passphrase — Wählen Sie diese Option, wenn Sie eine Passphrase zum Verschlüsseln der Bundle-Datei angeben möchten.

    • Passphrase — Geben Sie eine Passphrase an, um das Exportpaket zu verschlüsseln. Diese Passphrase schützt die sensiblen Daten eines Konfigurationspakets. Die Passphrase muss mindestens 20 Zeichen lang sein.

    • Dateityp komprimieren — Sie können das Paket im ZIP- oder TGZ-Dateiformat komprimieren.

  3. Klicken Sie auf Download.

Supportpaket

Erstellen Sie ein Tag für das StyleBook

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, während Sie in NetScaler ADM nach StyleBooks suchen oder filtern.

So fügen Sie dem StyleBook ein Tag hinzu:

  1. Navigieren Sie zu Applications > StyleBooks.

  2. Wählen Sie im StyleBook Tags aus, für das Sie Tags hinzufügen möchten.

    Tags für ein StyleBook

    Sie können allen Arten von StyleBooks Tags hinzufügen.

  3. 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

    Erstellen eines Tags für ein StyleBook

    Um weitere Tags hinzuzufügen, klicken Sie auf +.

  4. Klicken Sie auf Erstellen.

Um StyleBooks mithilfe von Tags in der Suchleiste zu filtern, klicken Sie 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.

Wie benutzt man Schlagwörter

Im Folgenden finden Sie ein Beispiel für die StyleBooks, die ein Tag wo key=team und haben value=bizdata:

Beispiel für ein Tag

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.

Ordnen Sie StyleBook-Tags seinem Konfigurationspaket zu

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:

Der Unterschied zwischen den beiden Ausgaben zeigt die CLI-Befehle an, mit denen Sie jedes StyleBook mithilfe der NetScaler-CLI konfigurieren können.