community.general.hwc_ecs_instance – Создаёт ресурс Ecs/Instance в Huawei Cloud
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в книге задач укажите: community.general.hwc_ecs_instance
Новое в версии 0.2.0: of community.general
Обзор
- управление экземплярами.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- keystoneauth1 >= 3.6.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| admin_pass строка | Указывает начальный пароль администратора для входа в ECS с помощью аутентификации по паролю. Linux-администратор — root, Windows-администратор — Administrator. Требования к сложности пароля: от 8 до 26 символов. Пароль должен содержать как минимум три из следующих типов символов: заглавные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?). Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя. | ||
| availability_zone строка / обязательно | Указывает имя AZ, в котором находится ECS. | ||
| data_volumes список / элементы=словарь | Указывает жесткие диски данных экземпляра ECS. | ||
| device строка | Указывает имя устройства диска. | ||
| volume_id строка / обязательно | Указывает идентификатор диска. | ||
| description строка | Указывает описание ECS, по умолчанию — пустая строка. Может содержать не более 85 символов. Не может содержать специальные символы, такие как < и >. | ||
| domain строка / обязательно | Имя домена для указания области (Identity v3). (в настоящее время поддерживаются только имена доменов, а не идентификаторы доменов). | ||
| eip_id строка | Указывает идентификатор эластического IP-адреса, назначенного ECS. Можно назначить только эластические IP-адреса в состоянии DOWN. | ||
| enable_auto_recovery логическое значение |
| Указывает, включена ли автоматическая восстановление ECS. | |
| enterprise_project_id строка | Указывает идентификатор корпоративного проекта, к которому принадлежит ECS. | ||
| flavor_name строка / обязательно | Указывает имя системной конфигурации. | ||
| id строка | Идентификатор управляемого ресурса. | ||
| identity_endpoint строка / обязательно | URL аутентификации Identity. | ||
| image_id строка / обязательно | Указывает идентификатор системного образа. | ||
| name строка / обязательно | Указывает имя ECS. Требования к значениям: от 1 до 64 символов, включая буквы, цифры, символы подчеркивания _, дефисы (-), точки (.). | ||
| nics список / элементы=словарь / обязательно | Указывает информацию о сетевых адаптерах ECS. Указанная сеть сетевого адаптера должна принадлежать VPC, указанной в параметре vpc_id. Максимальное количество сетевых адаптеров, которые можно подключить к ECS, равно 12. | ||
| ip_address строка / обязательно | Указывает IP-адрес сетевого адаптера. Значение — IPv4-адрес. Его значение должно быть неиспользуемым IP-адресом в сегменте сети подсети. | ||
| subnet_id строка / обязательно | Указывает идентификатор подсети. | ||
| password строка / обязательно | Пароль для входа. | ||
| project строка / обязательно | Имя арендатора (Identity v2) или проекта (Identity v3). (в настоящее время поддерживаются только имена проектов, а не идентификаторы проектов). | ||
| region строка | Регион, к которому принадлежит проект. | ||
| root_volume словарь / обязательно | Указывает конфигурацию системных дисков ECS. | ||
| size целое число | Указывает размер системного диска в ГБ. Диапазон значений: от 1 до 1024. Размер системного диска должен быть не меньше минимального размера системного диска, поддерживаемого образом (атрибут min_disk образа). Если этот параметр не указан или установлен в 0, размер системного диска по умолчанию — минимальное значение системного диска в образе (атрибут min_disk образа). | ||
| snapshot_id строка | Указывает идентификатор снимка или идентификатор исходного диска данных, содержащегося в полном образе ECS. | ||
| volume_type строка / обязательно | Указывает тип системного диска ECS. SATA — распространенный тип диска с общим вводом/выводом. SAS — тип диска с высоким вводом/выводом. SSD — тип диска с ультравысоким вводом/выводом. co-p1 — тип диска с высоким вводом/выводом (оптимизированный для производительности). uh-l1 — тип диска с ультравысоким вводом/выводом (оптимизированный для задержки). ПРИМЕЧАНИЕ. Для ECS HANA, HL1 и HL2 используйте диски co-p1 и uh-l1. Для других ECS не используйте диски co-p1 или uh-l1. | ||
| security_groups список / элементы=строка | Указывает группы безопасности ECS. Если этот параметр опущен, по умолчанию к ECS привязывается группа безопасности по умолчанию. | ||
| server_metadata словарь | Указывает метаданные создаваемого ECS. | ||
| server_tags словарь | Указывает теги ECS. При создании ECS один ECS поддерживает до 10 тегов. | ||
| ssh_key_name строка | Указывает имя SSH-ключа, используемого для входа в ECS. | ||
| state строка |
| Указывает, должен ли данный объект существовать в Huawei Cloud. | |
| timeouts словарь | Таймауты для каждой операции. | ||
| create строка | По умолчанию: "30m" | Таймауты для операции создания. | |
| delete строка | По умолчанию: "30m" | Таймауты для операции удаления. | |
| update строка | По умолчанию: "30m" | Таймауты для операции обновления. | |
| user строка / обязательно | Имя пользователя для входа (в настоящее время поддерживаются только имена пользователей, а не идентификаторы пользователей). | ||
| user_data строка | Указывает данные пользователя, которые будут внедрены во время процесса создания ECS. Можно внедрять текст, текстовые файлы и gzip-файлы. Содержимое, подлежащее внедрению, должно быть закодировано в base64. Максимальный размер внедряемого содержимого (до кодирования) составляет 32 КБ. Для Linux ECS этот параметр не применяется, если используется adminPass. | ||
| vpc_id строка / обязательно | Указывает идентификатор VPC, к которому принадлежит ECS. | ||
Примечания
Примечание
- Для аутентификации можно установить identity_endpoint, используя переменную среды
ANSIBLE_HWC_IDENTITY_ENDPOINT - Для аутентификации можно установить user, используя переменную среды
ANSIBLE_HWC_USER - Для аутентификации можно установить password, используя переменную среды
ANSIBLE_HWC_PASSWORD - Для аутентификации можно установить domain, используя переменную среды
ANSIBLE_HWC_DOMAIN - Для аутентификации можно установить project, используя переменную среды
ANSIBLE_HWC_PROJECT - Для аутентификации можно установить region, используя переменную среды
ANSIBLE_HWC_REGION - Значения переменных среды будут использованы только в том случае, если значения в книге задач не заданы.
Примеры
# create an ecs instance
- name: Create a vpc
hwc_network_vpc:
cidr: "192.168.100.0/24"
name: "ansible_network_vpc_test"
register: vpc
- name: Create a subnet
hwc_vpc_subnet:
gateway_ip: "192.168.100.32"
name: "ansible_network_subnet_test"
dhcp_enable: true
vpc_id: "{{ vpc.id }}"
cidr: "192.168.100.0/26"
register: subnet
- name: Create a eip
hwc_vpc_eip:
dedicated_bandwidth:
charge_mode: "traffic"
name: "ansible_test_dedicated_bandwidth"
size: 1
type: "5_bgp"
register: eip
- name: Create a disk
hwc_evs_disk:
availability_zone: "cn-north-1a"
name: "ansible_evs_disk_test"
volume_type: "SATA"
size: 10
register: disk
- name: Create an instance
community.general.hwc_ecs_instance:
data_volumes:
- volume_id: "{{ disk.id }}"
enable_auto_recovery: false
eip_id: "{{ eip.id }}"
name: "ansible_ecs_instance_test"
availability_zone: "cn-north-1a"
nics:
- subnet_id: "{{ subnet.id }}"
ip_address: "192.168.100.33"
- subnet_id: "{{ subnet.id }}"
ip_address: "192.168.100.34"
server_tags:
my_server: "my_server"
image_id: "8da46d6d-6079-4e31-ad6d-a7167efff892"
flavor_name: "s3.small.1"
vpc_id: "{{ vpc.id }}"
root_volume:
volume_type: "SAS"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращено | Описание | |
|---|---|---|---|
| admin_pass string | success | Указывает начальный пароль для входа администратора для входа в ECS с помощью аутентификации по паролю. Linux-администратор — root, Windows-администратор — Administrator. Требования к сложности пароля: от 8 до 26 символов. Пароль должен содержать как минимум три из следующих типов символов: «заглавные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?)». Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя. | |
| availability_zone string | success | Указывает имя зоны доступности, где находится ECS. | |
| config_drive string | success | Указывает драйвер конфигурации. | |
| created string | success | Указывает время создания ECS. | |
| data_volumes list / elements=string | success | Указывает жесткие диски данных экземпляра ECS. | |
| device string | success | Указывает имя устройства диска. | |
| volume_id string | success | Указывает идентификатор диска. | |
| description string | success | Указывает описание ECS, которое по умолчанию является пустой строкой. Может содержать максимум 85 символов. Не может содержать специальные символы, такие как < и >. | |
| disk_config_type string | success | Указывает тип конфигурации диска. MANUAL — объем изображения не расширяется. AUTO — объем изображения системного диска будет расширен до размера, соответствующего выделенному объему. | |
| eip_id string | success | Указывает идентификатор эластичного IP-адреса, назначенного ECS. Назначаются только эластичные IP-адреса в состоянии DOWN. | |
| enable_auto_recovery boolean | success | Указывает, включена ли автоматическая восстановление ECS. | |
| enterprise_project_id string | success | Указывает идентификатор корпоративного проекта, к которому принадлежит ECS. | |
| flavor_name string | success | Указывает имя системного выделенного объема. | |
| host_name string | success | Указывает имя хоста ECS. | |
| image_id string | success | Указывает идентификатор системного образа. | |
| image_name string | success | Указывает имя образа ECS. | |
| name string | success | Указывает имя ECS. Требования к значению: «Состоит из 1–64 символов, включая буквы, цифры, нижние подчеркивания _, дефисы (-), точки (.)». | |
| nics list / elements=string | success | Указывает информацию о сетевых адаптерах ECS. Сеть сетевого адаптера должна принадлежать VPC, указанному в vpc_id. К ECS можно подключить максимум 12 сетевых адаптеров. | |
| ip_address string | success | Указывает IP-адрес сетевого адаптера. Значение — IPv4-адрес. Его значение должно быть незанятым IP-адресом в сегменте сети подсети. | |
| port_id string | success | Указывает идентификатор порта, соответствующий IP-адресу. | |
| subnet_id string | success | Указывает идентификатор подсети. | |
| power_state integer | success | Указывает состояние питания ECS. | |
| root_volume dictionary | success | Указывает конфигурацию системных дисков ECS. | |
| device string | success | Указывает имя устройства диска. | |
| size integer | success | Указывает размер системного диска в ГБ. Диапазон значений — от 1 до 1024. Размер системного диска должен быть больше или равен минимальному размеру системного диска, поддерживаемому образом (атрибут min_disk образа). Если этот параметр не указан или равен 0, размер системного диска по умолчанию — минимальное значение размера системного диска в образе (атрибут min_disk образа). | |
| snapshot_id string | success | Указывает идентификатор снимка или идентификатор исходного диска данных, содержащегося в полном образе ECS. | |
| volume_id string | success | Указывает идентификатор диска. | |
| volume_type string | success | Указывает тип системного диска ECS. SATA — стандартный тип диска ввода/вывода. SAS — тип диска с высоким вводом/выводом. SSD — тип диска с очень высоким вводом/выводом. co-p1 — тип диска с высоким вводом/выводом (оптимизирован под производительность). uh-l1 — тип диска с очень высоким вводом/выводом (оптимизирован под задержку). ПРИМЕЧАНИЕ. Для ECS HANA, HL1 и HL2 используйте диски co-p1 и uh-l1. Для других ECS не используйте диски co-p1 или uh-l1. | |
| security_groups list / elements=string | success | Указывает группы безопасности ECS. Если этот параметр не указан, по умолчанию к ECS привязывается группа безопасности по умолчанию. | |
| server_alias string | success | Указывает псевдоним ECS. | |
| server_metadata dictionary | success | Указывает метаданные создаваемого ECS. | |
| server_tags dictionary | success | Указывает теги ECS. При создании ECS один ECS поддерживает до 10 тегов. | |
| ssh_key_name string | success | Указывает имя SSH-ключа, используемого для входа в ECS. | |
| status string | success | Указывает состояние ECS. Доступные значения: ACTIVE, REBOOT, HARD_REBOOT, REBUILD, MIGRATING, BUILD, SHUTOFF, RESIZE, VERIFY_RESIZE, ERROR и DELETED. | |
| user_data string | success | Указывает данные пользователя, которые должны быть внедрены во время процесса создания ECS. Можно внедрить текст, текстовые файлы и файлы gzip. Содержимое, подлежащее внедрению, должно быть закодировано в base64. Максимальный размер подлежащего внедрению содержимого (до кодирования) — 32 КБ. Для Linux ECS этот параметр не действует при использовании adminPass. | |
| vpc_id string | success | Указывает идентификатор VPC, к которому принадлежит ECS. | |
Авторы
- Huawei Inc. (@huaweicloud)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/hwc_ecs_instance_module.html