StyleBook-Konfiguration

Migrieren der Citrix ADC Anwendungskonfiguration mit dem StyleBooks Configuration Builder

Der StyleBooks Configuration Builder wird verwendet, um eine vorhandene ADC-Konfiguration auf StyleBooks zu migrieren. Diese Funktion automatisiert auch die Migration der Anwendungskonfiguration von einer Citrix ADC-Instanz zu einer anderen Instanz oder einer Autoscale-Gruppe.

Der Configuration Builder bietet eine strukturierte Anwendung StyleBook, die für alle Varianten der ADC-Konfiguration verwendet werden kann. Diese Funktion hilft Ihnen, mit StyleBooks zu beginnen, ohne umfassende Kenntnisse der StyleBooks-Grammatik und -Konstrukte zu haben. Andernfalls ist das Wissen über StyleBooks Grammatik und Konstrukte notwendig, um ein StyleBook zu erstellen.

Der Configuration Builder erstellt auch ein Konfigurationspaket, das dieselbe ADC-Konfiguration für eine neue ADC-Instanz widerspiegelt. Mit diesem Konfigurationspaket kann die anfängliche ADC-Konfiguration von einer ADC-Instanz auf eine andere ADC-Instanz dupliziert werden. Die ursprüngliche Konfigurationsquelle kann eine der folgenden sein:

  • Eine Citrix ADC-Instanz: Geben Sie die Instanz an, in der die zu duplizierende Anwendungskonfiguration gehostet wird.

    Der Configuration Builder konvertiert die ADC-Konfiguration in StyleBook und das Konfigurationspaket, auch wenn Sie die Zielinstanz nicht angeben. Sie können dieses Konfigurationspaket später verwenden, um die ADC-Konfiguration auf andere ADC-Instanzen zu migrieren.

    Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, wird das Konfigurationspaket auf der Seite Netzwerk > AutoScale-Gruppe angezeigt. Auf der Registerkarte “ Konfiguration “.

  • Eine Reihe von CLI-Befehlen: Fügen Sie die Konfiguration vonns.conf oder einApplication config.

Der Configuration Builder identifiziert die Liste der unterschiedlichen Anwendungen, die in die Quellkonfiguration eingebettet sind. Wenn Sie die gewünschte Anwendungskonfiguration auswählen, extrahiert der Configuration Builder die CLI-Befehle für die ausgewählte Anwendung. Diese CLI-Befehle werden aus der Quellkonfiguration extrahiert. Außerdem werden die Bereitstellungs- und Konfigurationsattribute identifiziert, die möglicherweise Ihre Eingabe erfordern.

  • IP-Adresse/Ports - Sie können die IP-Adresse und den Port der virtuellen Server, Dienste und Servicegruppenmitglieder von der ursprünglichen Konfiguration aus anzeigen und bearbeiten.

  • Konfigurationsdateien/Secrets - Bei diesen Attributen können in der Quellkonfiguration angegebene Kennwörter oder Zertifikate sein.

Nachdem Sie die erforderlichen Informationen angegeben haben, starten Sie mit der Migration oder Duplizierung der Anwendungskonfiguration auf einer ADC-Zielinstanz.

Workflow für StyleBooks Configuration Builder

Nach der Erstellung und Migration von Anwendungen wird ein Konfigurationspaket in Citrix ADM mit StyleBook adc_nitro_applicationerstellt. Dieses StyleBook wird basierend auf den ADC NITRO-Ressourcen erstellt. Dieses Konfigurationspaket stellt die Anwendungskonfiguration auf der ADC-Zielinstanz dar. Um das erstellte Konfigurationspaket anzuzeigen, navigieren Sie zu Anwendungen > Konfiguration > Confg Packs.

Unterstützte Citrix ADC Funktionen

Der StyleBook Configuration Builder erkennt und unterstützt die folgenden Citrix ADC-Funktionen in der Quellkonfiguration:

  • Content Switching
  • Lastausgleich
  • Überwachen
  • SSL Offloading
  • Ratenlimit
  • Rewrite
  • Responder
  • Firewall für Webanwendungen (WAF)
  • Bot-Verwaltung
  • Steuerung der Kompression

Erstellen Sie ein StyleBook, um die Citrix ADC-Anwendungskonfiguration zu migrieren

