Configuration de StyleBook

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

Le générateur de configuration StyleBooks est utilisé pour migrer une configuration NetScaler existante vers StyleBooks. Cette fonctionnalité automatise également la migration de la configuration des applications d’une instance NetScaler vers une autre instance ou un groupe Autoscale.

Le Générateur de configuration fournit un StyleBook d’application structuré qui peut être utilisé pour toutes les variantes de la configuration NetScaler. 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 NetScaler sur une nouvelle instance NetScaler. Avec ce pack de configuration, la configuration NetScaler initiale d’une instance NetScaler peut être dupliquée vers une autre instance NetScaler. La source de configuration initiale peut être l’une des suivantes :

  • Une instance NetScaler : Spécifiez l’instance où est hébergée la configuration de l’application que vous souhaitez dupliquer.

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

    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 intégrées dans la configuration source. Lorsque vous sélectionnez la configuration d’application qui vous intéresse, le Générateur de configuration extrait l’ensemble des commandes CLI pour 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 NetScaler 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 la console NetScaler à l’aide adc_nitro_applicationde StyleBook. Ce StyleBook est créé à partir des ressources NetScaler NITRO. Ce pack de configuration représente la configuration de l’application sur l’instance NetScaler cible. Pour afficher le pack de configuration créé, accédez à Applications > Configuration > Config Packs.

Fonctionnalités NetScaler prises en charge

Le générateur de configuration StyleBook reconnaît et prend en charge les fonctionnalités NetScaler suivantes dans la configuration source :

  • Commutation de contenu
  • Équilibrage de charge
  • Surveillance
  • Déchargement SSL
  • Limitation de débit
  • Réécriture
  • Répondeur
  • Pare-feu pour applications Web (WAF)
  • Gestion des robots
  • Contrôle de la compression

Créez un StyleBook pour migrer la configuration de l’application NetScaler

La procédure suivante consiste à créer un StyleBook qui migre la migration de l’application NetScaler dans NetScaler Console :

  1. Accédez à Applications > Configuration > Config Packs.

  2. Cliquez sur Migrer la configuration NetScaler.

  3. Cliquez sur Commencer.

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

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

    • Importer à l’aide des commandes CLI : Cette option analyse les commandes de la CLI et extrait les applications des commandes de la CLI.

  5. Spécifiez l’instance NetScaler 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 NetScaler 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 :

      • Typed’accès : vous pouvez utiliser la solution de dimensionnement automatique de la console NetScaler pour les 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.

    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 Modifier sur le serveur virtuel, le service ou le membre du groupe de services dans l’organigramme.

    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 compatibles

    • Configurations globales non prises en charge

    Pour réussir la migration de ces configurations, vous devez appliquer les configurations non prises en charge ou non prises en charge séparément 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 dispose d’une configuration pour servicegroup et d’une liaison de surveillance comme suit :

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

    L’erreur suivante s’affiche :

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

    Cette erreur se produit car NetScaler enregistre la liaison entre Service Group et Monitor dans un format non valide. Ce problème est résolu à partir de la version 12.1.52.15 de NetScaler.

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