Application Delivery Management

Benutzerdefinierte StyleBooks importieren

February 5, 2024

Beitrag von:

Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in Citrix Application Delivery Management (ADM) importieren, um es zu verwenden. Mit NetScaler ADM können Sie ein einzelnes StyleBook in YAML-Form oder mehrere StyleBook-YAML-Dateien als Bundle in einem Zip-, TGZ- oder GZ-Formular importieren. Das NetScaler ADM-System validiert Ihre StyleBooks beim Import. Das StyleBook kann jetzt für die Erstellung von Konfigurationen verwendet werden.

NetScaler ADM verfügt auch über einen integrierten YAML-Editor, mit dem Sie die StyleBook YAML-Inhalte erstellen können. Der YAML-Editor ermöglicht es Ihnen, Ihre YAML-Konstrukte über die NetScaler ADM GUI selbst zu validieren. Sie müssen kein separates Tool für diese Validierungsprüfungen verwenden. Der Inhalt wird anhand der YAML-Standards validiert und jede Abweichung wird hervorgehoben. Sie können dann den Inhalt korrigieren und versuchen, das StyleBook in NetScaler ADM zu importieren. Der integrierte YAML-Editor bietet zwei Vorteile beim Schreiben Ihres eigenen StyleBooks.

Farbcodiert. Der Editor zeigt den nach YAML-Richtlinien analysierten StyleBook-Inhalt an, und die Farbcodierung hilft Ihnen, einfach zwischen den Schlüsseln und den im YAML-Inhalt definierten Werten zu unterscheiden.
YAML-Validierung. Der Inhalt wird bei der Eingabe auf YAML-Fehler überprüft und jede Abweichung wird sofort hervorgehoben. Mit dieser Validierung können Sie Text schreiben, der den YAML-Richtlinien entspricht, noch bevor Sie das StyleBook in das ADM importieren.

Hinweis

Aktuell überprüft der Editor den Inhalt gemäß den YAML-Richtlinien. Es validiert nicht auf Code Korrektheit und typografische Fehler.

So importieren Sie Ihr StyleBook

Navigieren Sie in NetScaler ADM zu Anwendungen > Konfiguration > StyleBooks, und klicken Sie dann auf Neues StyleBook importieren.
Klicken Sie auf eine der folgenden Optionen, um ein StyleBook zu importieren.
- Datei - Wählen Sie die gewünschte Datei oder das Bündel von Dateien aus Ihrem lokalen Speicher aus.
  
  Hinweis
  
  Importieren Sie in diesem Beispiel das StyleBook lb-vserver.yml, das Sie in StyleBook zum Erstellen eines virtuellen Load Balancing-Servers erstellt haben.
- Bundle - Mit NetScaler ADM können Sie mehrere StyleBooks im YAML-Format importieren. Sie können mehrere YAML StyleBook-Dateien importieren, die im ZIP-Format (.zip) oder Tarball-Format (.tgz, .gz) komprimiert sind.
  
  Sie können jetzt jedem StyleBook im Bundle Symbole hinzufügen. Stellen Sie sicher, dass Sie den Ressourcenordner haben, der Symbole in den Formaten PNG, GIF oder JPEG enthält. Wenn der Name der Symboldatei mit dem StyleBook-Namen übereinstimmt, werden die Symbole automatisch den StyleBooks zugeordnet. Ansonsten machen Sie folgendes:
  1. Fügen Sie die icon_mapping.json Datei im Ressourcen-Ordner hinzu.
  2. Ordnen Sie StyleBooks und Symbole in der icon_mapping.json Datei wie folgt zu:
    <StyleBook file name> : <icon file name> 
  Es folgt ein Beispiel für ein StyleBook-Bundle:
  
  Der Ordner resources enthält die erforderlichen Symbole.
  
  In diesem Beispiel werden die Dateien sharepoint.yaml und skype.yaml automatisch sharepoint.jpeg und skype.png zugeordnet.
  
  Um exchange.yaml exch.png zuzuordnen, geben Sie Folgendes in der Datei icon_mapping.json an:
```
 {
 "exchange.yaml":"exch.png"
 }
 
```
  Wenn Sie den defaulticon Eintrag angeben, werden die StyleBooks dem Standardsymbol zugeordnet, es sei denn, sie werden einem anderen Symbol zugeordnet.
```
 defaulticon: <icon file name>
 
```
  In Application > StyleBookswerden die importierten StyleBooks mit den zugeordneten Symbolen angezeigt.
