Application Delivery Management

Utiliser des variables dans les tâches de configuration

February 1, 2024

Contributeur:

Une tâche de configuration est un ensemble de commandes de configuration que vous pouvez exécuter sur une ou plusieurs instances gérées. Lorsque vous exécutez la même configuration sur plusieurs instances, vous souhaiterez peut-être utiliser des valeurs différentes pour les paramètres utilisés dans votre configuration. Vous pouvez définir des variables qui vous permettent d’attribuer différentes valeurs pour ces paramètres ou d’exécuter une tâche sur plusieurs instances.

Par exemple, envisagez une configuration d’équilibrage de charge de base dans laquelle vous ajoutez un serveur virtuel d’équilibrage de charge, ajoutez deux services et liez les services au serveur virtuel. À présent, vous souhaiterez peut-être avoir la même configuration sur deux instances, mais avec des valeurs différentes pour le serveur virtuel, les noms de services et les adresses IP. Vous pouvez utiliser la fonctionnalité de tâches de configuration pour y parvenir en utilisant des variables pour définir les noms et les adresses IP du serveur virtuel et des services.

Dans cet exemple, les commandes et variables suivantes sont utilisées :

ajouter le nom du serveur lb vserver,l’adresse IP HTTP et le numéro de port

ajouter un service servicename1 ipaddress1 HTTP 80

ajouter un service servicename2 ipaddress2 HTTP 80

bind lb vserver servername servicename1

bind lb vserver servername servicename2

Pour créer une tâche de configuration en définissant des variables dans Citrix ADM :

Accédez à Réseaux > Travaux de configuration.
Cliquez sur Créer une tâche.
Sur la page Créer une tâche, sélectionnez les paramètres de tâche personnalisés tels que le nom de la tâche, le type d’instance et le type de configuration.
Dans l’Éditeur de configuration, tapez les commandes pour ajouter un serveur virtuel d’équilibrage de charge, deux services et lier les services au serveur virtuel. Double-cliquez pour sélectionner les valeurs que vous souhaitez convertir en variable, puis cliquez sur Convertir en variable. Par exemple, sélectionnez l’adresse IP du serveur d’équilibrage de charge ipaddress, puis cliquez sur Convertir en variable comme indiqué dans l’image ci-dessous.
Une fois que vous voyez des symboles en dollars encadrer la valeur de la variable, cliquez sur la variable pour préciser davantage les détails de la variable, tels que son nom, son nom d’affichage et son type. Vous pouvez également cliquer sur l’option Avancé si vous souhaitez spécifier une valeur par défaut pour votre variable. Cliquez sur Enregistrer, puis sur Suivant.

Tapez le reste de vos commandes et définissez toutes les variables.
Vous pouvez consulter toutes les variables que vous avez définies lors de la création ou de la modification d’un travail de configuration dans une vue consolidée unique.
Pour afficher toutes les variables dans une seule vue consolidée, procédez de l’une des manières suivantes :
- Lors de la création d’une tâche de configuration, accédez à Réseaux > Tâches de configuration, puis sélectionnez Créer une tâche. Sur la page Créer un travail, vous pouvez consulter toutes les variables que vous avez ajoutées lors de la création du travail de configuration.
- Lorsque vous modifiez une tâche de configuration, accédez à Réseau > Tâches de configuration, sélectionnez le nom de la tâche et cliquez sur Modifier. Sur la page Configurer la tâche, vous pouvez consulter toutes les variables qui ont été ajoutées lors de la création de la tâche de configuration.
Vous pouvez ensuite cliquer sur l’onglet Aperçu des variables pour prévisualiser les variables dans une vue consolidée unique que vous avez définie lors de la création ou de la modification d’une tâche de configuration.
Une nouvelle fenêtre contextuelle apparaît et affiche tous les paramètres des variables telles que Nom, Nom d’affichage, Type et valeur par défaut dans un format tabulaire. Vous pouvez également modifier et modifier ces paramètres. Cliquez sur le bouton Terminé après avoir modifié l’un des paramètres.
Vous pouvez ensuite réorganiser les commandes dans l’éditeur de configuration selon les besoins. Vous pouvez déplacer la commande d’une ligne à l’autre en faisant glisser la ligne de commande. Vous pouvez également déplacer ou réorganiser la ligne de commande d’une ligne à n’importe quelle ligne cible en changeant simplement le numéro de ligne de commande dans la zone de texte.
Sélectionnez les instances sur lesquelles vous souhaitez exécuter le travail de configuration.
Dans l’onglet Spécifier les valeurs variables, sélectionnez l’option Télécharger le fichier d’entrée pour les valeurs variables, puis cliquez sur Télécharger le fichier clé d’entrée. Dans notre exemple, vous devrez spécifier le nom du serveur sur chaque instance, les adresses IP du serveur et des services, les numéros de port et les noms de service. Enregistrez le fichier et téléchargez-le. Si vos valeurs ne sont pas définies avec précision, le système peut déclencher une erreur.
Le fichier de clé d’entrée est téléchargé sur votre système local et vous pouvez le modifier en spécifiant les valeurs des variables pour chaque instance NetScaler que vous avez sélectionnée précédemment et en cliquant sur Télécharger pour télécharger le fichier de clé d’entrée sur Citrix ADM. Cliquez sur Suivant. Le fichier clé d’entrée est téléchargé sur votre système local et vous pouvez le modifier en spécifiant les valeurs des variables pour chaque instance NetScaler que vous avez sélectionnée précédemment.
Remarque Dans le fichier clé en entrée, les variables sont définies à trois niveaux :
- Au niveau mondial
- Au niveau du groupe d’instances
- Niveau de l’instance
Les variables globales sont des valeurs variables appliquées à toutes les instances. Les valeurs des variables au niveau du groupe d’instances sont appliquées à toutes les instances définies dans un groupe. Les valeurs des variables au niveau de l’instance ne sont appliquées qu’à une instance spécifique.

