Application Delivery Management

Parameter

February 5, 2024

Beitrag von:

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 dies ein optionaler Abschnitt ist, benötigen die meisten StyleBooks möglicherweise einen. Im Parameterabschnitt können Sie die Fragen definieren, die Benutzer beantworten sollen, wenn sie das StyleBook verwenden, um eine Konfiguration auf einer Citrix ADC Instanz zu erstellen.

Wenn Sie Ihr StyleBook in Citrix ADM importieren und es zum Erstellen einer Konfiguration verwenden, verwendet die GUI diesen Abschnitt des StyleBook, um ein Formular anzuzeigen, das Eingaben für Werte der von Ihnen definierten Parameter übernimmt.

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 zusätzliche Alphabete, Zahlen, Bindestriche (-) oder Unterstriche (_) enthalten.

Beachten Sie, dass Sie beim Schreiben eines StyleBook dieses Attribut name verwenden können, um auf den Parameter in anderen Abschnitten zu verweisen, indem Sie die Notation $parameters verwenden. <name>.

Obligatorisch? Ja

Bezeichnung

Eine Zeichenfolge, die in der ADM-GUI als Name dieses Parameters angezeigt wird.

Obligatorisch? Nein

Beschreibung

Eine Hilfe-Zeichenfolge, die beschreibt, wofür der Parameter verwendet wird. Die ADM-GUI zeigt diesen Text an, wenn der Benutzer auf das Hilfesymbol für diesen Parameter klickt.

Obligatorisch? Nein

typ

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.
Zahl: Eine Ganzzahl. 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 true oder false sein. Beachten Sie auch, dass alle Literale von YAML als boolesche Werte betrachtet werden (z. B. Ja oder Nein).
ipaddress: Ein String, der eine gültige IPv4- oder IPv6-Adresse darstellt.
tcp-Port: Eine Zahl zwischen 0 und 65535, die einen TCP- oder UDP-Port darstellt.
password: Stellt einen undurchsichtigen/geheimen Zeichenfolgenwert dar. Wenn Citrix ADM GUI einen Wert für diesen Parameter anzeigt, wird er als Sternchen (*****) angezeigt.
certfile: Stellt eine Zertifikatdatei dar. Auf diese Weise können Sie die Dateien direkt von Ihrem lokalen System hochladen, wenn Sie eine StyleBook-Konfiguration mit der ADM GUI erstellen. Die hochgeladene Zertifikatsdatei wird im Verzeichnis /var/mps/tenants/ gespeichert/ns_ssl_certs in ADM.

Die Zertifikatsdatei wird der Liste der Zertifikate hinzugefügt, die von ADM verwaltet werden.
keyfile: Stellt eine Zertifikatsschlüsseldatei dar. Auf diese Weise können Sie die Datei direkt von Ihrem lokalen System hochladen, wenn Sie eine StyleBook-Konfiguration mit der Citrix ADM GUI erstellen. Die hochgeladene Zertifikatsdatei wird im Verzeichnis /var/mps/tenants/ gespeichert/ns_ssl_keys in Citrix ADM.

Die Zertifikatschlüsseldatei wird der Liste der Zertifikatschlüssel hinzugefügt, die von Citrix ADM verwaltet werden.
file: Stellt eine Datei dar.
Objekt: Dieser Typ wird verwendet, wenn Sie mehrere verwandte Parameter unter einem übergeordneten Element gruppieren möchten. Sie müssen den übergeordneten Parameter den Typ als Objekt angeben. Ein Parameter vom Typ “object” kann einen verschachtelten Abschnitt “parameter” haben, um die darin enthaltenen Parameter zu beschreiben.
ein anderes StyleBook: Wenn Sie diesen Parametertyp verwenden, erwartet dieser Parameter, dass sein Wert in Form der Parameter ist, die im StyleBook definiert sind, der seinen Typ angibt.

Ein Parameter kann auch einen Typ haben, der eine Liste aller oben aufgeführten Typen ist, indem [] am Ende des Typs hinzugefügt wird. Wenn das type-Attribut beispielsweise string [] ist, nimmt dieser Parameter eine Liste von Zeichenfolgen als Eingabe an. Sie können eine, zwei oder mehrere Zeichenfolgen für diesen Parameter angeben, wenn Sie eine Konfiguration aus diesem StyleBook erstellen.

Obligatorisch? Ja

Schlüssel

Geben Sie true oder false an, um anzugeben, ob dieser Parameter ein Schlüsselparameter für das StyleBook ist.

In einem StyleBook kann nur ein Parameter als “key”-Parameter definiert sein.

Wenn Sie aus demselben StyleBook (auf derselben oder anderen Citrix ADC Instanzen) unterschiedliche Konfigurationen erstellen, weist jede Konfiguration einen anderen/eindeutigen Wert für diesen Parameter auf.

Der Standardwert ist falsch.

Obligatorisch? Nein

erforderlich

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

Hinweis

Wenn ein Parameter type: objectund hat required: false, werden die Unterparameter dieses Parameters nicht ausgewertet.

