Citrix Application Delivery Management service

Créer un StyleBook pour charger des fichiers vers Citrix ADM

Les StyleBooks Citrix Application Delivery Management (Citrix ADM) vous permettent de créer des configurations Citrix ADC qui peuvent inclure entre autres choses lors du téléchargement de fichiers de tout type à partir de votre système de fichiers local vers l’instance ADC Citrix, à l’aide de l’interface graphique Citrix ADM ou des API. Ces fichiers peuvent être les exemples de fichiers de certificat ou de géolocalisation. Vous pouvez également spécifier le répertoire pour charger ces fichiers.

Configuration d’un StyleBook

Voici un exemple de StyleBook qui décrit comment télécharger un fichier de géolocalisation sur l’instance de Citrix ADC. 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 Citrix ADC
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 Citrix 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)

Remarque

Le paramètre utilisé dans cet exemple est un fichier de type. Vous pouvez importer ce StyleBook dans Citrix ADM et l’utiliser pour télécharger des fichiers de géolocalisation.

Ce StyleBook requiert que le fichier soit déjà présent dans Citrix ADM (par exemple, vous l’avez déjà copié dans Citrix ADM à l’aide d’un utilitaire comme scp). Si vous souhaitez télécharger un fichier vers des Citrix ADC via Citrix ADM sans le copier au préalable dans le système de fichiers Citrix ADM, vous pouvez créer un StyleBook qui comporte deux paramètres « chaîne », l’un permet de spécifier le nom de fichier à utiliser sur le Citrix ADC et l’autre pour spécifier le contenu de l’objet et utilisez ces deux paramètres dans les composants upload-file-comp. Voici un StyleBook alternatif 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 Citrix ADC
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 Citrix ADC
  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/Citrix ADC/inbuilt_db/"
   filecontent: base64.encode($parameters.filecontents)

Création de configurations pour télécharger des fichiers

La procédure suivante crée une configuration sur une instance Citrix ADC sélectionnée qui téléchargerait 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 Citrix ADM, accédez à Applications > Configuration, puis cliquez sur Créer un nouveau . La page Choisir un StyleBook affiche tous les StyleBooks disponibles dans votre Citrix ADM. Faites défiler vers le bas et sélectionnez le StyleBook que vous avez importé.

    Les paramètres StyleBook s’affichent sous la forme d’une page d’interface utilisateur qui vous permet d’entrer 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 Paramètres de base de l’équilibreur de charge.

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

    Remarque

    Assurez-vous que dans Citrix ADM, le fichier se trouve sous le dossier du locataire actuel uniquement. Utilisez n’importe quel protocole de transfert de fichiers pour copier le fichier dans le système de fichiers Citrix ADM.

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

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

Remarque

Citrix vous 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 configpack réussit, le fichier est enregistré sur le système de fichiers de l’instance Citrix ADC sous l’emplacement :/var/netscaler/inbuilt_db/

Remarque

Vous pouvez également cliquer sur l’icône d’actualisation pour ajouter des instances Citrix ADC récemment découvertes dans Citrix ADM à la liste des instances disponibles dans cette fenêtre.

Utilisation de l’API Citrix ADM pour créer un configpack

Vous pouvez également utiliser l’API Citrix ADM pour créer un configpack qui télécharge des fichiers vers l’instance Citrix ADC sélectionnée. Pour plus d’informations sur l’utilisation des API, reportez-vous à la section Comment utiliser l’API pour créer des configurations pour charger n’importe quel type de fichier.

Créer un StyleBook pour charger des fichiers vers Citrix ADM