Citrix ADM donne la priorité aux valeurs au niveau de l’instance. Si aucune valeur n’est fournie aux variables pour les instances individuelles, Citrix ADM utilise la valeur fournie au niveau du groupe. Si aucune valeur n’est fournie au niveau du groupe, Citrix ADM utilise la valeur variable fournie au niveau global. Si vous fournissez une entrée pour une variable sur les trois niveaux, Citrix ADM utilise la valeur de niveau d’instance comme valeur par défaut.
Cliquez sur Télécharger pour télécharger le fichier clé d’entrée sur Citrix ADM. Cliquez sur Suivant.

Important

Lorsque vous téléchargez un fichier CSV à partir d’un Mac, Mac stocke le fichier CSV avec des points-virgules au lieu de virgules. Cela entraînera l’échec de la configuration lorsque vous téléchargez le fichier d’entrée et exécutez le travail. Si vous utilisez un Mac, utilisez un éditeur de texte pour apporter les modifications nécessaires, puis téléchargez le fichier.
Vous pouvez également attribuer des valeurs de variables communes à toutes les instances et cliquer surTélécharger pour télécharger le fichier clé d’entrée vers Citrix ADM.

Les fichiers d’entrée de clé contenant les valeurs des variables sont conservés (avec le même nom de fichier) dans les tâches de configuration. Vous pouvez afficher et modifier ces fichiers d’entrée que vous avez utilisés et chargés précédemment lors de la création ou de la modification des tâches de configuration.

Pour afficher les tâches de configuration exécutées lors de la création d’une tâche de configuration, accédez à Réseau > Tâches de configuration, puis cliquez sur Créer une tâche. Dans la page Créer une tâche. Dans l’onglet Spécifier les valeurs des variables, sélectionnez l’option Valeurs de variables communes pour toutes les instances pour afficher les fichiers téléchargés. Pour modifier les fichiers d’entrée, téléchargez le fichier d’entrée, puis modifiez et chargez les fichiers (en conservant le même nom de fichier).

Pour afficher les tâches de configuration déjà exécutées lors de la modification d’une tâche de configuration, accédez à Réseau > Tâches de configuration, sélectionnez le nom de la tâche et cliquez sur Modifier. Dans la page Configurer la tâche, sous l’onglet Spécifier les valeurs de variable, sélectionnez l’option Valeurs variables communes pour toutes les instances pour afficher les fichiers chargés. Pour modifier les fichiers d’entrée, téléchargez le fichier d’entrée, puis modifiez et chargez les fichiers (en conservant le même nom de fichier).
Sous l’onglet Aperçu des tâches, vous pouvez évaluer et vérifier les commandes à exécuter sur chaque instance ou groupe d’instances.
Dans l’onglet Exécuter, vous pouvez choisir d’exécuter votre tâche maintenant ou de planifier son exécution ultérieurement. Vous pouvez également choisir l’action que Citrix ADM doit entreprendre en cas d’échec de la commande et si vous souhaitez envoyer une notification par e-mail concernant la réussite ou l’échec de la tâche, ainsi que d’autres informations.

Après avoir configuré vos tâches et les avoir exécutées, vous pouvez consulter les détails de la tâche en accédant à Réseaux > Tâches de configuration et en sélectionnant la tâche que vous venez de configurer. Cliquez sur Détails puis sur Détails des variables pour voir la liste des variables ajoutées à votre travail.

Image localisée

Remarque

Les valeurs que vous avez fournies pour les variables à l’ ÉTAPE 5 sont conservées par Citrix ADM lorsque vous enregistrez la tâche et la quittez, ou lorsque vous planifiez l’exécution d’une tâche ultérieurement.

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.

Utiliser des variables dans les tâches de configuration

February 1, 2024

Contributeur:

February 1, 2024

Contributeur:

Utiliser des variables dans les tâches de configuration

Dans cet article