Als Cloud-Vorlagendesigner verwenden Sie Eingabeparameter, damit Benutzer zur Anforderungszeit benutzerdefinierte Auswahlen vornehmen können.

Funktionsweise von Eingaben

Wenn Benutzer Eingaben bereitstellen, müssen nicht mehr mehrere Vorlagenkopien gespeichert werden, die sich nur geringfügig unterscheiden. Darüber hinaus können Eingaben eine Vorlage auf Tag-2-Vorgänge vorbereiten. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Verwenden von Cloud-Vorlageneingaben für Tag-2-Updates in vRealize Automation.

Die folgenden Eingaben zeigen, wie Sie eine Cloud-Vorlage für einen MySQL-Datenbankserver erstellen, wobei Benutzer diese eine Cloud-Vorlage in verschiedenen Cloud-Ressourcenumgebungen bereitstellen und jedes Mal andere Funktionen und Anmeldedaten anwenden können.

Eingabevariablen

Hinzufügen von Eingabeparametern

Fügen Sie dem Vorlagencode einen inputs-Abschnitt hinzu, in dem Sie die auswählbaren Werte festlegen.

Im folgenden Beispiel können Maschinengröße, Betriebssystem und Anzahl der geclusterten Server ausgewählt werden.

inputs:
  wp-size:
    type: string
    enum:
      - small
      - medium
    description: Size of Nodes
    title: Node Size
  wp-image:
    type: string
    enum:
      - coreos
      - ubuntu
    title: Select Image/OS
  wp-count:
    type: integer
    default: 2
    maximum: 5
    minimum: 2
    title: Wordpress Cluster Size
    description: Wordpress Cluster Size (Number of nodes)

Wenn Sie mit der Bearbeitung von Code nicht vertraut sind, können Sie auf die Registerkarte Eingaben des Code-Editors klicken und dort entsprechende Einstellungen vornehmen. Das folgende Beispiel zeigt bestimmte Eingaben für die bereits erwähnte MySQL-Datenbank.

Registerkarte „Eingaben“

Verweisen auf Eingabeparameter

Als Nächstes verweisen Sie im Abschnitt resources unter Verwendung der Syntax ${input.property-name} auf einen Eingabeparameter.

Wenn ein Eigenschaftsname ein Leerzeichen enthält, trennen Sie ihn mit eckigen Klammern und doppelten Anführungszeichen ab, anstatt die Punktnotation zu verwenden: ${input["property name"]}

Wichtig: Im Cloud-Vorlagencode können Sie das Wort input nur verwenden, um einen Eingabeparameter anzugeben.
resources:
  WebTier:
    type: Cloud.Machine
    properties:
      name: wordpress
      flavor: '${input.wp-size}'
      image: '${input.wp-image}'
      count: '${input.wp-count}'

Optionale Eingaben

Eingaben sind in der Regel erforderlich und mit einem Sternchen gekennzeichnet. Richten Sie für eine optionale Eingabe einen leeren Standardwert wie dargestellt ein.

owner:
  type: string
  minLength: 0
  maxLength: 30
  title: Owner Name
  description: Account Owner
  default: ''
Optionale Eingabe

Liste der Eingabeeigenschaften

Eigenschaft Beschreibung
const Wird mit oneOf verwendet. Der dem angezeigten Titel zugeordnete tatsächliche Wert.
default Vorab befüllter Wert für die Eingabe.

Der Standardwert muss den korrekten Typ aufweisen. Geben Sie kein Wort als Standardwert für eine Ganzzahl ein.

description Benutzerhilfetext für die Eingabe.
encrypted

Gibt an, ob die vom Benutzer eingegebene Eingabe verschlüsselt werden soll, True oder False.

Kennwörter werden in der Regel verschlüsselt.

Sie können auch verschlüsselte Eigenschaften erstellen, die über mehrere Cloud-Vorlagen hinweg wiederverwendbar sind. Weitere Informationen hierzu finden Sie unter Geheime Cloud Assembly-Eigenschaften.

enum Ein Dropdown-Menü mit den zulässigen Werten.

Verwenden Sie das folgende Beispiel als Formatierungshilfe.

enum:
      - value 1
      - value 2
format Legt das erwartete Format für die Eingabe fest. Beispiel: (25/04/19) unterstützt Datum/Uhrzeit (data-time).

Ermöglicht die Verwendung der Datumsauswahl in benutzerdefinierten Service Broker-Formularen.

