Créer et modifier un pack de configuration

Dans Citrix Application Delivery Management (ADM), vous pouvez créer un pack de configuration à partir d’un StyleBook. Et, le pack de configuration est lié au StyleBook à partir duquel il est créé. Les mises à jour du pack de configuration sont effectuées via le StyleBook auquel il est lié.

Créer un pack de configuration

Effectuez les opérations suivantes pour créer un pack de configuration à partir d’un StyleBook :

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

2. Cliquez surAdd.

3. DansChoisir des livres de style, sélectionnez les StyleBooks requis à partir desquels vous souhaitez créer un pack de configuration.

   Cette page classe StyleBooks dans StyleBooks par défaut et personnalisés. Sélectionnez les onglets respectifs pour trouver les StyleBooks requis.

4. Spécifiez les détails requis, tels que le nom de l’application, l’adresse IP, le port ou le type de protocole.

   Les champs de l’interface graphique diffèrent d’un StyleBook à un autre StyleBook.

5. DansInstances cibles, sélectionnez les instances ou les groupes d’instances dans lesquels vous souhaitez exécuter la configuration.

   Remarque

   Vous pouvez déployer la configuration sur plusieurs Citrix ADC, en spécifiant autant d’instances cibles que nécessaire.

6. Cliquez surExécuter à sec.

   La pageObjetsaffiche les objets créés, modifiés ou supprimés des instances Citrix ADC.

7. Cliquez surCréer

   Le pack de configuration apparaît dans la pageStyleBook > Configurations.

Si vous souhaitez modifier les packs de configuration existants, sélectionnez-le et cliquez surModifier.

Modifier le StyleBook d’un pack de configuration

Parfois, vous devez mettre à jour le StyleBook pour ajouter des fonctionnalités ou résoudre un problème. Si vous avez déjà créé des packs de configuration à l’aide de l’ancien StyleBook, vous pouvez les mettre à jour pour utiliser le nouveau StyleBook mis à jour. Pour utiliser un nouveau StyleBook, modifiez le StyleBook existant du pack de configuration.

Prenons un exemple StyleBookexample-lbqui déploie une configuration d’équilibrage de charge de base sur une instance ADC. Et, vous créez un pack de configuration CP1 à partir de ce StyleBook.

Lorsque vous souhaitez configurer des moniteurs avec la configuration de base de l’équilibrage de charge, vous avez besoin d’un nouveau StyleBook. Par conséquent, créezexemple-lb-monStyleBook qui inclut la possibilité de configurer des moniteurs ainsi que la configuration de base de l’équilibreur de charge.

Après avoir créé un StyleBook, mettez à jour le pack de configuration existant CP1 pour ajouter des moniteurs. Pour ce faire, effectuez les opérations suivantes :

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

2. 选取ectionnez le pack de configuration pour lequel vous souhaitez modifier le StyleBook.

   Dans cet exemple, sélectionnez CP1 dans la liste.

3. Cliquez surModifier le livre de style.

4. 选取ectionnez le StyleBook requis dans la liste. Cliquez ensuite surEnregistrer la sélection.

5. Cliquez surChange.

   Dans cet exemple, sélectionnezexemple-lb-mondans la liste.

   Lorsque vous modifiez le StyleBook d’un pack de configuration, les paramètres du nouveau StyleBook peuvent avoir une structure différente de celle du StyleBook existant. Si la structure des paramètres est similaire à la précédente StyleBook, les valeurs des paramètres sont automatiquement conservées dans leurs champs respectifs. Sinon, seuls les paramètres ayant la même structure entre les deux StyleBooks sont transférés. Par exemple, le même nom de paramètre, le même type, le même paramètre parent, et plus encore.

   

   Si de nouveaux paramètres obligatoires sont ajoutés dans le nouveau StyleBook, après avoir modifié le StyleBook, vous devez spécifier manuellement les valeurs de ces paramètres.

   Dans cet exemple, les paramètres qui apparaissent sur la page de configuration de l’example-lbStyleBook sont les suivants :

   

   Les paramètres qui apparaissent sur la page de configuration du nouveau styleBookexample-lb-monsont les suivants :

   

   Dans ce cas, les StyleBooks conservent les anciennes valeurs pour la configuration de base de l’équilibreur de charge car le nouveau StyleBook n’a pas modifié les paramètres existants. Et, il ajoute seulement les nouveaux paramètres. Pour les paramètres du moniteur, spécifiez manuellement les valeurs requises.

