Migrer le pack de configuration d’un StyleBook vers un autre StyleBook

February 1, 2024

Contributeur:

Dans Citrix Application Delivery Management (ADM), les packs de configuration sont toujours liés au StyleBook à partir duquel ils sont créés. Toute mise à jour du pack de configuration peut être effectuée uniquement via le StyleBook à lequel le pack de configuration est lié. Citrix ADM vous permet désormais de migrer un pack de configuration existant vers un nouveau StyleBook. Le nouveau StyleBook peut être une version plus originale du StyleBook actuel lié au pack de configuration. Vous pouvez également migrer le pack de configuration vers un StyleBook entièrement différent.

Par exemple, vous avez créé un StyleBook appelé example-lb. Ce StyleBook est utilisé pour déployer une configuration d’équilibrage de charge de base sur une instance Citrix ADC. Vous avez créé un pack de configuration CP1 à partir de ce StyleBook sur une instance Citrix ADC. Plus tard, vous avez réalisé que votre StyleBook n’inclut pas de configuration de surveillance. Vous avez donc créé un StyleBook appelé example-lb-mon. Ce StyleBook a la même configuration d’équilibrage de charge que l’exemple lb StyleBook, mais il ajoute la possibilité de configurer des moniteurs.

Vous souhaitez maintenant mettre à jour votre configuration existante qui a été créée dans le pack de configuration CP1 pour ajouter des moniteurs. Auparavant, vous deviez supprimer le pack de configuration CP1 et créer un pack de configuration CP2 à partir du nouveau StyleBook pour ajouter des moniteurs à votre configuration. La suppression de CP1 entraîne la suppression de toute la configuration créée dans le pack de configuration CP1 sur une ou plusieurs instances Citrix ADC. Auparavant, vous deviez recréer un nouveau pack de configuration via le nouveau StyleBook en tapant des valeurs pour tous les paramètres.

Au lieu de cela, vous pouvez désormais migrer le pack de configuration existant CP1 vers le nouveau styleBook example-lb-mon. Votre nouveau StyleBook peut configurer les détails des moniteurs. Seuls ces objets de configuration liés au moniteur sont ajoutés aux instances Citrix ADC où le pack de configuration a été déployé. Vous devez fournir juste les détails du moniteur maintenant. La configuration existante déployée sur les instances Citrix ADC qui n’a pas été modifiée reste inchangée.

Migrer le pack de configuration

Pour migrer un pack de configuration créé à l’aide d’example-lb StyleBook vers example-lb-mon StyleBook

Dans Citrix ADM, accédez à Applications > Configurations. La page Configurations affiche tous les packs de configuration présents dans le système.
Faites défiler l’écran vers le bas pour trouver le pack de configuration exemple-lb que vous auriez créé précédemment, puis cliquez sur Migrer Configpack.
La page Choisir le StyleBook cible pour la migration s’ouvre et répertorie tous les StyleBooks disponibles dans Citrix ADM. Faites défiler la page vers le bas pour trouver l’ example-lb-mon StyleBook et cliquez sur Sélectionner StyleBook . Vous pouvez également rechercher le StyleBook en tapant example-lb-mon.

Si vous migrez d’un StyleBook à un autre, tous les paramètres des deux StyleBooks peuvent ne pas avoir la même structure. Si la structure des paramètres est similaire, les valeurs précédentes sont automatiquement conservées dans les champs de paramètres. Certains paramètres du nouveau StyleBook peuvent être nouveaux ou leur structure peut être modifiée. Dans ce cas, vous devez renseigner manuellement les valeurs des paramètres StyleBook. Par exemple, l’image suivante montre les paramètres de l’example-lb StyleBook.

L’image suivante montre les paramètres après la migration du pack de configuration vers example-lb-mon StyleBook.

Dans ce cas, vous pouvez constater que les StyleBooks conservent les anciennes valeurs pour la configuration de base de l’équilibreur de charge. Toutefois, vous devez saisir manuellement les valeurs des paramètres du moniteur.
Saisissez les valeurs des nouveaux paramètres utilisés pour créer des moniteurs sur l’instance.
Sous Instances cibles, cliquez et sélectionnez l’adresse IP de l’instance Citrix ADC sur laquelle vous souhaitez exécuter la configuration. Notez que vous pouvez déployer la configuration sur plusieurs Citrix ADC, en spécifiant autant d’instances cibles que nécessaire.
Cliquez sur Exécuter à sec. La page Objets affiche les objets qui seraient récemment créés, modifiés ou supprimés de la ou des instances Citrix ADC.
Cliquez sur Créer pour créer ou mettre à jour la configuration des instances sélectionnées. Le pack de configuration est créé si les instances cibles sont nouvelles. Sinon, les configurations existantes déployées sur les instances sont mises à jour.

Remarque

Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter des instances Citrix ADC récemment découvertes. Ces instances sont donc immédiatement disponibles dans la liste des instances de cette fenêtre. L’icône d’actualisation est actuellement disponible uniquement sur Citrix ADM.

Vous pouvez également migrer un pack de configuration d’une version d’un StyleBook vers la version suivante. Ici aussi, vous devrez peut-être taper les valeurs de tous les nouveaux paramètres requis présents dans la nouvelle version. Vous pouvez également migrer le pack de configuration vers une version antérieure du StyleBook. Dans ce cas, les paramètres supplémentaires qui ne sont pas présents dans l’ancien StyleBook sont supprimés. La page Objets affiche tous les objets supprimés de la configuration.

Une fois la migration réussie, le ConfigPack est lié au nouveau StyleBook.

Image localisée

Vous pouvez voir que le nom du pack de configuration et l’ID du pack de configuration sont identiques à ceux précédents. Mais Citrix ADM met à jour le nom de StyleBook à example-lb-mon à partir de example-lb.

Créez vos StyleBooks

Le contenu complet de example-lbStyleBook est fourni ci-dessous à titre de référence :

name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
parameters-default-sources:
  - stlb::lb
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
 

Le contenu complet de example-lb-mon StyleBook est fourni ci-dessous à titre de référence :

name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
  -
    namespace: netscaler.nitro.config
    prefix: ns
    version: "10.5"
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
  -
    namespace: com.citrix.adc.commontypes
    prefix: cmtypes
    version: "1.0"
parameters-default-sources:
  - stlb::lb
parameters:
  -
    name: monitors
    label: "List of Monitors"
    description: "List of Monitors to monitor Application Servers"
    type: cmtypes::monitor[]
substitutions:
  mon-name(appname, monname): $appname + "-mon-" + $monname
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
  -
    name: monitors-comp
    type: cmtypes::monitor
    condition: $parameters.monitors
    repeat: $parameters.monitors
    repeat-item: mon
    repeat-index: ndx
    description: Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB config
    properties-default-sources:
      - $mon
    properties:
        monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
    components:
      -
        name: monitor-svcg-binding-comp
        condition:  $parameters.svc-servers
        type: ns::servicegroup_lbmonitor_binding
        properties:
          servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
          monitor_name: $parent.properties.monitorname
 

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Migrer le pack de configuration d’un StyleBook vers un autre StyleBook

February 1, 2024

Contributeur:

Migrer le pack de configuration d’un StyleBook vers un autre StyleBook

Migrer le pack de configuration

Pour migrer un pack de configuration créé à l’aide d’example-lb StyleBook vers example-lb-mon StyleBook

Créez vos StyleBooks

Dans cet article