items Deklariert Elemente innerhalb eines Arrays. Unterstützt „Zahl“, „Ganzzahl“, „Zeichenfolge“, „Boolesch“ oder „Objekt“.
maxItems Maximale Anzahl der auswählbaren Elemente innerhalb eines Arrays.
maxLength Größte zulässige Anzahl an Zeichen für eine Zeichenfolge.

Wenn Sie ein Feld beispielsweise auf 25 Zeichen begrenzen möchten, geben Sie maxLength: 25 ein.

maximum Größter zulässiger Wert für eine Zahl oder Ganzzahl.
minItems Mindestanzahl der auswählbaren Elemente innerhalb eines Arrays.
minLength Kleinste zulässige Anzahl an Zeichen für eine Zeichenfolge.
minimum Kleinster zulässiger Wert für eine Zahl oder Ganzzahl.
oneOf Ermöglicht, dass das Benutzereingabeformular einen Anzeigenamen (title) für einen weniger benutzerfreundlichen Wert (const) anzeigt. Wenn Sie einen Standardwert festlegen, legen Sie „const“ fest, nicht „title“.

Gültig für die Verwendung mit den Typen „Zeichenfolge“, „Ganzzahl“ und „Zahl“.

pattern Zulässige Zeichen für Zeichenfolgeneingaben in der Syntax für reguläre Ausdrücke.

Beispiel: '[a-z]+' oder '[a-z0-9A-Z@#$]+'

Eigenschaften Deklariert den key:value-Eigenschaftenblock für Objekte.
readOnly Dient nur zur Bereitstellung einer Formularbezeichnung.
title Wird mit oneOf verwendet. Der Anzeigename für einen const-Wert. Der Titel wird zum Zeitpunkt der Bereitstellung im Benutzereingabeformular angezeigt.
type Datentyp „Zahl“, „Ganzzahl“, „Zeichenfolge“, „Boolesch“ oder „Objekt“.
Wichtig:

Ein boolescher Typ fügt dem Anforderungsformular ein leeres Kontrollkästchen hinzu. Wenn Sie das Kästchen leer lassen, wird die Eingabe nicht auf „False“ gesetzt.

Zum Festlegen der Eingabe auf „False“ müssen Benutzer das Kontrollkästchen aktivieren und deaktivieren.

writeOnly Blendet im Formular die Tastenanschläge hinter Sternchen aus. Kann nicht mit „enum“ verwendet werden. Wird in benutzerdefinierten Service Broker-Formularen als Kennwertfeld angezeigt.

Weitere Beispiele

Zeichenfolge mit Enumeration

  image:
    type: string
    title: Operating System
    description: The operating system version to use.
    enum:
      - ubuntu 16.04
      - ubuntu 18.04
    default: ubuntu 16.04

  shell:
    type: string
    title: Default shell
    Description: The default shell that will be configured for the created user.
    enum:
      - /bin/bash
      - /bin/sh

Ganzzahl mit Mindest- und Höchstwert

  count:
    type: integer
    title: Machine Count
    description: The number of machines that you want to deploy.
    maximum: 5
    minimum: 1
    default: 1

Array von Objekten

  tags:
    type: array
    title: Tags
    description: Tags that you want applied to the machines.
    items:
      type: object
      properties:
        key:
          type: string
          title: Key
        value:
          type: string
          title: Value

Zeichenfolge mit Anzeigenamen

  platform:
    type: string
    oneOf:
      - title: AWS
        const: platform:aws
      - title: Azure
        const: platform:azure
      - title: vSphere
        const: platform:vsphere
    default: platform:aws

Zeichenfolge mit Mustervalidierung

  username:
    type: string
    title: Username
    description: The name for the user that will be created when the machine is provisioned.
    pattern: ^[a-zA-Z]+$

Zeichenfolge als Kennwort

  password:
    type: string
    title: Password
    description: The initial password that will be required to logon to the machine. Configured to reset on first login.
    encrypted: true
    writeOnly: true

Zeichenfolge als Textbereich

  ssh_public_key:
    type: string
    title: SSH public key
    maxLength: 256

Boolesch

  public_ip:
    type: boolean
    title: Assign public IP address
    description: Choose whether your machine should be internet facing.
    default: false

Kalenderauswahl für Datum und Uhrzeit

  leaseDate:
    type: string
    title: Lease Date
    format: date-time