Créer et modifier un pack de configuration
Dans NetScaler Console, 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
Procédez comme suit pour créer un pack de configuration à partir d’un StyleBook :
-
Accédez à Applications > StyleBooks > Configurations.
-
Cliquez sur Ajouter.
-
Dans Choisissez StyleBooks, sélectionnez les StyleBooks requis à partir desquels vous souhaitez créer un pack de configuration.
Cette page classe les StyleBooks en StyleBooks par défaut et personnalisés. Sélectionnez les onglets respectifs pour trouver les StyleBooks requis.
-
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.
-
Dans Instances cibles, sélectionnez les instances ou les groupes d’instances sur lesquels vous souhaitez exécuter la configuration.
Note:
Vous pouvez déployer la configuration sur plusieurs NetScaler, en spécifiant autant d’instances cibles que nécessaire.
-
Cliquez sur Exécution à sec.
La page Objets affiche les objets qui sont créés, modifiés ou supprimés des instances NetScaler.
-
Cliquez sur Créer
Le pack de configuration apparaît dans la page StyleBook > Configurations .
Si vous souhaitez modifier les packs de configuration existants, sélectionnez le pack de configuration et cliquez sur Modifier.
Réutilisez les configurations créées en dehors de StyleBooks et partagez les configurations entre les ConfigPacks
Parfois, vous avez peut-être créé des configurations NetScaler en dehors des Stylebooks, que ce soit en raison de besoins opérationnels particuliers ou de configurations héritées. Vous pouvez désormais intégrer et gérer ces configurations existantes dans le cadre des packs de configuration Stylebook, permettant une gestion plus flexible et centralisée.
Par exemple, avant cette fonctionnalité, si NetScaler est déjà configuré avec un profil SSL et si l’opération de pack de configuration de StyleBook tente de créer un profil SSL avec le même nom, l’opération de pack de configuration aurait échoué avec l’erreur « La ressource existe déjà ». Désormais, avec cette fonctionnalité activée, l’opération configpack réussit et le profil SSL existant portant le même nom peut être réutilisé dans le nouveau pack de configuration.
De même, vous pouvez également être confronté à des scénarios dans lesquels des ressources telles que des paramètres réseau, des politiques de sécurité ou une partie des configurations d’application sont requises dans plusieurs applications ou configurations. Cette fonctionnalité vous permet de partager les configurations entre plusieurs packs de configuration.
Pour activer cette fonctionnalité, suivez ces étapes :
-
Accédez à Applications > Configuration > Livres de style.
-
Sur la page Stylebooks, sélectionnez le Stylebook que vous utiliserez pour créer un nouveau pack de configuration ou celui associé au pack de configuration que vous modifiez.
-
Dans Sélectionner une action, cliquez sur Configurer les paramètres.
- Ajustez les paramètres en choisissant l’une ou les deux options suivantes :
- Pour activer la réutilisation des ressources existantes sur le NetScaler lors de la création de configurations, sélectionnez l’option Autoriser la réutilisation des ressources existantes sur le NetScaler lors de la création de configurations.
- Pour conserver les ressources réutilisées sur le NetScaler lors de la suppression des configurations, sélectionnez l’option Conserver les ressources réutilisées sur le NetScaler lors de la suppression des configurations ?. Cette option conserve les ressources créées à l’origine en dehors des Stylebooks sur NetScaler, même si le dernier pack de configuration les référençant est supprimé, garantissant ainsi leur disponibilité continue.
- Cliquez sur OK.
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 souhaiterez peut-être les mettre à jour pour utiliser le nouveau StyleBook mis à jour. Pour utiliser un nouveau StyleBook, modifiez le StyleBook existant du pack de configuration.
Considérez un exemple StyleBook example-lb qui déploie une configuration d’équilibreur de charge de base sur une instance NetScaler. 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’équilibreur de charge, vous avez besoin d’un nouveau StyleBook. Par conséquent, créez example-lb-mon StyleBook qui inclut la possibilité de configurer des moniteurs avec la configuration de base de l’équilibreur de charge.
Après avoir créé un StyleBook, mettez à jour le pack de configuration CP1 existant pour ajouter des moniteurs. Pour ce faire, procédez comme suit :
-
Accédez à Applications > StyleBooks > Configurations.
-
Sélectionnez le pack de configuration pour lequel vous souhaitez modifier le StyleBook.
Dans cet exemple, sélectionnez CP1 dans la liste.
-
Cliquez sur Modifier le style du livre.
-
Sélectionnez le StyleBook requis dans la liste. Ensuite, cliquez sur Enregistrer la sélection.
-
Cliquez sur Modifier.
Dans cet exemple, sélectionnez example-lb-mon dans 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 à celle du StyleBook précédent, 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 parent de paramètre, etc.
Si de nouveaux paramètres requis 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 du StyleBook example-lb sont les suivants :
Les paramètres qui apparaissent sur la page de configuration du nouveau StyleBook example-lb-mon sont 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 uniquement les nouveaux paramètres. Pour les paramètres du moniteur, spécifiez manuellement les valeurs requises.
-
Dans Instances cibles, examinez les instances sélectionnées et mettez à jour la liste si nécessaire.
-
Cliquez sur Exécution à sec.
La page Objets affiche les objets qui sont créés, modifiés ou supprimés des instances NetScaler.
-
Cliquez sur OK.
Dans la page StyleBook > Configurations , la colonne StyleBook Name affiche le nouveau nom StyleBook pour le pack de configuration sélectionné. Dans ce cas, il affiche example-lb-mon.
Modifier le StyleBook qui contient plusieurs packs de configuration
Lorsque vous modifiez un StyleBook existant qui contient plusieurs packs de configuration, procédez comme suit :
-
Importez un nouveau StyleBook dans la console NetScaler.
En règle générale, le nouveau StyleBook a le même nom et le même espace de noms avec une version supérieure à celle du StyleBook existant. Cependant, vous pouvez ignorer cette étape si le nom, l’espace de noms ou la version sont différents.
-
Modifiez le StyleBook pour les packs de configuration associés au StyleBook existant.
Vous pouvez sélectionner Modifier StyleBook uniquement lorsque les packs de configuration sélectionnés sont associés au même StyleBook.
Pour les packs de configuration sélectionnés, la console NetScaler modifie avec succès 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électionnez Configurations en cours/Échoué dans la page Configurations .
-
-
Supprimez l’ancien StyleBook de la console NetScaler 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 comme StyleBooks. Grâce à cette fonctionnalité, vous pouvez facilement partager la configuration StyleBook avec une autre console NetScaler. Lorsque vous exportez un pack de configuration, un bundle tgz ou zip est téléchargé sur votre ordinateur local. Ce bundle comprend un fichier JSON avec tous les paramètres définis dans un pack de configuration.
Exporter la configuration
Procédez comme suit pour exporter un pack de configuration :
-
Accédez à Applications > StyleBooks > Configurations.
-
Sélectionnez un pack de configuration que vous souhaitez exporter.
-
Dans Sélectionnez Action, sélectionnez Exporter la configuration.
-
Dans le volet Exporter la configuration , spécifiez les éléments suivants :
-
Informations sur les instances cibles sur lesquelles la configuration est déployée: sélectionnez cette option pour inclure les informations des instances cibles avec le bundle d’exportation.
-
StyleBook associé à la configuration: Sélectionnez cette option pour inclure le StyleBook dans le bundle d’exportation.
-
Phrase secrète pour protéger les données de configuration d’exportation: Spécifiez une phrase secrète pour crypter le bundle d’exportation. Cette phrase secrète sécurise les données sensibles d’un pack de configuration.
-
Type de fichier compressé: Sélectionnez le type de fichier ZIP ou TGZ .
-
-
Cliquez sur Exporter.
Enregistrez le bundle d’exportation sur votre ordinateur local.
Importer la configuration
Vous pouvez importer un pack de configuration de votre ordinateur local vers une autre console NetScaler. Pour importer un pack de configuration, procédez comme suit :
-
Accédez à Applications > StyleBooks > Configurations.
-
Sélectionnez Importer la configuration.
-
Choisissez le fichier d’importation à importer sur votre ordinateur.
-
Utilisez la phrase secrète que vous avez spécifiée lors de l’exportation.
-
Facultatif, dans Options avancées, sélectionnez Autoriser la création d’une nouvelle configuration uniquement si tous les objets de configuration existent déjà sur NetScaler.
Cette option ne modifie pas les objets déjà créés sur l’instance NetScaler.
Considérez que vous avez ajouté la même instance NetScaler dans deux serveurs NetScaler Console. Et vous souhaitez migrer un pack de configuration d’un serveur NetScaler Console vers un autre serveur. Utilisez cette option pour importer un pack de configuration sans modifier ses objets de configuration sur une instance NetScaler.
Important
Pour utiliser cette option, assurez-vous que le bundle de configuration spécifié contient les informations sur les instances cibles. Voir, Exporter la configuration.
Cette option migre la configuration uniquement si tous les objets sont présents sur l’instance cible.
- Cliquez sur Importer.
Lorsque vous importez un pack de configuration, la console NetScaler vérifie les éléments suivants :
-
StyleBook associé: Si le StyleBook associé n’est pas dans la console NetScaler, il importe le StyleBook avec le pack de configuration.
-
Instances cibles: vérifie les instances cibles et déploie la configuration sur les instances cibles spécifiées. Si les instances NetScaler mentionnées sont absentes de la console NetScaler, le pack de configuration est importé sans instances cibles.
-
Source NetScaler Console: Si vous importez un pack de configuration sur le même serveur NetScaler Console, le bundle sélectionné met à jour le pack de configuration existant.
Enregistrer un pack de configuration en tant que brouillon
L’option Enregistrer comme brouillon dans les packs de configuration vous permet d’enregistrer vos modifications de configuration sous forme de brouillons. Cette fonctionnalité enregistre les modifications sans les déployer immédiatement sur une instance NetScaler.
Pour enregistrer un pack de configuration en tant que brouillon :
- Accédez à Applications > Configuration > Packs de configuration.
- Sur la page Configurations , cliquez sur Ajouter.
- Sélectionnez le livre de style souhaité et cliquez sur Sélectionnez.
- Sur la page Créer une configuration , cliquez sur Enregistrer comme brouillon.
Une fois le pack de configuration enregistré en tant que brouillon, vos modifications de configuration ne sont pas déployées directement sur l’instance NetScaler. Au lieu de cela, les packs de configuration sont stockés sous forme de brouillons dans l’onglet Configurations de brouillon sous Configurations en attente.
Dans l’onglet Configurations de brouillon , sélectionnez le pack de configuration pour effectuer les opérations suivantes :
- Modifier la configuration d’un pack de configuration.
- Déployez la configuration sur une instance NetScaler.
- Supprimez le brouillon pour supprimer la configuration sans la déployer.
Vous pouvez également planifier le moment où déployer vos brouillons enregistrés.
Pour plus d’informations, voir Planifier un pack de configuration.
Créer un calendrier pour un pack de configuration
Lorsque vous créez un pack de configuration, celui-ci est automatiquement déployé sur une instance NetScaler par défaut. Avec cette fonctionnalité, vous pouvez planifier le moment de déploiement du pack de configuration.
Pour créer une planification pour un pack de configuration :
- Accédez à Applications > Configuration > Packs de configuration.
- Sur la page Configurations , cliquez sur Ajouter.
- Sélectionnez le StyleBook et cliquez sur Sélectionnez.
- Sur la page Créer une configuration , sous Exécution, sélectionnez Plus tard dans la liste Mode d’exécution .
- Sélectionnez l’heure et la date souhaitées pour la planification et cliquez sur Soumettre.
Toutes les configurations planifiées sont stockées dans l’onglet Configurations planifiées sous Configurations en attente. Vous pouvez sélectionner la planification créée pour la modifier, la déployer ou l’annuler.
Pour un pack de configuration déployé
Vous pouvez également créer une planification pour modifier et supprimer un pack de configuration déployé.
Planifier une opération d’édition pour un pack de configuration
Pour créer une planification pour modifier le pack de configuration déployé :
- Accédez à Applications > Configuration > Packs de configuration.
- Sur la page Configurations , sélectionnez un StyleBook et cliquez sur Modifier.
- Sur la page Modifier la configuration , modifiez le pack de configuration.
- Dans la liste Mode d’exécution , sélectionnez Plus tard.
- Sélectionnez l’heure et la date souhaitées pour la planification et cliquez sur Soumettre.
Planifier une opération de suppression pour un pack de configuration
Pour créer une planification pour supprimer le pack de configuration déployé :
- Accédez à Applications > Configuration > Packs de configuration.
- Sur la page Configurations, sélectionnez un StyleBook et cliquez sur Supprimer.
- Dans la liste Mode d’exécution , sélectionnez Plus tard.
- Sélectionnez l’heure et la date souhaitées pour la planification et cliquez sur Soumettre.
Détacher une instance cible d’un pack de configuration
Pour détacher une instance cible d’un pack de configuration, procédez comme suit :
-
Accédez à Applications > Configuration > Packs de configuration.
-
Sélectionnez le pack de configuration avec une instance cible que vous souhaitez supprimer.
-
Dans Sélectionner l’action, sélectionnez Détacher les cibles.
-
Dans le volet Détacher les cibles , sélectionnez l’instance cible que vous souhaitez supprimer du pack de configuration.
-
Cliquez sur OK.
Un message s’affiche, confirmant la création d’un pack de configuration en double avec l’instance cible désormais supprimée.
Créez vos StyleBooks
Le contenu complet de example-lb StyleBook est fourni à titre de référence comme suit :
nom : example-lb
espace de noms : examples.stylebooks
version : "1.0"
nom d'affichage : application d'équilibrage de charge de base
description : ceci est un exemple de StyleBook qui crée une application d'équilibrage de charge
version du schéma : "1.0"
import-stylebooks :
-
espace de noms : com.citrix.adc.stylebooks
préfixe : stlb
version : "1.0"
paramètres-par défaut-sources :
- stlb::lb
composants :
-
nom : lb-comp
type : stlb::lb
description : utilise le StyleBook lb par défaut pour créer les objets de configuration lb typiques
propriétés-par-défaut-sources :
- $parameters
<!--NeedCopy-->
Le contenu complet de example-lb-mon StyleBook est fourni à titre de référence comme suit :
nom : example-lb-mon
espace de noms : examples.stylebooks
version : "1.0"
description : ceci est un exemple de StyleBook qui crée une application d'équilibrage de charge avec des moniteurs
nom d'affichage : application d'équilibrage de charge de base avec moniteurs
version du schéma : "1.0"
import-stylebooks :
-
espace de noms : netscaler.nitro.config
préfixe : ns
version : "10.5"
-
espace de noms : com.citrix.adc.stylebooks
préfixe : stlb
version : "1.0"
-
espace de noms : com.citrix.adc.commontypes
préfixe : cmtypes
version : "1.0"
paramètres-par-défaut-sources :
- stlb::lb
paramètres :
-
nom : moniteurs
étiquette : "Liste des moniteurs"
description : "Liste des moniteurs pour surveiller les serveurs d'applications"
type : cmtypes::monitor[]
substitutions :
mon-name(appname, monname) : $appname + "-mon-" + $monname
composants :
-
nom : lb-comp
type : stlb::lb
description : utilise le StyleBook lb par défaut pour créer les objets de configuration lb typiques
propriétés-par-défaut-sources :
- $parameters
-
nom : monitors-comp
type : cmtypes::monitor
condition : $parameters.monitors
répétition : $parameters.monitors
repeat-item: mon
repeat-index: ndx
description: Crée une liste d'objets de surveillance NetScaler et les lie au groupe de services de cette configuration LB
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
propriétés :
nom_groupe_services : $components.lb-comp.outputs.servicegroup.properties.servicegroupname
nom_moniteur : $parent.properties.monitorname
<!--NeedCopy-->
Dans cet article
- Créer un pack de configuration
- Réutilisez les configurations créées en dehors de StyleBooks et partagez les configurations entre les ConfigPacks
- Modifier le StyleBook d’un pack de configuration
- Exporter ou importer des packs de configuration
- Enregistrer un pack de configuration en tant que brouillon
- Créer un calendrier pour un pack de configuration
- Détacher une instance cible d’un pack de configuration
- Créez vos StyleBooks