Créer un StyleBook pour charger des fichiers vers NetScaler® ADM
Les StyleBooks de NetScaler Application Delivery Management (NetScaler ADM) vous permettent de créer des configurations NetScaler qui peuvent inclure, entre autres, le chargement de fichiers de tout type depuis votre système de fichiers local vers l’instance NetScaler, en utilisant l’interface graphique de NetScaler ADM ou les API. Ces fichiers peuvent être des exemples de fichiers de certificat ou des fichiers de géolocalisation. Vous pouvez également spécifier le répertoire dans lequel charger ces fichiers.
Configuration StyleBook
Voici un exemple de StyleBook qui décrit comment charger un fichier de géolocalisation sur l’instance NetScaler. Les fichiers géographiques sont généralement utilisés dans les configurations GSLB pour définir la proximité statique basée sur la géolocalisation :
Créez votre StyleBook - 1
name: upload-geolocations
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to NetScaler
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: locationfile
label: Location File
description: The system file path of the geolocation file on NetScaler ADM
type: file
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.locationfile.filename
filelocation: "/var/netscaler/inbuilt_db/"
filecontent: base64.encode($parameters.locationfile.contents)
<!--NeedCopy-->
Remarque
Le paramètre utilisé dans cet exemple est de type fichier. Vous pouvez importer ce StyleBook dans NetScaler ADM et l’utiliser pour charger des fichiers de géolocalisation.
Ce StyleBook exige que le fichier soit déjà présent dans NetScaler ADM (par exemple, vous l’auriez déjà copié vers NetScaler ADM à l’aide d’un utilitaire tel que scp).
Si vous souhaitez charger un fichier vers NetScalers via NetScaler ADM sans le copier d’abord dans le système de fichiers de NetScaler ADM, vous pouvez créer un StyleBook qui comporte deux paramètres de type « chaîne », l’un pour spécifier le nom du fichier à utiliser sur le NetScaler et l’autre pour spécifier le contenu du fichier, et utiliser ces deux paramètres dans les composants upload-file-comp. Voici un StyleBook alternatif pour charger un fichier de géolocalisation :
Créez votre StyleBook - 2
name: upload-geolocations-alt
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to NetScaler
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: filename
label: Location Filename
description: The name of the location file on the NetScaler
type: string
required: true
-
name: filecontents
label: Location File Contents
description: The contents of the location file
type: string
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.filename
filelocation: "/var/NetScaler/inbuilt_db/"
filecontent: base64.encode($parameters.filecontents)
<!--NeedCopy-->
Création de configurations pour charger des fichiers
La procédure suivante crée une configuration sur une instance NetScaler sélectionnée qui chargerait un fichier de géolocalisation à l’aide du premier StyleBook décrit ci-dessus.
Pour créer une configuration pour le chargement de fichiers :
-
Dans NetScaler ADM, accédez à Applications > Configuration, puis cliquez sur Créer nouveau. La page Choisir un StyleBook affiche tous les StyleBooks disponibles dans votre NetScaler ADM. Faites défiler vers le bas et sélectionnez le StyleBook que vous avez importé.
Les paramètres du StyleBook apparaissent sous la forme d’une page d’interface utilisateur qui vous permet de saisir les valeurs de tous les paramètres définis dans ce StyleBook.
-
Saisissez le nom de l’équilibreur de charge et l’adresse IP virtuelle dans la section des paramètres de base de l’équilibreur de charge.
- Dans la section Fichier d’emplacement, saisissez le nom ou l’emplacement du fichier.
Remarque
Assurez-vous que dans NetScaler ADM, le fichier se trouve uniquement dans le dossier du locataire actuel. Utilisez n’importe quel protocole de transfert de fichiers pour copier le fichier vers le système de fichiers de NetScaler ADM.
-
Il peut vous être demandé de fournir vos informations d’identification d’utilisateur avant d’accéder aux instances cibles.
- Sélectionnez l’instance NetScaler cible sur laquelle la configuration doit être créée, puis cliquez sur Créer.
Remarque
Citrix vous recommande de sélectionner Exécution à blanc pour vérifier les objets de configuration créés sur l’instance cible avant d’exécuter la configuration réelle sur l’instance.
Lorsque la création du pack de configuration est réussie, le fichier est enregistré sur le système de fichiers de l’instance NetScaler à l’emplacement : /var/netscaler/inbuilt_db/
Remarque
Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter les instances NetScaler récemment découvertes dans NetScaler ADM à la liste des instances disponibles dans cette fenêtre.
Utilisation de l’API NetScaler ADM pour créer un pack de configuration
Vous pouvez également utiliser l’API NetScaler ADM pour créer un pack de configuration qui charge des fichiers vers l’instance NetScaler sélectionnée. Pour plus d’informations sur l’utilisation des API, consultez Comment utiliser l’API pour créer des configurations afin de charger tout type de fichier.