6. Dans lesinstances cibles, passez en revue les instances sélectionnées et mettez à jour la liste si nécessaire.

7. Cliquez surExécuter à sec.

   La pageObjetsaffiche les objets créés, modifiés ou supprimés des instances Citrix ADC.

8. Cliquez surOK.

   Dans la pageStyleBook > Configurations, la colonneNom du livre StyleBookaffiche le nouveau nom de StyleBook pour le pack de configuration sélectionné. Dans ce cas, il afficheexemple-lb-mon.

Modifier le StyleBook qui comporte plusieurs packs de configuration

Lorsque vous modifiez un StyleBook existant qui a plusieurs packs de configuration, procédez comme suit :

1. Importez un nouveau StyleBook dans ADM.

   Généralement, le nouveau StyleBook a le même nom et l’espace de noms avec une version supérieure à celle du StyleBook existant. Toutefois, vous pouvez ignorer cette étape si le nom, l’espace de noms ou la version sont différents.

2. Modifiez le StyleBook pour les packs de configuration associés au StyleBook existant.

   Vous pouvez sélectionnerModifier le livre de styleuniquement lorsque les packs de configuration sélectionnés sont associés au même StyleBook.

   

   Pour les packs de configuration sélectionnés, l’ADM modifie correctement le StyleBook lorsque les conditions suivantes sont remplies :

   • Tous les paramètres de configuration du StyleBook existant doivent être présents dans le StyleBook sélectionné.

   • Les nouveaux paramètres du StyleBook sélectionné sont facultatifs.

   Pour voir la progression des packs de configuration sélectionnés, sélectionnezConfigurations en cours ou en échecdans la pageConfigurations.

   

3. Supprimez l’ancien StyleBook d’ADM une fois que tous les packs de configuration sont liés au nouveau StyleBook.

Exporter ou importer des packs de configuration

Vous pouvez exporter ou importer un pack de configuration tel que StyleBooks. Avec cette fonctionnalité, vous pouvez facilement partager la configuration de StyleBook à un autre serveur ADM. Lorsque vous exportez un pack de configuration, untgzouzipbundle se télécharge sur votre ordinateur local. Ce bundle inclut un fichier JSON avec tous les paramètres définis dans un pack de configuration.

Exporter la configuration

Pour exporter un pack de configuration, procédez comme suit :

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

2. 选取ectionnez un pack de configuration que vous souhaitez exporter.

3. Dans选取ectionner une action, sélectionnezExporter la configuration.

   

4. Dans le voletConfiguration d’exportation, spécifiez les éléments suivants :

   • Informations sur l’instance cible sur laquelle la configuration est déployée: sélectionnez cette option pour inclure les informations des instances cibles dans le bundle d’exportation.

   • StyleBook associé à Configuration: sélectionnez cette option pour inclure le StyleBook dans l’offre groupée d’exportation.

   • 短语分泌倒门生les数据配置uration d’exportation: spécifiez une phrase secrète pour chiffrer le bundle d’exportation. Cette phrase secrète sécurise les données sensibles d’un pack de configuration.

   • Compresser le type de fichier: sélectionnez le type de fichierZIPouTGZ.

   

5. Cliquez surExporter.

   Enregistrez l’offre groupée d’exportation sur votre ordinateur local.

Configuration d’importation