Wenn Sie möchten, dass der Standardwert der Unterparameter wirksam wird, setzen Sie required: truefür den Hauptparameter wie folgt ein:

    type: object
    required: true
    gui:
      collapse_pane: true
<!--NeedCopy-->

Das Attribut collapse_pane zeigt das Objekt und seine Unterparameter in der Benutzeroberfläche reduziert an, es sei denn, der Benutzer erweitert den Bereich.

zulässige Werte

Verwenden Sie dieses Attribut, um eine Liste gültiger 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.

Beispiel 1:

Name: IP-Adresse

type: string

zulässige Werte:

SOURCEIP
DEST IP
NONE

Beispiel 2:

type: tcp-port

zulässige Werte:

80
81
8080

Beispiel 3:

(Liste der tcp-ports, wobei jedes Element der Liste nur Werte in zulässigen Werten haben kann)

Typ: tcp-port []

zulässige Werte:

80
81
8080
8081

Obligatorisch? Nein

Standard

Verwenden Sie dieses Attribut, um einem optionalen Parameter einen Standardwert zuzuweisen. Wenn ein Benutzer beim Erstellen einer Konfiguration keinen Wert angibt, wird der Standardwert verwendet.

Wenn ein Benutzer beim Erstellen der Konfiguration über die Citrix ADM GUI keinen Wert für einen Parameter angibt, der keinen Standardwert hat, wird für diesen Parameter kein Wert festgelegt.

Beispiel 1:

type: number

Def ault: 20

Beispiel 2:

(wobei der Standardwert des Parameters eine Liste von Werten ist):

type: string []

Standard:

Beispiel 3:

type: number

default: 20

Beispiel 4:

type: tcp-port

default: 20

Obligatorisch? Nein

Muster

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:

type: string

Muster: „[a-z] +“

Obligatorisch? Nein

min-value

Verwenden Sie dieses Attribut, um den Minimalwert für Parameter vom Typ number oder tcp-port zu definieren.

Beispiel:

type: tcp-port

min-value: 5000

Der Min-Wert von Zahlen kann negativ sein, aber der Min-Wert für tcp-port sollte nicht negativ sein.

Obligatorisch? Nein

max-value

Mit diesem Attribut definieren Sie den Maximalwert für Parameter vom Typ number oder tcp-port.

Der Maximalwert sollte größer als der Minimalwert sein, falls definiert.

Beispiel:

type: tcp-port

min-value: 5000

max-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.

Die Mindestlänge der Zeichen, die als Werte definiert sind, sollte größer oder gleich Null sein.

Beispiel:

type: string

min-Länge: 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.

Die maximale Länge der Werte sollte größer oder gleich der Länge der in min-length definierten Zeichen sein.

Beispiel:

type: string

max-length: 64

Obligatorisch? Nein

min-items

Verwenden Sie dieses Attribut, um die minimale Anzahl von Elementen in einem Parameter zu definieren, der eine Liste ist.

Die Mindestanzahl von Elementen sollte größer oder gleich Null sein.

Beispiel:

type: 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.

Die maximale Anzahl von Elementen sollte größer sein als die minimale Anzahl von Elementen, wenn sie definiert sind.

Beispiel:

type: ipaddress[]

min-items: 2

max-items: 250

Obligatorisch? Nein

GUI

Verwenden Sie dieses Attribut, um das Layout des Parameters vom Typ “object” in der Citrix ADM GUI anzupassen.

Obligatorisch? Nein

Spalten

Dies ist ein Unterattribut des GUI-Attributs. Verwenden Sie dies, um die Anzahl der Spalten zu definieren, die in der Citrix ADM GUI angezeigt werden sollen.

Obligatorisch? Nein

updatable

Dies ist ein Unterattribut des GUI-Attributs. Mit dieser Option können Sie angeben, ob der Parameter nach der Erstellung der Konfiguration aktualisiert werden kann.

Wenn der Wert auf false gesetzt ist, wird das Parameterfeld ausgegraut, wenn Sie die Konfiguration aktualisieren.

Obligatorisch? Nein

collapse_pane

Dies ist ein Unterattribut des GUI-Attributs. Geben Sie hier an, ob der Bereich, der das Layout dieses Objektparameters definiert, zusammenklappbar 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: true

     columns: 2

     updatable: false
<!--NeedCopy-->

Beispiel für einen vollständigen Parameterabschnitt:

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

Im Folgenden finden Sie ein Beispiel, das alle Attribute einer Liste und die in früheren Abschnitten erläuterten Werte definiert:

```YAML -Name: Features-Liste

Typ: string []**

min-length: 1

max-length: 3

min-items: 1

max-items: 3

pattern: “[A-Z]+”

allowed-values:

- SP

- LB

- CS

default:

- LB

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

Parameter

February 5, 2024

Beitrag von:

February 5, 2024

Beitrag von:

In diesem Artikel

name
Bezeichnung
Beschreibung
typ
Schlüssel
erforderlich
zulässige Werte
Standard
Muster
min-value
max-value
min-length
max-length
min-items
max-items
GUI
Spalten
updatable
collapse_pane