Citrix Application Delivery Management service

Migrer la configuration de l’application Citrix ADC à l’aide de StyleBooks Configuration Builder

StyleBooks Configuration Builder permet de migrer une configuration ADC existante vers StyleBooks. Cette fonctionnalité automatise également la migration de la configuration de l’application d’une instance Citrix ADC vers une autre instance ou un groupe de mise à Autoscale.

Le Générateur de configuration fournit une application structurée StyleBook qui peut être utilisée pour toutes les variantes de la configuration ADC. Cette fonctionnalité vous aide à commencer avec StyleBooks sans connaissance approfondie de la grammaire et des constructions StyleBooks. Sinon, la connaissance de la grammaire et des constructions de StyleBooks est nécessaire pour créer un StyleBook.

Le Générateur de configuration crée également un pack de configuration qui reflète la même configuration ADC sur une nouvelle instance ADC. Avec ce pack de configuration, la configuration ADC initiale d’une instance ADC peut être dupliquée vers une autre instance ADC. La source de configuration initiale peut être l’une des suivantes :

  • Une instance Citrix ADC : spécifiez l’instance dans laquelle la configuration de l’application que vous souhaitez dupliquer est hébergée.

    Le Générateur de configuration convertit la configuration ADC en StyleBook et en pack de configuration même si vous ne spécifiez pas l’instance cible. Vous pouvez ultérieurement utiliser ce pack de configuration pour migrer la configuration ADC vers d’autres instances ADC.

    Si l’instance cible est un groupe Mise à Autoscale, le pack de configuration apparaît dans la page Réseau > Groupe de mise à l’échelle automatique. Sous l’onglet Configuration.

  • Un ensemble de commandes CLI : Collez la configuration à partir de ns.conf ou Application config.

Le Générateur de configuration identifie la liste des applications distinctes incorporées dans la configuration source. Lorsque vous sélectionnez la configuration de l’application qui vous intéresse, Configuration Builder extrait l’ensemble des commandes CLI de l’application sélectionnée. Ces commandes CLI sont extraites de la configuration source. Il identifie également les attributs de déploiement et de configuration qui peuvent nécessiter votre entrée.

  • Adresse IP/Ports - Vous pouvez afficher et modifier l’adresse IP et le port des serveurs virtuels, des services, des membres du groupe de services à partir de la configuration d’origine.

  • Fichiers/Secrets de configuration - Ces attributs peuvent être des mots de passe ou des certificats spécifiés dans la configuration source.

Après avoir spécifié les informations nécessaires, commencez à migrer ou à dupliquer la configuration de l’application sur une instance ADC cible.

Workflow du Générateur de configuration de StyleBooks

Après la création et la migration de l’application, un pack de configuration est créé dans Citrix ADM à l’aide de adc_nitro_application StyleBook. Ce StyleBook est créé à partir des ressources ADC NITRO. Ce pack de configuration représente la configuration de l’application sur l’instance ADC cible. Pour afficher le pack de configuration créé, accédez à Applications > StyleBooks > Configurations.

Fonctionnalités de Citrix ADC prises en charge

StyleBook Configuration Builder reconnaît et prend en charge les fonctionnalités Citrix ADC suivantes dans la configuration source :

  • Commutation de contenu
  • Équilibrage de charge
  • Surveillance
  • Déchargement SSL
  • Limitation du taux
  • Réécrire
  • Répondeur
  • Pare-feu d’application Web (WAF)

Créer un StyleBook pour migrer la configuration de l’application Citrix ADC

