Разработчики облачных шаблонов могут использовать входные параметры, чтобы пользователи могли самостоятельно выбирать настройки при отправке запроса.
Принципы работы входных данных
Теперь, когда пользователи вводят свои входные данные, разработчикам больше не нужно сохранять огромное количество незначительно различающихся облачных шаблонов. Кроме того, входные данные могут подготавливать шаблон для операций по регулярному обслуживанию. См. раздел Использование входных данных облачного шаблона для обновлений при регулярном обслуживании vRealize Automation.
Следующие входные данные показывают, как можно создать один облачный шаблон для сервера базы данных MySQL, где пользователи смогут выполнять развертывание этого облачного шаблона в разных средах облачных ресурсов и каждый раз применять различный объем ресурсов и различные учетные данные.
Добавление входных параметров
Добавьте раздел inputs
в код шаблона, где задаются выбираемые значения.
В следующем примере в качестве выбираемых значений используется размер компьютера, операционная система и число кластерных серверов.
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)
Если вам неудобно редактировать код, можно перейти на вкладку Входные данные в редакторе кода и там настроить параметры. В следующем примере показаны некоторые входные данные для базы данных MySQL, упомянутой выше.
Ссылки на входные параметры
Затем в разделе resources
создайте ссылку на входной параметр, используя синтаксис ${input.свойство-имя}
.
Если имя свойства содержит пробелы, вместо использования нотации с точкой используйте квадратные скобки и двойные кавычки: ${input["имя свойства"]}
input
может использоваться в коде облачных шаблонов только для указания входных параметров.
resources: WebTier: type: Cloud.Machine properties: name: wordpress flavor: '${input.wp-size}' image: '${input.wp-image}' count: '${input.wp-count}'
Необязательные входные данные
Входные данные, как правило, являются обязательными и отмечены звездочкой. Чтобы сделать входные данные необязательными, задайте пустое значение по умолчанию, как показано ниже.
owner: type: string minLength: 0 maxLength: 30 title: Owner Name description: Account Owner default: ''
Список входных свойств
Свойство | Описание |
---|---|
const | Используется с oneOf. Реальное значение, связанное с понятным заголовком. |
default | Предварительно заполненное значение для входных данных. Значение по умолчанию должно иметь допустимый тип. Не вводите слово в качестве значения по умолчанию там, где нужно ввести целое число. |
description | Текст справки по входным данным для пользователя. |
encrypted | Указывает, следует ли шифровать вводимые пользователем данные (true или false). К данным, которые обычно шифруются, относятся пароли. Также можно создать зашифрованные свойства, которые можно повторно использовать в нескольких облачных шаблонах. См. раздел Секретные свойства Cloud Assembly. |
enum | Раскрывающийся список разрешенных значений. Используйте следующий пример в качестве инструкции по формату. enum: - value 1 - value 2 |
format | Задает ожидаемый формат входных данных. Например, формат (25/04/19) поддерживает ввод даты и времени. Позволяет использовать управляющий элемент выбора даты в настраиваемых формах Service Broker. |
items | Объявляет элементы в массиве. Поддерживаемые значения: число, целое число, строка, логическое значение или объект. |
maxItems | Максимальное количество выбираемых элементов в массиве. |
maxLength | Максимальное разрешенное количество символов в строке. Например, чтобы ограничить размер поля 25 символами, введите |
maximum | Наибольшее допустимое значение числа или целого числа. |
minItems | Минимальное количество выбираемых элементов в массиве. |
minLength | Минимальное разрешенное количество символов в строке. |
minimum | Наименьшее допустимое значение для числа или целого числа. |
oneOf | Позволяет отображать понятное имя (title) вместо менее понятного значения (const) в форме для ввода пользовательских данных. При задании значения по умолчанию следует указывать const, а не title. Допустимо для использования с данными следующих типов: строка, целое число и число. |
pattern | Допустимые символы для ввода строковых данных в виде регулярного выражения. Например, |
properties | Объявляет блок свойств key:value для объектов. |
readOnly | Используется только для пометки формы. |
title | Используется с oneOf. Понятное имя для значения const. Этот заголовок отображается в форме для ввода пользовательских данных во время развертывания. |
type | Тип данных: число, целое число, строка, логическое значение или объект.
Важно!:
Логическое значение добавляет пустой флажок в форму запроса. Если оставить поле нетронутым, для входных данных не будет задано значение «ложь». Чтобы задать для входных данных значение «ложь», необходимо проверить, а затем очистить поле. |
writeOnly | Заменяет введенные в форму символы звездочками. Нельзя использовать в сочетании с enum. Отображается в настраиваемых формах Service Broker как поле для ввода пароля. |
Дополнительные примеры
Строка с перечислением
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
Целое число с минимальным и максимальным значениями
count: type: integer title: Machine Count description: The number of machines that you want to deploy. maximum: 5 minimum: 1 default: 1
Массив объектов
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
Строка с понятными именами
platform: type: string oneOf: - title: AWS const: platform:aws - title: Azure const: platform:azure - title: vSphere const: platform:vsphere default: platform:aws
Строка с проверкой шаблона
username: type: string title: Username description: The name for the user that will be created when the machine is provisioned. pattern: ^[a-zA-Z]+$
Строка как пароль
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
Строка как текстовая область
ssh_public_key: type: string title: SSH public key maxLength: 256
Логическое значение
public_ip: type: boolean title: Assign public IP address description: Choose whether your machine should be internet facing. default: false
Селектор даты и времени в календаре
leaseDate: type: string title: Lease Date format: date-time