Voir PDF
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