- Raw - Verfassen Sie den Inhalt Ihres StyleBook im YAML-Editor.
  
  Sie können den StyleBook-Inhalt überprüfen, um die StyleBook-Grammatikfehler zu überprüfen Um StyleBook-Inhalte zu überprüfen, klicken Sie auf Inhalt überprüfen.
  Hinweis: Achten Sie
  
  beim Erstellen von StyleBook darauf, die folgenden Konzepte zu kennen:
  - NITRO API
  - YAML
  Weitere Informationen zum Schreiben eigener StyleBooks finden Sie unter How To Create Your Own StyleBooks.
- Repository synchronisieren — Diese Option listet die zu ADM hinzugefügten Repositorys auf. Wählen Sie das Repository aus, das Sie mit ADM synchronisieren möchten.
Hinweis

Sie können den Inhalt auch aus einer StyleBook YAML-Datei kopieren und in den YAML-Editor einfügen.
Optional können Sie ein Symbol für ein StyleBook auswählen.

Unter Applications > StyleBookwird das importierte StyleBook mit diesem Symbol angezeigt.
Klicken Sie auf Erstellen.

NetScaler ADM überprüft jetzt Ihr StyleBook auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird nicht in NetScaler ADM importiert, wenn Fehler auftreten.

Wenn keine Fehler vorliegen, wurde das StyleBook erfolgreich importiert und auf der StyleBooks-Seite aufgeführt. Sie können das StyleBook anhand des Anzeigenamens identifizieren, den Sie im Header-Bereich des StyleBook definiert haben.

Hinweis:

Wenn Sie ein Dateipaket importieren, dekomprimiert NetScaler ADM den gezippten Ordner und validiert alle StyleBooks. Das Bundle wird nicht importiert, auch wenn eine StyleBook-Datei den Validierungstest fehlschlägt.

Weitere Informationen zur StyleBook-Grammatik und Syntax der verschiedenen Konstrukte und Attribute finden Sie unter StyleBook Grammar.
Klicken Sie auf den Link Konfiguration erstellen, um Konfigurationen aus diesem StyleBook zu erstellen.

Das StyleBook öffnet sich als Benutzeroberflächenseite, auf der Sie die Werte für alle in diesem StyleBook definierten Parameter eingeben können.
Geben Sie die erforderlichen Werte für die Parameter an.

Im folgenden Beispiel wird
1. Geben Sie den Anwendungsnamen und die erforderliche Load Balancer-IP-Adresse an.
2. Wählen Sie den LoadBalancing-Algorithmus aus der Liste. Standardmäßig ist ROUNDROBIN ausgewählt.
Wählen Sie unter Zielinstanzendie IP-Adresse der NetScaler ADC-Instanz aus, in der Sie die Konfiguration bereitstellen möchten.

Sie können die Konfiguration auch auf mehreren NetScaler ADC bereitstellen, indem Sie beliebig viele Zielinstanzen angeben.
Wenn Sie vor der Bereitstellung der Konfiguration an den NetScaler ADC (NITRO) -Konfigurationsobjekten testen möchten, klicken Sie auf Trockenlauf.

Wenn die Konfiguration gültig ist, werden die Konfigurationsobjekte basierend auf den angegebenen Werten erstellt.

In diesem Beispiel erstellt das StyleBook nur ein Objekt vom Typ lbvserver. Dieser Load-Balancing-Server war die einzige Komponente, die in diesem einfachen Beispiel StyleBook definiert wurde.

Klicken Sie später auf Erstellen, um die Konfiguration auf den ausgewählten NetScaler ADC-Instanzen bereitzustellen.

Nachdem Sie die Konfiguration erfolgreich bereitgestellt haben, wird auf der Seite “ Konfigurationen “ ein neues Konfigurationspaket angezeigt.

Hinweis

Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich erkannte NetScaler ADC-Instanzen in NetScaler ADM zur verfügbaren Liste der Instanzen in diesem Fenster hinzuzufügen.

Benutzerdefinierte StyleBooks suchen

Mit Citrix ADM können Sie jetzt basierend auf ihrem Typ nach StyleBooks suchen. Das heißt, Sie können jetzt entweder nach Standard-StyleBooks oder nach benutzerdefinierten StyleBooks suchen. Diese Option ist besonders hilfreich, wenn Sie in vielen Standard-StyleBooks nach Ihren benutzerdefinierten StyleBooks suchen müssen.

Um nach benutzerdefinierten StyleBooks zu suchen

Navigieren Sie in NetScaler ADM zu Anwendungen > Konfigurationen > StyleBooks.
Klicken Sie oben rechts auf das Suchsymbol.
Wählen Sie in der Suchleiste Typ und dann Benutzerdefiniert aus der Unterliste aus.
Citrix ADM zeigt nur die benutzerdefinierten StyleBooks an.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

Benutzerdefinierte StyleBooks importieren

February 5, 2024

Beitrag von:

February 5, 2024

Beitrag von: