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 que votre StyleBook prend. Bien que cette section soit facultative, la plupart des StyleBook peuvent en avoir besoin. Vous pouvez consulter la section des paramètres pour définir les champs destinés aux utilisateurs qui utilisent le StyleBook pour créer une configuration sur une instance NetScaler.
Lorsque vous importez votre StyleBook dans NetScaler ADM et que vous l’utilisez pour créer une configuration, l’interface graphique utilise cette section du StyleBook pour afficher un formulaire. Ce formulaire prend une entrée pour les valeurs de paramètre définies.
La section suivante décrit les attributs que vous devez spécifier pour chaque paramètre de 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 plus d’alphabets, de nombres, de trait d’union (-) ou de trait de soulignement (_).
Lorsque vous écrivez 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 d’ADM en tant que 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 associée à 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 la 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: nombre entier. Vous pouvez spécifier le nombre minimum et maximum que ce type peut prendre en utilisant les attributs min-value et max-value. -
boolean: Peut être vrai ou faux. YAML considère tous les littéraux comme des booléens (par exemple, Oui ou Non). -
ipaddress: chaîne représentant une adresse IPv4 ou IPv6 valide. -
ipnetwork: Il a deux parties. La première partie est l’adresse IP et la deuxième partie est le masque de réseau.
Le masque réseau se compose de la longueur du masque réseau (
netmask-len) ou de l’adresse IP du masque réseau (netmask_ip). La longueur du masque de réseau est un entier compris entre 0 et 32 et 0 à 128 pour une adresse IPv6. Il est utilisé pour déterminer le nombre d’adresses IP dans un réseau.Lorsque vous créez ou mettez à jour un pack de configuration à partir de l’interface graphique NetScaler ADM, vous pouvez effectuer l’une des actions suivantes :
- Activez la longueur du masque réseau et saisissez l’adresse IP et la longueur du masque réseau
- Désactivez la longueur du masque réseau et saisissez l’adresse IP et l’adresse IP du masque de réseau
Dans l’API, la longueur du masque réseau et l’adresse IP du masque réseau sont disponibles sous la forme d’une valeur unique, comme indiqué dans l’exemple suivant :
Exemple :
Content-Type: application/json Accept: application/json { “configpack”: { “stylebook”: { “namespace”: “com.example.stylebook”, “version”:“1.0”, “name”: “ipnetwork-example”, .. }, “parameters”: { “name: “test-app”, “virtual-ip”: “212.100.30.0/255.255.255.0”, }, “targets”: [ ] } } <!--NeedCopy--> -
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 ADM affiche une valeur pour ce paramètre, elle est affichée sous forme d’astérisques (*****). -
certfile: Représente un fichier de certificat. Cette valeur vous permet de 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_certsd’ADM.Le fichier de certificat est ajouté à la liste des certificats gérés par ADM.
-
keyfile: Représente un fichier de clé de certificat. Cette valeur vous permet de charger le fichier 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_keysd’ADM.Le fichier de clé de certificat est ajouté à la liste des clés de certificat gérées par ADM.
-
file: Représente un fichier. -
object: Ce type est utilisé lorsque vous souhaitez regrouper plusieurs paramètres associés sous un élément parent. Spécifiez le paramètre parent le type comme « objet ». Un paramètre de type « objet » peut avoir une section « paramètres » imbriquée pour décrire les paramètres qu’il contient. -
another 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 la liste des types. Pour ce faire, ajoutez [] à la fin du type. Par exemple, si l’ type attribut 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
‘réseau’
Pour type: ipaddress, vous pouvez spécifier l’ network attribut pour allouer automatiquement une adresse IP à partir d’un réseau ADM IPAM.
ADM alloue automatiquement une adresse IP à partir de l’attribut network lorsque vous créez une configuration StyleBook.
Exemple :
name: virtual-ip
label: "Load Balancer IP Address"
type: ipaddress
network: "network-1"
required: true
<!--NeedCopy-->
Dans cet exemple, le virtual-ip champ alloue automatiquement une adresse IP à partir de network-1.L’adresse IP est libérée sur le réseau lorsque la configuration est supprimée.
‘allocation dynamique’
L’ dynamic-allocation attribut est ajouté dans la définition du paramètre de type:ipaddress. Utilisez cet attribut pour répertorier dynamiquement les réseaux ADM IPAM. Cet attribut peut prendre true soit soit false en entrée. Pour type: ipaddress, spécifiez l’ dynamic-allocation: true attribut pour répertorier dynamiquement les réseaux ADM IPAM qui sont dans ADM. Dans le formulaire de création du pack de configuration, vous pouvez effectuer les opérations suivantes :
-
Sélectionnez le réseau IPAM requis dans la liste.
-
Spécifiez une adresse IP que vous souhaitez allouer à partir du réseau IPAM sélectionné.
Si aucune adresse IP n’est spécifiée, l’ADM alloue automatiquement une adresse IP à partir du réseau IPAM sélectionné.
Exemple :
-
name: virtual-ip
label: "Load Balancer IP Address"
type: ipaddress
dynamic-allocation: true
required: true
<!--NeedCopy-->
Dans cet exemple, le virtual-ip champ répertorie les réseaux ADM IPAM qui sont dans ADM. Sélectionnez un réseau dans la liste pour allouer automatiquement une adresse IP à partir du réseau. L’adresse IP est libérée sur le réseau lorsque la configuration est supprimée.
‘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 paramètre « key ».
Lorsque vous créez des configurations différentes à partir du même StyleBook (sur des instances ADC identiques ou différentes), chaque configuration a une valeur différente ou 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 ADM oblige l’utilisateur à fournir une valeur valide pour ce paramètre.
La valeur par défaut est false.
Obligatoire ? Non
« valeurs alloué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 ADM, l’utilisateur est invité à sélectionner une valeur de paramètre dans cette liste.
Remarque
Si vous souhaitez afficher les valeurs de la liste sous forme d’options radio, définissez l’
layoutattribut.
Exemple 1 :
-
name: ipaddress
type: string
allowed-values:
- SOURCEIP
- DEST IP
- NONE
<!--NeedCopy-->
Exemple 2 :
-
name: TCP Port
type: tcp-port
allowed-values:
- 80
- 81
- 8080
<!--NeedCopy-->
Exemple 3 :
Liste de tcp-ports, où chaque élément de la liste ne peut avoir que des valeurs spécifiées dans allowed-values.
-
name: tcpports
type: tcp-port[]
allowed-values:
- 80
- 81
- 8080
- 8081
<!--NeedCopy-->
Obligatoire ? Non
« par défaut »
Utilisez cet attribut pour affecter une valeur par défaut à un paramètre facultatif. Lorsqu’un utilisateur crée une configuration sans spécifier de valeur, la valeur par défaut est utilisée.
Le paramètre ne prend aucune valeur si les conditions suivantes sont remplies :
-
Le paramètre n’a pas de valeur par défaut.
-
Un utilisateur ne fournit pas de valeur pour le paramètre.
Exemple 1 :
-
name: timeout
type: number
default: 20
<!--NeedCopy-->
Exemple 2 :
Pour répertorier les valeurs par défaut du paramètre :
-
name: protocols
type: string[]
default:
- TCP
- UDP
- IP
<!--NeedCopy-->
Exemple 3 :
-
name: timeout
type: number
default: 20
<!--NeedCopy-->
Exemple 4:
-
name: tcpport
type: tcp-port
default: 20
<!--NeedCopy-->
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: string
pattern: "[a-z]+"
<!--NeedCopy-->
Obligatoire ? Non
‘Min-valeur’
Utilisez cet attribut pour définir la valeur minimale pour les paramètres de type number ou tcp-port.
Exemple :
-
name: audio-port
type: tcp-port
min-value: 5000
<!--NeedCopy-->
Les min-value nombres peuvent être négatifs. Cependant, le min-value for tcp-port doit être positif.
Obligatoire ? Non
‘max-value’
Utilisez cet attribut pour définir la valeur maximale des paramètres de type number ou
tcp-port.
Assurez-vous que la valeur maximale est supérieure à la valeur minimale, si elle est définie.
Exemple :
-
name: audio-port
type: tcp-port
min-value: 5000
max-value: 15000
<!--NeedCopy-->
Obligatoire ? Non
‘min-longueur’
Utilisez cet attribut pour définir la longueur minimale des valeurs acceptées pour un paramètre de type « string. »
Assurez-vous que la longueur minimale des caractères définis comme valeurs est supérieure ou égale à zéro.
Exemple :
-
name: appname
type: string
min-length: 3
<!--NeedCopy-->
Obligatoire ? Non
‘longueur’
Utilisez cet attribut pour définir la longueur maximale des valeurs acceptées pour un paramètre de type « string. »
Assurez-vous que la longueur maximale des valeurs est supérieure ou égale à la longueur des caractères définis dans min-length.
Exemple :
-
name: appname
type: string
max-length: 64
<!--NeedCopy-->
Obligatoire ? Non
‘min-items’
Utilisez cet attribut pour définir le nombre minimal d’éléments d’un paramètre qui est une liste.
Assurez-vous que le nombre minimum d’articles est supérieur ou égal à zéro.
Exemple :
-
name: server-ips
type: ipaddress[]
min-items: 2
<!--NeedCopy-->
Obligatoire ? Non
‘max-items’
Utilisez cet attribut pour définir le nombre maximal d’éléments dans un paramètre qui est une liste.
Assurez-vous que le nombre maximal d’éléments est supérieur au nombre minimal d’éléments si défini.
Exemple :
-
name: server-ips
type: ipaddress[]
min-items: 2
max-items: 250
<!--NeedCopy-->
Obligatoire ? Non
‘gui’
Utilisez cet attribut pour personnaliser la disposition du paramètre dans l’interface graphique ADM.
Obligatoire ? Non
‘colonnes’
Cet attribut est un sous-attribut de l’attribut gui. Utilisez cet attribut pour définir le nombre de colonnes pour afficher les type: object[] paramètres dans l’interface graphique ADM.
Obligatoire ? Non
‘updatable’
Cet attribut est un sous-attribut de l’ gui attribut. Utilisez cet attribut pour spécifier si le paramètre peut être mis à jour après la création de la configuration. Définissez cet attribut uniquement sur des types de paramètres simples tels que chaîne, booléenne ou nombre.
Si la valeur est définie sur false, le champ paramètre est grisé lorsque vous mettez à jour la configuration.
Obligatoire ? Non
‘collapse_pane’
Cet attribut est un sous-attribut de l’attribut gui. Utilisez cet attribut pour spécifier si le volet définissant la disposition de ce paramètre d’objet est réductible.
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
columns: 2
<!--NeedCopy-->
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
<!--NeedCopy-->
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
<!--NeedCopy-->
‘mise en page ‘
Cet attribut est un sous-attribut de l’attribut gui. Utilisez cet attribut pour afficher les valeurs de liste sous forme de boutons radio. Définissez l’ layout attribut sur radio dans la section des paramètres d’une définition StyleBook. Elle s’applique au paramètre qui possède l’ allowed-values attribut. Lorsque vous créez un pack de configuration, l’interface graphique d’ADM affiche les valeurs de la allowed-valuesliste sous forme de boutons radio.
Exemple :
-
gui:
layout: radio
allowed-values:
- One
- Two
- Three
<!--NeedCopy-->
Les valeurs Un, Deux et Trois apparaissent sous forme de boutons radio dans l’interface graphique ADM.
‘paramètres-dépendants’
Cet attribut est un sous-attribut de l’attribut gui. Il contrôle dynamiquement l’apparence du paramètre ou sa valeur initiale dans l’écran de configuration StyleBook en fonction de la valeur spécifiée dans un autre paramètre.
Spécifiez cet attribut sur un paramètre source qui contrôle le comportement du paramètre sur le formulaire. Vous pouvez inclure plusieurs conditions qui contrôlent d’autres paramètres. Par exemple, un paramètre source protocol peut avoir un paramètre dépendant certificate, qui n’apparaît que si la valeur du protocol paramètre est SSL.
Chaque condition peut avoir les attributs suivants :
-
target-parameter : spécifiez le paramètre cible auquel cette condition s’applique.
-
matching-values : spécifiez la liste des valeurs du paramètre source qui déclenche l’action.
-
action : spécifiez l’une des actions suivantes sur le paramètre ciblé :
-
read-only: le paramètre est en lecture seule. -
show: le paramètre apparaît dans le formulaire s’il est masqué. -
hide: le paramètre est supprimé du formulaire. -
set-value: la valeur du paramètre est définie sur la valeur spécifiée dans l’attribut value.
-
-
value : valeur du paramètre cible si l’action est
set-value.
Lorsqu’une entrée utilisateur correspond aux valeurs spécifiées sur le paramètre source, l’apparence ou la valeur du paramètre cible change en fonction de l’action spécifiée.
Exemple :
-
name: lb-virtual-port
label: "Load Balanced App Virtual Port"
description: "TCP port representing the Load Balanced application"
type: tcp-port
gui:
updatable: false
dependent-parameters:
-
matching-values:
- 80
target-parameter: $parameters.lb-service-type
action: set-value
allowed-values:
- HTTP
- TCP
- UDP
default: 80
<!--NeedCopy-->
Dans cet exemple, le paramètre dépendant est spécifié sous le paramètre lb-virtual-port (paramètre source).
Lorsque la valeur du paramètre source est définie sur 80, le paramètre lb-service-type déclenche l’action set-value. Par conséquent, un utilisateur est autorisé à sélectionner l’une des options suivantes :
- HTTP
- TCP
- UDP