Parameter
In diesem Abschnitt können Sie alle Parameter definieren, die Sie in Ihrem StyleBook benötigen, um eine Konfiguration zu erstellen. Es beschreibt die Eingabe, die Ihr StyleBook nimmt. Obwohl dieser Abschnitt optional ist, benötigen die meisten StyleBook möglicherweise einen. Sie können den Abschnitt Parameter in Betracht ziehen, um die Felder für die Benutzer zu definieren, die das StyleBook zum Erstellen einer Konfiguration auf einer NetScaler-Instanz verwenden.
Wenn Sie Ihr StyleBook in NetScaler ADM importieren und zum Erstellen einer Konfiguration verwenden, verwendet die GUI diesen Abschnitt des StyleBook, um ein Formular anzuzeigen. Dieses Formular nimmt eine Eingabe für die definierten Parameterwerte an.
Im folgenden Abschnitt werden die Attribute beschrieben, die Sie für jeden Parameter in diesem Abschnitt angeben müssen:
‘name’
Der Name des Parameters, den Sie definieren möchten. Sie können einen alphanumerischen Namen angeben.
Der Name muss mit einem Alphabet beginnen und kann mehr Alphabete, Zahlen, Bindestriche (-) oder Unterstriche (_) enthalten.
Wenn Sie ein StyleBook schreiben, können Sie das Attributname
verwenden, um auf den Parameter in anderen Abschnitten zu verweisen, indem Sie die Notation $parameters.
Obligatorisch? Ja
‘label’
Eine Zeichenfolge, die in der NetScaler ADM GUI als Name dieses Parameters angezeigt wird.
Obligatorisch? Nein
‘description’
Eine Hilfe-Zeichenfolge, die beschreibt, wofür der Parameter verwendet wird. Die NetScaler ADM GUI zeigt diesen Text an, wenn der Benutzer auf das Hilfesymbol für diesen Parameter klickt.
Obligatorisch? Nein
‘type’
Die Art des Wertes, den diese Parameter annehmen können. Parameter können von einem der folgenden integrierten Typen sein:
string
: Eine Reihe von Zeichen. Wenn keine Länge angegeben wird, kann der Zeichenfolgenwert beliebig viele Zeichen annehmen. Sie können jedoch die Länge eines String-Typs einschränken, indem Sie die Attribute min-length und max-length verwenden.number
: Eine ganze Zahl. Sie können die minimale und maximale Anzahl angeben, die dieser Typ annehmen kann, indem Sie die Attribute min-value und max-value verwenden.boolean
: Kann entweder wahr oder falsch sein. YAML betrachtet alle Literale als Boolesche (zum Beispiel Ja oder Nein).ipaddress
: Eine Zeichenfolge, die eine gültige IPv4- oder IPv6-Adresse darstellt.ipnetwork
: Es besteht aus zwei Teilen. Der erste Teil ist die IP-Adresse und der zweite Teil ist die Netzwerkmaske.Die Netzmaske besteht aus der Netzmaskenlänge (
netmask-len
) oder der Netzmasken-IP-Adresse (netmask_ip
). Die Netzwerkmaskenlänge ist eine Ganzzahl zwischen 0-32 und 0-128 für eine IPv6-Adresse. Es wird verwendet, um die Anzahl der IP-Adressen in einem Netzwerk zu bestimmen.Wenn Sie ein Konfigurationspaket über die NetScaler ADM GUI erstellen oder aktualisieren, können Sie eine der folgenden Aktionen ausführen:
- Aktivieren您死Netzmaskenlänge und geben Sie die IP-Adresse und die Netzmaskenlänge ein
- Deaktivieren Sie die Netzmaskenlänge und geben Sie die IP-Adresse und die Netzmasken-IP-Adresse ein
tcp-port
: Eine Zahl zwischen 0 und 65535, die einen TCP- oder UDP-Port repräsentiert.password
: Repräsentiert einen undurchsichtigen/geheimen String-Wert. Wenn die NetScaler ADM GUI einen Wert für diesen Parameter anzeigt, wird er als Sternchen (*****) angezeigt.certfile
: Repräsentiert eine Zertifikatdatei. Mit diesem Wert können Sie die Dateien direkt von Ihrem lokalen System hochladen, wenn Sie eine StyleBook-Konfiguration mit der NetScaler ADM GUI erstellen. Die hochgeladene Zertifikatsdatei wird im Verzeichnis/var/mps/tenants/\
in NetScaler ADM gespeichert./ns_ssl_certs Die Zertifikatsdatei wird der Liste der von NetScaler ADM verwalteten Zertifikate hinzugefügt.
keyfile
: Repräsentiert eine Zertifikatschlüsseldatei. Mit diesem Wert können Sie die Datei direkt von Ihrem lokalen System hochladen, wenn Sie eine StyleBook-Konfiguration mit der NetScaler ADM GUI erstellen. Die hochgeladene Zertifikatsdatei wird im Verzeichnis/var/mps/tenants/\
in NetScaler ADM gespeichert./ns_ssl_keys Die Zertifikatsschlüsseldatei wird der Liste der von NetScaler ADM verwalteten Zertifikatsschlüssel hinzugefügt.
certkey
: Dieser Typ wird verwendet, um SSL-Zertifikate aus dem NetScaler ADM-Zertifikatsspeicher auszuwählen. Dieser Store listet die vorhandenen SSL-Zertifikate auf, die auf Ihren NetScaler ADM-Server hochgeladen wurden. Sie können SSL-Zertifikate also an einem Ort speichern, dem NetScaler ADM-Zertifikatspeicher, und sie bei Bedarf wiederverwenden.Beim Erstellen eines Konfigurationspakets kann ein Benutzer SSL-Zertifikate aus dem Zertifikatspeicher hinzufügen oder auswählen. Außerdem kann der Benutzer dasselbe Zertifikat für mehrere Konfigurationspakete auswählen.
file
: Repräsentiert eine Datei.object
: Dieser Typ wird verwendet, um mehrere verwandte Parameter unter einem übergeordneten Element zu gruppieren. Geben Sie den übergeordneten Parameter den Typ als “Objekt” an. Ein Parameter vom Typ “object” kann einen verschachtelten Abschnitt “parameter” haben, um die darin enthaltenen Parameter zu beschreiben.another StyleBook
:您要是估计值Parametertyp verwenden erwartetdieser Parameter, dass sein Wert in Form der Parameter vorliegt, die im StyleBook definiert sind und seinen Typ angibt.
Ein Parameter kann auch einetype
die Liste der Typen haben. Fügen Sie dazu[]
am Ende des Typs hinzu. Wenn dastype
Attribut beispielsweise lautetstring[]
, verwendet dieser Parameter eine Liste von Strings als Eingabe. Sie können eine, zwei oder mehrere Strings für diesen Parameter angeben, wenn Sie eine Konfiguration aus diesem StyleBook erstellen.
Obligatorisch? Ja
‘network’
Fürtype: ipaddress
können Sie das Attributnetwork
angeben, um eine IP-Adresse aus einem NetScaler ADM IPAM-Netzwerk automatisch zuzuweisen.
NetScaler ADM weist beim Erstellen einer StyleBook-Konfiguration automatisch eine IP-Adresse aus dem Attributnetwork
zu.
Beispiel:
name:virtual-iplabel:"LoadBalancerIPAddress"type:ipaddressnetwork:"network-1"required:true
In diesem Beispiel weist das Feldvirtual-ip
automatisch eine IP-Adresse vonnetwork-1
zu. Die IP-Adresse wird beim Löschen der Konfiguration wieder an das Netzwerk freigegeben.
‘dynamic-allocation’
Dasdynamic-allocation
Attribut wird in der Parameterdefinition von hinzugefügttype:ipaddress
.Verwenden Sie dieses Attribut, um die NetScaler ADM IPAM-Netzwerke dynamisch aufzulisten. Dieses Attribut kann entwedertrue
oderfalse
als Eingabe verwendet werden. Geben Sie fürtype: ipaddress
das Attribut andynamic-allocation: true
, um die NetScaler ADM IPAM-Netzwerke in NetScaler ADM dynamisch aufzulisten. Im Formular zur Erstellung von Konfigurationspakets können Sie Folgendes tun:
民意调查您哒s erforderliche IPAM-Netzwerk aus der Liste aus.
Geben Sie eine IP-Adresse an, die Sie aus dem ausgewählten IPAM-Netzwerk zuweisen möchten.
Wenn keine IP-Adresse angegeben ist, weist NetScaler ADM automatisch eine IP-Adresse aus dem ausgewählten IPAM-Netzwerk zu.
Beispiel:
-name:virtual-iplabel:"LoadBalancerIPAddress"type:ipaddressdynamic-allocation:truerequired:true
In diesem Beispiel listet das Feldvirtual-ip
die NetScaler ADM IPAM-Netzwerke in NetScaler ADM auf. Wählen Sie ein Netzwerk aus der Liste aus, um eine IP-Adresse automatisch aus dem Netzwerk zuzuweisen. Die IP-Adresse wird beim Löschen der Konfiguration wieder an das Netzwerk freigegeben.
‘key’
Geben Sie true oder false an, um anzugeben, ob dieser Parameter ein Schlüsselparameter für das StyleBook ist.
Ein StyleBook kann einen oder mehrere Parameter haben, die als “key” -Parameter definiert sind. Auf der SeiteKonfiguration > Config Packswird der Wert des Parameters alsAnzeigeschey angezeigt.
Wenn Sie verschiedene Konfigurationspakete aus demselben StyleBook erstellen, kann jede Konfiguration einen anderen Wert für diesen Parameter haben. Dieser Wert wird als Anzeigetaste auf der GUI angezeigt. Mit diesem Schlüssel können Sie das Konfigurationspaket sortieren oder filtern.
Beispiel:
parameters:-name:example-appnametype:stringlabel:Application Namerequired:truekey:true
Wenn ein StyleBook-Benutzer ein Konfigurationspaket erstellt, wird der Wert für den Parameterexample-appname
als Anzeigeschlüssel angezeigt. Der StyleBook-Benutzer kann diesen Schlüssel verwenden, um dieses Konfigurationspaket zu identifizieren.
Hinweis
DerKonfigurationsschlüsseleines Konfigurationspakets überschreibt das für einen seiner Parameter festgelegte Schlüsselattribut. Wenn also ein Benutzer einen Wert für den Konfigurationsschlüssel eingibt, wird dieser Wert in der SpalteAnzeigeschey angezeigt.
Der Standardwert ist falsch.
Obligatorisch? Nein
‘required’
Geben Sie true oder false an, um anzugeben, ob ein Parameter obligatorisch oder optional ist. Wenn es auf true gesetzt ist, ist der Parameter obligatorisch und der Benutzer muss beim Erstellen von Konfigurationen einen Wert für diesen Parameter angeben.
Die NetScaler ADM GUI zwingt den Benutzer, einen gültigen Wert für diesen Parameter anzugeben.
Der Standardwert ist falsch.
Obligatorisch? Nein
‘allowed-values’
Verwenden您这本Attribut,一张Liste gultiger Werte für einen Parameter zu definieren, wenn der Typ auf string gesetzt ist.
Beim Erstellen einer Konfiguration über die NetScaler ADM GUI wird der Benutzer aufgefordert, einen Parameterwert aus dieser Liste auszuwählen. Diese Liste ist statisch, der Benutzer kann nur einen Wert aus der Liste auswählen. Wenn Sie dem Benutzer erlauben möchten, Werte zur Liste hinzuzufügen, verwenden Sie das Attributallow-new-values
.
Hinweis
Wenn Sie die Listenwerte als Radiooptionen anzeigen möchten, legen Sie das Attribut
layout
fest.
Beispiel 1:
-name:ipaddresstype:stringallowed-values:-SOURCEIP-DEST IP-NONE
Beispiel 2:
-name:TCP Porttype:tcp-portallowed-values:-80-81-8080
Beispiel 3:
Liste vontcp-ports
, in der jedes Element der Liste nur Werte in angegeben haben kannallowed-values
.
-name:tcpportstype:tcp-port[]allowed-values:-80-81-8080-8081
Obligatorisch? Nein
‘allow-new-Werte’
Verwenden Sie dieses Attribut, um eine dynamische Liste für einen Parameter hinzuzufügen. Beim Erstellen oder Aktualisieren einer Konfiguration über die NetScaler ADM GUI kann der Benutzer der Liste Werte hinzufügen.
Geben Sie “true” an, wenn der Benutzer der Parameterliste einen Wert hinzufügen soll. Sie können die Attributeallow-new-values
undallowed-values
in Kombination verwenden. Diese Kombination ermöglicht es Ihnen, eine Liste von vorgeschlagenen Werten für einen Parameter zu definieren und neue Werte zu akzeptieren.
-name:porttype:tcp-portallowed-values:-80-81-8080allow-new-values:true
In diesem Beispiel kann ein Benutzer entweder aus 80, 81, 8080 auswählen oder beim Erstellen oder Aktualisieren eines Konfigurationspakets einen neuen Wert für den Parameterport
eingeben.
‘default’
Verwenden Sie dieses Attribut, um einem optionalen Parameter einen Standardwert zuzuweisen. Wenn ein Benutzer eine Konfiguration erstellt, ohne einen Wert anzugeben, wird der Standardwert verwendet.
Der Parameter nimmt keinen Wert an, wenn die folgenden Bedingungen erfüllt sind:
Der Parameter hat keinen Standardwert.
Ein Benutzer gibt keinen Wert für den Parameter an.
Beispiel 1:
-name:timeouttype:numberdefault:20
Beispiel 2:
So listen Sie die Standardwerte des Parameters auf:
-name:protocolstype:string[]default:-TCP-UDP-IP
Beispiel 3:
-name:timeouttype:numberdefault:20
Beispiel 4:
-name:tcpporttype:tcp-portdefault:20
Obligatorisch? Nein
‘pattern’
Verwenden Sie dieses Attribut, um ein Muster (regulärer Ausdruck) für die gültigen Werte dieses Parameters zu definieren, wenn der Typ des Parameters string ist.
Beispiel:
-name:appnametype:stringpattern:"[a-z]+"
Obligatorisch? Nein
‘min-value’
Verwenden Sie dieses Attribut, um den Mindestwert für Parameter vom Typnumber
odertcp-port
zu definieren.
Beispiel:
-name:audio-porttype:tcp-portmin-value:5000
min-value
für Zahlen kann negativ sein.min-value
fürtcp-port
muss jedoch positiv sein.
Obligatorisch? Nein
‘max-value’
Verwenden Sie dieses Attribut, um den Höchstwert für Parameter vom Typnumber
oder zu definierentcp-port
.
Stellen Sie sicher, dass der Maximalwert größer als der Mindestwert ist, falls definiert.
Beispiel:
-name:audio-porttype:tcp-portmin-value:5000max-value:15000
Obligatorisch? Nein
‘min-length’
Verwenden Sie dieses Attribut, um die Mindestlänge der Werte zu definieren, die für einen Parameter vom Typ “string” akzeptiert werden.
Stellen Sie sicher, dass die Mindestlänge der Zeichen definiert ist, die größer oder gleich Null sind.
Beispiel:
-name:appnametype:stringmin-length:3
Obligatorisch? Nein
‘max-length’
Verwenden Sie dieses Attribut, um die maximale Länge der Werte zu definieren, die für einen Parameter vom Typ “string” akzeptiert werden.
Stellen Sie sicher, dass die maximale Länge der Werte größer oder gleich der Länge der in definierten Zeichen istmin-length
.
Beispiel:
-name:appnametype:stringmax-length:64
Obligatorisch? Nein
‘min-items’
Verwenden Sie dieses Attribut, um die Mindestanzahl von Elementen in einem Parameter zu definieren, der eine Liste ist.
Stellen Sie sicher, dass die Mindestanzahl von Elementen größer oder gleich Null ist.
Beispiel:
-name:server-ipstype:ipaddress[]min-items:2
Obligatorisch? Nein
‘max-items’
Verwenden Sie dieses Attribut, um die maximale Anzahl von Elementen in einem Parameter zu definieren, der eine Liste ist.
Stellen Sie sicher, dass die maximale Anzahl von Artikeln größer ist als die Mindestanzahl von Elementen, falls definiert.
Beispiel:
-name:server-ipstype:ipaddress[]min-items:2max-items:250
Obligatorisch? Nein
‘gui’
Verwenden Sie dieses Attribut, um das Layout des Parameters in der NetScaler ADM GUI anzupassen.
Obligatorisch? Nein
‘columns’
Dieses Attribut ist ein Unterattribut des Attributsgui
.Verwenden Sie dieses Attribut, um die Anzahl der Spalten für die Anzeige der Parametertype: object[]
in der NetScaler ADM GUI zu definieren.
Obligatorisch? Nein
‘updatable’
Dieses Attribut ist ein Unterattribut des Attributsgui
.Verwenden您这本Attribut,嗯anzugeben obder Parameter nach dem Erstellen der Konfiguration aktualisiert werden kann. Legen Sie dieses Attribut nur für einfache Parametertypen wie String, Boolesch oder Zahl fest.
Wenn der Wert auf festgelegt istfalse
, ist das Parameterfeld beim Aktualisieren der Konfiguration abgeblendet.
Obligatorisch? Nein
‘collapse_pane’
Dieses Attribut ist ein Unterattribut des Attributsgui
.Verwenden您这本Attribut,嗯anzugeben obder Bereich, der das Layout dieses Objektparameters definiert, zusammenlegbar ist.
Wenn der Wert auf true gesetzt ist, kann der Benutzer die untergeordneten Parameter unter diesem übergeordneten Parameter erweitern oder reduzieren.
Beispiel:
gui:collapse_pane:truecolumns:2
Beispiel für einen vollständigen Parameterabschnitt:
parameters:-name:namelabel:Namedescription:Name of the applicationtype:stringrequired:true-name:iplabel:IP Addressdescription:The virtual IP address used for this applicationtype:ipaddressrequired:true-name:svc-serverslabel:Serverstype:object[]required:trueparameters:-name:svc-iplabel:Server IPdescription:The IP address of the servertype:ipaddressrequired:true-name:svc-portlabel:Server Portdescription:The TCP port of the servertype:tcp-portdefault:80-name:lb-alglabel:LoadBalancing Algorithmtype:stringallowed-values:-ROUNDROBIN-LEASTCONNECTIONdefault:ROUNDROBIN-name:enable-healthchecklabel:Enable HealthCheck?type:booleandefault:true
Im Folgenden finden Sie ein Beispiel, das alle Attribute einer Liste und die in früheren Abschnitten erläuterten Werte definiert:
- 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
‘layout’
Dieses Attribut ist ein Unterattribut des Attributsgui
.Verwenden Sie dieses Attribut, um die Listenwerte als Optionsfelder anzuzeigen. Legen Sie daslayout
Attributradio
im Parameterabschnitt einer StyleBook-Definition fest. Sie gilt für den Parameter, der das Attributallowed-values
hat. Wenn Sie ein Konfigurationspaket erstellen, zeigt die NetScaler ADM GUI die Werte in der Listeallowed-values
als Optionsfelder an.
Beispiel:
-gui:layout:radioallowed-values:-One-Two-Three
Die Werte Eins, Zwei und Drei werden als Optionsfelder in der NetScaler ADM-GUI angezeigt.
‘dependent-parameter’
Dieses Attribut ist ein Unterattribut des Attributsgui
.Es steuert dynamisch das Aussehen des Parameters oder seinen Anfangswert im StyleBook-Konfigurationsformular basierend auf dem in einem anderen Parameter angegebenen Wert.
Geben Sie dieses Attribut für einen Quellparameter an, der das Verhalten des Parameters im Formular steuert. Sie können mehrere Bedingungen einbeziehen, die andere Parameter steuern. Beispielsweiseprotocol
kann ein Quellparameter einen dependent-Parameter haben, der nur angezeigt wirdcertificate
, wenn derprotocol
Parameterwert lautetSSL
.
Jede Bedingung kann die folgenden Attribute haben:
target-parameter: Geben Sie den Zielparameter an, für den diese Bedingung gilt.
Matching-Werte: Geben Sie die Liste der Werte des Quellparameters an, der die Aktion auslöst.
action: Geben Sie eine der folgenden Aktionen für den Zielparameter an:
read-only
: Der Parameter wird schreibgeschützt.show
: Der Parameter wird im Formular angezeigt, wenn er ausgeblendet ist.hide
: Der Parameter wird aus dem Formular entfernt.set-value
: Der Parameterwert wird auf den im value-Attribut angegebenen Wert festgelegt.
value: Der Wert des Zielparameters, wenn die Aktion ist
set-value
.
Wenn eine Benutzereingabe den angegebenen Werten für den Quellparameter entspricht, ändert sich das Aussehen oder der Wert des Zielparameters entsprechend der angegebenen Aktion.
Beispiel:
-name:lb-virtual-portlabel:"LoadBalancedAppVirtualPort"description:"TCPportrepresentingtheLoadBalancedapplication"type:tcp-portgui:updatable:falsedependent-parameters:-matching-values:-80target-parameter:$parameters.lb-service-typeaction:set-valueallowed-values:-HTTP-TCP-UDPdefault:80
In diesem Beispiel wird der abhängige Parameter unter dem Parameterlb-virtual-port
(Quellparameter) angegeben.
Wenn der Quellparameterwert auf festgelegt ist80
, löst derlb-service-type
Parameter dieset-value
Aktion aus. Infolgedessen kann ein Benutzer eine der folgenden Optionen auswählen:
- HTTP
- TCP
- UDP