Citrix Application Delivery Management

Importieren von benutzerdefinierten StyleBooks

Nachdem Sie Ihr StyleBook erstellt haben, müssen Sie es in Citrix Application Delivery Management (ADM) importieren, um es zu verwenden. Mit Citrix 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 Citrix ADM -System validiert Ihre StyleBooks beim Import. Das StyleBook kann nun zum Erstellen von Konfigurationen verwendet werden.

Citrix 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 Citrix ADM GUI selbst zu validieren. Sie müssen kein separates Tool für diese Validierungsprüfungen verwenden. Der Inhalt wird nach YAML-Standards validiert und jede Abweichung wird hervorgehoben. Anschließend können Sie den Inhalt korrigieren und versuchen, das StyleBook in Citrix ADM zu importieren. Der integrierte YAML-Editor bietet zwei Vorteile beim Schreiben Ihres eigenen StyleBook.

  • 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

  1. Navigieren Sie in Citrix ADM zu Anwendungen > Konfiguration > StyleBooks, und klicken Sie dann auf Neues StyleBook importieren.

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

      Importieren einer StyleBook-Datei

    • Bundle - Mit Citrix 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.

      Importieren eines StyleBook-Pakets

      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>
        <!--NeedCopy-->
        

      Es folgt ein Beispiel für ein StyleBook-Bundle:

      StyleBook-Paket mit Icons

      Der resources Ordner enthält die erforderlichen Symbole.

      Icons im Ressourcen-Ordner

      In diesem Beispiel werden sharepoint.yaml und skype.yaml Dateien automatisch sharepoint.jpeg und skype.png zugeordnet.

      Um exchange.yaml zuzuordnen exch.png, geben Sie Folgendes in der icon_mapping.json Datei an:

       {
       "exchange.yaml":"exch.png"
       }
       <!--NeedCopy-->
      

      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>
       <!--NeedCopy-->
      

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

      Erstellen eines StyleBook mit ADM YAML Editor

    • Sync Repository - Diese Option listet die Repositories auf, die ADM hinzugefügt wurden. Wählen Sie das Repository aus, das Sie mit ADM synchronisieren möchten.

      Synchronisieren von Repositories in ADM

    Hinweis

    Sie können den Inhalt auch aus einer StyleBook YAML-Datei kopieren und in den YAML-Editor einfügen.

  3. Optional können Sie ein Symbol für ein StyleBook auswählen.

    In Anwendungen > StyleBookwird das importierte StyleBook mit diesem Symbol angezeigt.

    StyleBook mit einem Symbol importieren

  4. Klicken Sie auf Erstellen.

    Citrix ADM überprüft jetzt Ihr StyleBook auf alle syntaktischen und semantischen Fehler gemäß der StyleBook-Grammatik. Ihr StyleBook wird bei Fehlern nicht in Citrix ADM importiert.

    Wenn keine Fehler auftreten, wird das StyleBook erfolgreich importiert und auf der Seite StyleBooks aufgeführt. Sie können das StyleBook anhand des Anzeigenamens identifizieren, den Sie im Kopfbereich des StyleBook definiert haben.

    Beispiel StyleBook

    Hinweis

    Wenn Sie ein Paket von Dateien importieren, dekomprimiert Citrix 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.

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

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

      Beispiel einer Konfigurationsbereitstellung

  7. Wählen Sie unter Zielinstanzendie IP-Adresse der Citrix ADC-Instanz aus, in der Sie die Konfiguration bereitstellen möchten.

    Sie können die Konfiguration auch auf mehreren Citrix ADC bereitstellen, indem Sie beliebig viele Zielinstanzen angeben.

  8. Wenn Sie die Citrix ADC (NITRO) -Konfigurationsobjekte testen möchten, bevor Sie die Konfiguration bereitstellen, klicken Sie auf Dry Run.

    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 Lastenausgleichsserver war die einzige Komponente, die in diesem grundlegenden Beispiel StyleBook definiert wurde.

    Klicken Sie später auf Erstellen, um die Konfiguration auf den ausgewählten Citrix 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 Citrix ADC Instanzen in Citrix ADM zur verfügbaren Liste der Instanzen in diesem Fenster hinzuzufügen.

Ein neues Konfigurationspaket

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 benutzerdefinierten StyleBooks suchen. Diese Option ist besonders hilfreich, wenn Sie in vielen Standard-StyleBooks nach Ihren benutzerdefinierten StyleBooks suchen müssen.

So suchen Sie nach benutzerdefinierten StyleBooks

  1. Navigieren Sie in Citrix ADM zu Anwendungen > Konfigurationen > StyleBooks.

  2. Klicken Sie oben rechts auf das Suchsymbol.

  3. Wählen Sie in der Suchleiste Typ aus, und wählen Sie dann Benutzerdefiniert aus der Unterliste aus.

  4. Citrix ADM zeigt nur die benutzerdefinierten StyleBooks an.

Benutzerdefinierte StyleBooks suchen

Importieren von benutzerdefinierten StyleBooks