Paramètres

Cette section vous permet de définir tous les paramètres dont vous avez besoin dans votre StyleBook pour créer une configuration. Il décrit l’entrée prise par votre StyleBook. Bien qu’il s’agisse d’une section facultative, la plupart des StyleBooks peuvent en avoir besoin. Vous pouvez considérer la section Paramètres pour définir les questions auxquelles les utilisateurs doivent répondre lorsqu’ils utilisent le StyleBook pour créer une configuration sur une instance d’Citrix ADC.

Lorsque vous importez votre StyleBook dans Citrix ADM et que vous l’utilisez pour créer une configuration, l’interface graphique utilise cette section du StyleBook pour afficher un formulaire qui prend en entrée les valeurs des paramètres que vous avez définis.

La section suivante décrit les attributs que vous devez spécifier pour chaque paramètre dans cette section :

nom

Nom du paramètre que vous souhaitez définir. Vous pouvez spécifier un nom alphanumérique.

Le nom doit commencer par un alphabet et peut inclure des alphabets, des nombres, un trait d’union (-) ou un trait de soulignement (_).

Notez que lors de l’écriture d’un StyleBook, vous pouvez utiliser cet attribut « name » pour faire référence au paramètre dans d’autres sections en utilisant la notation $parameters.<name>.

Obligatoire ? Oui

étiquette

Chaîne affichée dans l’interface graphique ADM comme nom de ce paramètre.

Obligatoire ? Non

description

Chaîne d’aide qui décrit à quoi sert le paramètre. L’interface graphique ADM affiche ce texte lorsque l’utilisateur clique sur l’icône d’aide pour ce paramètre.

Obligatoire ? Non

type

Type de valeur que ces paramètres peuvent prendre. Les paramètres peuvent être de l’un des types intégrés suivants :

  • string : un tableau de caractères. Si aucune longueur n’est spécifiée, la valeur de chaîne peut prendre n’importe quel nombre de caractères. Toutefois, vous pouvez limiter la longueur d’un type de chaîne en utilisant les attributs min-length et max-length.

  • number : Un nombre entier. Vous pouvez spécifier le nombre minimum et maximum que ce type peut prendre à l’aide des attributs min-value et max-value.

  • boolean : peut être vrai ou faux. Notez également que tous les littéraux sont considérés par YAML comme des booléens (par exemple, Oui ou Non).

  • ipaddress : chaîne qui représente une adresse IPv4 ou IPv6 valide.

  • tcp-port : nombre compris entre 0 et 65535 qui représente un port TCP ou UDP.

  • password : Représente une valeur de chaîne opaque/secrète. Lorsque l’interface graphique de NetScaler MAS affiche une valeur pour ce paramètre, elle est affichée sous forme d’astérisques (*****).

  • certfile : Représente un fichier de certificat. Cela vous permet de télécharger les fichiers directement à partir de votre système local lorsque vous créez une configuration StyleBook à l’aide de l’interface graphique ADM. Le fichier de certificat téléchargé est stocké dans le répertoire /var/mps/tenants/ <tenant_path> /ns_ssl_certs dans ADM.

    Le fichier de certificat sera ajouté à la liste des certificats gérés par ADM.

  • keyfile : Représente un fichier de clé de certificat. Cela vous permet de télécharger le fichier directement à partir de votre système local lorsque vous créez une configuration StyleBook à l’aide de l’interface graphique de NetScaler MAS. Le fichier de certificat téléchargé est stocké dans le répertoire /var/mps/tenants/ <tenant_path> /ns_ssl_keys dans NetScaler MAS.

    Le fichier de clé de certificat sera ajouté à la liste des clés de certificat gérées par NetScaler MAS.

  • file : Représente un fichier.

  • objet : Ce type est utilisé lorsque vous souhaitez regrouper plusieurs paramètres liés sous un élément parent. Vous devez spécifier le paramètre parent le type comme « objet ». Un paramètre de type « object » peut avoir une section « parameters » imbriquée pour décrire les paramètres qu’il contient.

  • un autre StyleBook : Lorsque vous utilisez ce type de paramètre, ce paramètre s’attend à ce que sa valeur soit sous la forme des paramètres définis dans le StyleBook indiquant son type.