La procédure suivante consiste à créer un StyleBook qui migre la migration d’application Citrix ADC dans Citrix ADM :

  1. Accédez à Applications > StyleBooks > Configurations.

  2. Cliquez sur Migrer la configuration ADC.

  3. Cliquez sur Démarrer.

  4. Dans Spécifier la configuration, sélectionnez la source de configuration :

    • Importer à partir d’un ADC : cette option détecte les applications actives sur l’instance ADC sélectionnée.

    • Importer à l’aide des commandesCLI : cette option analyse les commandes CLI et extrait les applications des commandes CLI.

  5. Spécifiez l’instance ADC source à partir de laquelle vous souhaitez migrer ou dupliquer la configuration de l’application.

    Pour migrer la configuration de l’application vers un groupe Mise à l’Autoscale, assurez-vous que les informations suivantes ne sont pas incluses dans la configuration source :

    • IPset
    • Profil de l’appareil
    • Protocole
    • Port
  6. Spécifiez l’instance ADC cible vers laquelle vous souhaitez migrer ou dupliquer la configuration de l’application.

    Pour migrer une configuration d’application vers un groupe Mise à Autoscale, sélectionnez le groupe Mise à l’Autoscale dans la liste.

  7. Dans Définir une application,

    1. Dans Nom de l’application, spécifiez le nom de l’application.

      Si l’instance cible est un groupe Mise à Autoscale, spécifiez les paramètres de mise à l’Autoscale suivants :

      • Type d’accès  : vous pouvez utiliser la solution de mise à l’échelle automatique ADM pour des applications externes et internes. Sélectionnez le type d’accès à l’application requis.

      • Nom de domaine - Spécifiez le nom de domaine d’une application. Cette option n’est applicable que lorsque vous sélectionnez Type de nom de domaine complet défini par l’utilisateur.

      • Zone du domaine  : sélectionnez le nom de zone d’une application dans la liste. Cette option n’est applicable que lorsque vous sélectionnez Type de nom de domaine complet défini par l’utilisateur.

        Ce nom de domaine et de zone redirige vers les serveurs virtuels dans Azure. Par exemple, si vous hébergez une application dans app.example.com, le app est le nom de domaine et example.com le nom de la zone.

    2. Sélectionnez les serveurs virtuels à migrer.

      Sélectionnez les serveurs virtuels que vous souhaitez migrer

    3. Cliquez sur Suivant.

  8. Dans Commandes CLI équivalentes, passez en revue les commandes et cliquez sur Suivant.

    Ces commandes sont spécifiques à la configuration de l’application sélectionnée.

    Remarque

    Vous pouvez également ajouter ou modifier la configuration si nécessaire.

  9. Dans Attributs de déploiement, vous pouvez afficher et modifier l’adresse IP et le port des serveurs virtuels, des services et des membres du groupe de services.

    Pour modifier l’adresse IP et le port, cliquez sur l’icône de modification sur le serveur virtuel, le service ou le membre du groupe de services dans le diagramme de flux.

    Modifier les attributs de déploiement

    Remarque

    Si l’instance cible est un groupe Autoscale, la modification de l’adresse IP frontale est désactivée.

    Cet onglet n’apparaît que dans les cas suivants :

    • Les instances source et cible sont différentes.

    • Importez des configurations à l’aide des commandes CLI.

  10. Dans Attributs de configuration, spécifiez les détails nécessaires et cliquez sur Suivant.

    Cet onglet répertorie les secrets tels que les clés pour déchiffrer les mots de passe et les certificats.

    Remarque

    Avant de commencer la migration, les configurations manquées ou non prises en charge sont affichées dans l’un des onglets suivants :

    • Configurations non prises en charge

    • Configurations globales non prises en charge

    Pour migrer ces configurations avec succès, vous devez appliquer séparément les configurations manquées ou non prises en charge sur l’instance cible. Et, cliquez sur Suivant.

  11. Dans Migrer, cliquez sur Migrer.

Limitations

  • Les expressions nommées et responderhtmlpages mentionnées dans l’instance source ne sont pas identifiées. Assurez-vous de configurer les expressions nommées et responderhtmlpages sur l’instance cible avant la migration.

  • Si la source a une configuration pour servicegroup et surveille la liaison comme suit :

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

    L’erreur suivante apparaît :

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

    Cette erreur se produit car Citrix ADC enregistre la liaison entre le groupe de services et le moniteur dans un format non valide. Ce problème est résolu à partir de Citrix ADC 12.1.52.15 build.

Migrer la configuration de l’application Citrix ADC à l’aide de StyleBooks Configuration Builder