Das folgende Verfahren besteht darin, ein StyleBook zu erstellen, das die Citrix ADC-Anwendungsmigration in Citrix ADM migriert:

  1. Navigieren Sie zu Anwendungen > Konfiguration > Confg Packs.

  2. Klicken Sie auf ADC-Konfiguration migrieren.

  3. Klicken Sie auf Erste Schritte.

  4. Wählen Sie unter Konfiguration angebendie Konfigurationsquelle aus:

    • Von einem ADC importieren: Diese Option erkennt die aktiven Anwendungen auf der ausgewählten ADC-Instanz.

    • Import mit CLI-Befehlen: Diese Option analysiert die CLI-Befehle und extrahiert die Anwendungen aus den CLI-Befehlen.

  5. Geben Sie die Quell-ADC-Instanz an, von der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.

    Um die Anwendungskonfiguration auf eine Autoscale-Gruppe zu migrieren, stellen Sie sicher, dass die folgenden Informationen nicht in der Quellkonfiguration enthalten sind:

    • IPset
    • Geräte-Profil
    • Protokoll
    • Port
  6. Geben Sie die Ziel-ADC-Instanz an, zu der Sie die Anwendungskonfiguration migrieren oder duplizieren möchten.

    Um eine Anwendungskonfiguration auf eine Autoscale-Gruppe zu migrieren, wählen Sie die Autoscale-Gruppe aus der Liste aus.

  7. In Anwendung definieren,

    1. Geben Sie unter Anwendungsnameden Namen der Anwendung an.

      Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, geben Sie die folgenden Autoscale-Parameter an:

      • Zugriffstyp - Sie können die Citrix ADM Autoscaling-Lösung sowohl für externe als auch für interne Anwendungen verwenden. Wählen Sie den erforderlichen Anwendungszugriffstyp aus.

      • Domänenname - Geben Sie den Domänennamen einer Anwendung an. Diese Option ist nur anwendbar, wenn Sie Benutzerdefinierter FQDN-Typ auswählen.

      • Zone der Domäne - Wählen Sie den Zonennamen einer Anwendung aus der Liste aus. Diese Option ist nur anwendbar, wenn Sie Benutzerdefinierter FQDN-Typ auswählen.

        Dieser Domänen- und Zonenname leitet zu den virtuellen Servern in Azure um. Wenn Sie beispielsweise eine Anwendung in app.example.comhosten, ist appder Domänenname und example.comder Zonenname.

    2. Wählen Sie die virtuellen Server aus, die Sie migrieren möchten.

      Wählen Sie virtuelle Server aus, die Sie migrieren möchten

    3. Klicken Sie auf Weiter.

  8. Überprüfen Sie unter Äquivalente CLI-Befehledie Befehle und klicken Sie auf Weiter.

    Diese Befehle sind spezifisch für die ausgewählte Anwendungskonfiguration.

    Hinweis

    Sie können die Konfiguration bei Bedarf auch hinzufügen oder bearbeiten.

  9. In Bereitstellungsattributekönnen Sie die IP-Adresse und den Port der virtuellen Server, Dienste und Dienstgruppenmitglieder anzeigen und bearbeiten.

    Um die IP-Adresse und den Port zu bearbeiten, klicken Sie im Flussdiagramm auf dem virtuellen Server, Dienst oder Dienstgruppenmitglied auf das Bearbeitungssymbol.

    Bearbeiten der Bereitstellungsattribute

    Hinweis

    Wenn es sich bei der Zielinstanz um eine Autoscale-Gruppe handelt, ist die Bearbeitung der Front-End-IP-Adresse deaktiviert.

    Diese Registerkarte wird nur in den folgenden Fällen angezeigt:

    • Die Quell- und Zielinstanzen sind unterschiedlich.

    • Importieren Sie Konfigurationen mit CLI-Befehlen.

  10. Geben Sie unter Konfigurationsattributedie erforderlichen Details an und klicken Sie auf Weiter.

    Auf dieser Registerkarte werden die Geheimnisse wie Schlüssel zum Entschlüsseln von Kennwörtern und Zertifikaten aufgeführt.

    Hinweis

    Bevor Sie mit der Migration beginnen, werden die verpassten oder nicht unterstützten Konfigurationen auf einer der folgenden Registerkarten angezeigt:

    • Nicht unterstützte Konfigurationen

    • Nicht unterstützte globale Konfigurationen

    Um diese Konfigurationen erfolgreich zu migrieren, müssen Sie die fehlenden oder nicht unterstützten Konfigurationen separat auf der Zielinstanz anwenden. Klicken Sie auf Weiter.

  11. Klicken Sie in Migrateauf Migrate.

Einschränkungen

  • Die benannten Ausdrücke, die in der Quellinstanz responderhtmlpages erwähnt werden, werden nicht identifiziert. Stellen Sie sicher, dass Sie die benannten Ausdrücke und responderhtmlpages die Zielinstanz vor der Migration konfigurieren.

  • Wenn die Quelle eine Konfiguration für servicegroup und eine Monitorbindung wie folgt hat:

    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>

    Der folgende Fehler wird angezeigt:

     CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
     <!--NeedCopy-->
    

    Dieser Fehler tritt auf, weil Citrix ADC die Bindung zwischen Dienstgruppe und Monitor in einem ungültigen Format speichert. Dieses Problem wurde von Citrix ADC 12.1.52.15 Build behoben.

Migrieren der Citrix ADC Anwendungskonfiguration mit dem StyleBooks Configuration Builder