Un paramètre peut également avoir un type qui est une liste de l’un des types énumérés ci-dessus, en ajoutant « [] » à la fin du type. Par exemple, si l’attribut type est string [], ce paramètre prend une liste de chaînes en entrée. Vous pouvez fournir une, deux ou plusieurs chaînes pour ce paramètre lors de la création d’une configuration à partir de ce StyleBook.

Obligatoire ? Oui

clé

Spécifiez true ou false pour indiquer si ce paramètre est un paramètre clé pour le StyleBook.

Un StyleBook ne peut avoir qu’un seul paramètre défini comme le paramètre « key ».

Lorsque vous créez des configurations différentes à partir du même StyleBook (sur les mêmes instances NetScaler ou différentes), chaque configuration a une valeur différente/unique pour ce paramètre.

La valeur par défaut est false.

Obligatoire ? Non

requis

Spécifiez true ou false pour indiquer si un paramètre est obligatoire ou facultatif. S’il est défini sur true, le paramètre est obligatoire et l’utilisateur doit fournir une valeur pour ce paramètre lors de la création de configurations.

L’interface graphique NetScaler MAS force l’utilisateur à fournir une valeur valide pour ce paramètre.

La valeur par défaut est false.

Obligatoire ? Non

valeurs autorisées

Utilisez cet attribut pour définir une liste de valeurs valides pour un paramètre, lorsque le type est défini sur « string. »

Lors de la création d’une configuration à partir de l’interface graphique de NetScaler MAS, l’utilisateur est invité à sélectionner une valeur de paramètre dans cette liste.

Exemple 1 :

nom : adresse IP

type : chaîne

allowed-values:

  • SOURCEIP
  • DEST IP
  • NONE

Exemple 2 :

nom : Port TCP

type : tcp-port

allowed-values:

  • 80
  • 81
  • 8080

Exemple 3 :

(liste des ports tcp-, où chaque élément de la liste ne peut avoir que des valeurs spécifiées dans les valeurs autorisées)

nom : tcpports

type : tcp-port []

allowed-values:

  • 80
  • 81
  • 8080
  • 8081

Obligatoire ? Non

Par défaut

Utilisez cet attribut pour affecter une valeur par défaut à un paramètre facultatif. Lors de la création d’une configuration, si un utilisateur ne spécifie pas de valeur, la valeur par défaut est utilisée.

Lors de la création de la configuration à partir de l’interface graphique NetScaler MAS, si un utilisateur ne fournit pas de valeur pour un paramètre qui n’a pas de valeur par défaut, aucune valeur n’est définie pour ce paramètre.

Exemple 1 :

nom : délai d’expiration

type : nombre

def ault : 20

Exemple 2 :

(où la valeur par défaut du paramètre est une liste de valeurs) :

nom : protocoles

type : chaîne []

par défaut :

  • TCP
  • UDP
  • Adresse IP

Exemple 3 :

nom : délai d’expiration

type : nombre

défaut: 20

Exemple 4 :

nom : tcpport

type : tcp-port

défaut: 20

Obligatoire ? Non

modèle

Utilisez cet attribut pour définir un motif (expression régulière) pour les valeurs valides de ce paramètre, lorsque le type du paramètre est « string. »

Exemple :

name : appname

type : chaîne

motif : “[a-z]+ »

Obligatoire ? Non

min-value

Utilisez cet attribut pour définir la valeur minimale des paramètres de type « number » ou « tcp-port ».

Exemple :

nom : audio-port

type : tcp-port

min-value : 5000

La valeur min-des nombres peut être négative, mais la valeur min-pour tcp-port ne doit pas être négative.