Vous pouvez importer un pack de configuration depuis votre ordinateur local vers un autre serveur ADM. Pour importer un pack de configuration, procédez comme suit :

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

2. 选取ectionnezImporter la configuration.

   

3. Choisissez le lot de fichiers d’importation à partir de votre ordinateur.

4. Utilisez la phrase secrète que vous avez spécifiée lors de l’exportation.

5. Facultatif, dans Options avancées, sélectionnezAutoriser uniquement la création d’une nouvelle configuration si tous les objets de configuration existent déjà sur ADC.

   Cette option ne modifie pas les objets déjà créés sur l’instance ADC.

   Considérez que vous avez ajouté la même instance ADC dans deux serveurs ADM. Et, vous souhaitez migrer un pack de configuration d’un serveur ADM vers un autre serveur. Utilisez cette option pour importer un pack de configuration sans modifier ses objets de configuration sur une instance ADC.

   Important

   将使用这个选项,verifiez le groupe de configuration spécifié dispose des informations sur les instances cibles. ConsultezExporter la configuration.

   Cette option migre la configuration uniquement si tous les objets sont présents sur l’instance cible.

6. Cliquez surImporter.

Lorsque vous importez un pack de configuration, l’ADM vérifie les éléments suivants :

• StyleBook associé: Si le StyleBook associé n’est pas dans l’ADM, il importe le StyleBook avec le pack de configuration.

• Instances cibles: recherchez les instances cibles et déploie la configuration sur les instances cibles spécifiées. Si les instances ADC mentionnées sont absentes dans l’ADM, le pack de configuration est importé sans instances cibles.

• ADM source: si vous importez un pack de configuration sur le même serveur ADM, le bundle sélectionné met à jour le pack de configuration existant.

Créez vos StyleBooks

Le contenu complet deexample-lbStyleBook est fourni à titre de référence comme suit :

name:example-lbnamespace:examples.stylebooksversion:"1.0"display-name:Basic Load Balancer Appdescription:This is an example StyleBook that creates a load balancer applicationschema-version:"1.0"import-stylebooks:-namespace:com.citrix.adc.stylebooksprefix:stlbversion:"1.0"parameters-default-sources:-stlb::lbcomponents:-name:lb-comptype:stlb::lbdescription:Uses the default lb StyleBook to build the typical lb configuration objectsproperties-default-sources:-$parameters

Le contenu complet deexample-lb-monStyleBook est fourni à titre de référence comme suit :

name:example-lb-monnamespace:examples.stylebooksversion:"1.0"description:This is an example StyleBook that creates a load balancer application with monitorsdisplay-name:Basic Load Balancer App with Monitorsschema-version:"1.0"import-stylebooks:-namespace:netscaler.nitro.configprefix:nsversion:"10.5"-namespace:com.citrix.adc.stylebooksprefix:stlbversion:"1.0"-namespace:com.citrix.adc.commontypesprefix:cmtypesversion:"1.0"parameters-default-sources:-stlb::lbparameters:-name:monitorslabel:"ListofMonitors"description:"ListofMonitorstomonitorApplicationServers"type:cmtypes::monitor[]substitutions:mon-name(appname, monname):$appname + "-mon-" + $monnamecomponents:-name:lb-comptype:stlb::lbdescription:Uses the default lb StyleBook to build the typical lb configuration objectsproperties-default-sources:-$parameters-name:monitors-comptype:cmtypes::monitorcondition:$parameters.monitorsrepeat:$parameters.monitorsrepeat-item:monrepeat-index:ndxdescription:Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB configproperties-default-sources:-$monproperties:monitorname:$substitutions.mon-name($parameters.lb-appname, $mon.monitorname)components:-name:monitor-svcg-binding-compcondition:$parameters.svc-serverstype:ns::servicegroup_lbmonitor_bindingproperties:servicegroupname:$components.lb-comp.outputs.servicegroup.properties.servicegroupnamemonitor_name:$parent.properties.monitorname