Configuration de StyleBook

Créez un StyleBook pour télécharger des fichiers

Les NetScaler Console StyleBooks vous permettent de créer des configurations NetScaler qui peuvent notamment inclure le téléchargement de fichiers de tout type depuis votre système de fichiers local vers l’instance NetScaler, à l’aide de l’interface graphique de la console NetScaler ou des API. Ces fichiers peuvent être des exemples de fichiers de certificats ou de fichiers de géolocalisation. Vous pouvez également spécifier le répertoire dans lequel télécharger ces fichiers.

Configuration de StyleBook

Voici un exemple de StyleBook qui décrit comment télécharger un fichier de géolocalisation sur l’instance NetScaler. Les fichiers géo sont généralement utilisés dans les configurations GSLB pour définir la proximité statique en fonction de l’emplacement géographique :

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 Console
 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 un fichier de type. Vous pouvez importer ce StyleBook dans la console NetScaler et l’utiliser pour télécharger des fichiers de géolocalisation.

Ce StyleBook nécessite que le fichier soit déjà présent dans NetScaler Console (par exemple, vous l’auriez déjà copié dans NetScaler Console à l’aide d’un utilitaire tel que SCP). Si vous souhaitez télécharger un fichier vers NetScalers via NetScaler Console sans le copier au préalable dans le système de fichiers de la NetScaler Console, vous pouvez créer un StyleBook doté de deux paramètres « chaîne », l’un servant à spécifier le nom du fichier à utiliser sur NetScaler et l’autre à spécifier le contenu du fichier, et utiliser ces deux paramètres dans les composants upload-file-comp. Voici une alternative à StyleBook pour télé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 télécharger des fichiers

La procédure suivante crée une configuration sur une instance NetScaler sélectionnée qui téléchargera un fichier de géolocalisation à l’aide du premier StyleBook décrit ci-dessus.

Pour créer une configuration pour le téléchargement de fichiers :

  1. Dans la console NetScaler, accédez à ApplicationsConfiguration, puis cliquez surCréer un nouveau. La page Choisir StyleBook affiche tous les StyleBooks disponibles dans votre console NetScaler. 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.

  2. Entrez 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.

  3. Dans la section Fichier de localisation, entrez le nom ou l’emplacement du fichier.

    Remarque

    Assurez-vous que dans la console NetScaler, le fichier se trouve uniquement dans le dossier du locataire actuel. Utilisez n’importe quel protocole FTP pour copier le fichier dans le système de fichiers de la console NetScaler.

  4. Vous pouvez être invité à fournir vos informations d’identification utilisateur avant d’accéder aux instances cibles.

  5. Sélectionnez l’instance NetScaler cible sur laquelle la configuration doit être créée, puis cliquez sur Créer.

Remarque

Citrix recommande de sélectionner Exécuter à sec 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 suivant : /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 Console à la liste des instances disponibles dans cette fenêtre.

Utilisation de l’API NetScaler Console pour créer un pack de configuration

Vous pouvez également utiliser l’API NetScaler Console pour créer un pack de configuration qui télécharge les 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 télécharger n’importe quel type de fichier .

Créez un StyleBook pour télécharger des fichiers