Obligatoire ? Non

max-value

Utilisez cet attribut pour définir la valeur maximale des paramètres de type « number » ou « tcp-port ».

La valeur maximale doit être supérieure à la valeur minimale, si elle est définie.

Exemple :

nom : audio-port

type : tcp-port

min-value : 5000

valeur max-: 15000

Obligatoire ? Non

min-length

Utilisez cet attribut pour définir la longueur minimale des valeurs acceptées pour un paramètre de type « string. »

La longueur minimale des caractères définis en tant que valeurs doit être supérieure ou égale à zéro.

Exemple :

name : appname

type : chaîne

min-length : 3

Obligatoire ? Non

max-length

Utilisez cet attribut pour définir la longueur maximale des valeurs acceptées pour un paramètre de type « string. »

La longueur maximale des valeurs doit être supérieure ou égale à la longueur des caractères définis en min-length.

Exemple :

name : appname

type : chaîne

max-length : 64

Obligatoire ? Non

min-items

Utilisez cet attribut pour définir le nombre minimum d’éléments dans un paramètre qui est une liste.

Le nombre minimum d’éléments doit être supérieur ou égal à zéro.

Exemple :

nom : server-ips

type : ipaddress[]

min-items : 2

Obligatoire ? Non

max-items

Utilisez cet attribut pour définir le nombre maximal d’éléments dans un paramètre qui est une liste.

Le nombre maximal d’articles doit être supérieur au nombre minimum d’articles s’il est défini.

Exemple :

nom : server-ips

type : ipaddress[]

min-items : 2

max-items : 250

Obligatoire ? Non

Gui

Utilisez cet attribut pour personnaliser la disposition du paramètre de type « object » dans l’interface graphique de NetScaler MAS.

Obligatoire ? Non

colonnes

Ceci est un sous-attribut de l’attribut gui. Utilisez cette option pour définir le nombre de colonnes à afficher dans l’interface graphique de NetScaler MAS.

Obligatoire ? Non

modifiable

Ceci est un sous-attribut de l’attribut gui. Utilisez cette option pour spécifier si le paramètre peut être mis à jour après la création de la configuration.

Si la valeur est définie sur false, le champ de paramètre est grisé lorsque vous mettez à jour la configuration.

Obligatoire ? Non

collapse_pane

Ceci est un sous-attribut de l’attribut gui. Utilisez cette option pour spécifier si le volet définissant la disposition de ce paramètre d’objet est pliable.

Si la valeur est définie sur true, l’utilisateur peut développer ou réduire les paramètres enfants sous ce paramètre parent.

Exemple :

GUI :

 collapse_pane : true

 colonnes : 2

 modifiable : false

Exemple de section complète des paramètres :


parameters:

   -

      name: name

      label: Name

      description: Name of the application

      type: string

      required: true

   -

      name: ip

      label: IP Address

      description: The virtual IP address used for this application

      type: ipaddress

      required: true

   -

      name: svc-servers

      label: Servers

      type: object[]

      required: true

        parameters:

           -

             name: svc-ip

             label: Server IP

             description: The IP address of the server

             type: ipaddress

             required: true

            -

              name: svc-port

              label: Server Port

              description: The TCP port of the server

              type: tcp-port

              default: 80

    -

       name: lb-alg

       label: LoadBalancing Algorithm

       type: string

       allowed-values:

         - ROUNDROBIN

         - LEASTCONNECTION

        default: ROUNDROBIN

     -

        name: enable-healthcheck

        label: Enable HealthCheck?

        type: boolean

        default: true

Voici un exemple qui définit tous les attributs d’une liste et les valeurs expliquées dans les sections précédentes :

   name: features-list

   type: string[]**

   min-length: 1

   max-length: 3

   min-items: 1

   max-items: 3

   pattern: "[A-Z]+"

    allowed-values:

     - SP

     - LB

     - CS

     default:

      - LB