community.general.hwc_ecs_instance – Создаёт ресурс Ecs/Instance в Huawei Cloud
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.hwc_ecs_instance.
Впервые в версии 0.2.0: коллекции community.general
Обзор
- управление экземплярами.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- keystoneauth1 >= 3.6.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| admin_pass строка | Указывает начальный пароль для входа администратора для входа в ECS с использованием парольной аутентификации. Для Linux администратор — root, а для Windows — Administrator. Требования к сложности пароля: от 8 до 26 символов. Пароль должен содержать как минимум три из следующих типов символов: заглавные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?). Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя. | ||
| availability_zone строка / обязательно | Указывает имя зоны доступности, в которой находится ECS. | ||
| data_volumes список / элементы=словарь | Указывает данные диски экземпляра ECS. | ||
| device строка | Указывает имя устройства диска. | ||
| volume_id строка / обязательно | Указывает идентификатор диска. | ||
| description строка | Указывает описание ECS, по умолчанию — пустая строка. Может содержать не более 85 символов. Не может содержать специальные символы, такие как < и >. | ||
| domain строка / обязательно | Имя домена для ограничения области (Identity v3). (в настоящее время поддерживаются только имена доменов, а не идентификаторы доменов). | ||
| eip_id строка | Указывает идентификатор присвоенного ECS эластичного IP-адреса. Можно назначить только эластичные IP-адреса в состоянии DOWN. | ||
| enable_auto_recovery булево |
| Указывает, включено ли автоматическое восстановление на ECS. | |
| enterprise_project_id строка | Указывает идентификатор корпоративного проекта, к которому принадлежит ECS. | ||
| flavor_name строка / обязательно | Указывает имя системного flavor. | ||
| 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. - Значения переменных среды будут использоваться только в том случае, если значения в playbook не заданы.
Примеры
# 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 строка | успех | Указывает начальный пароль администратора для входа в ECS с использованием аутентификации по паролю. Linux-администратор — root, Windows-администратор — Administrator. Требования к сложности пароля: от 8 до 26 символов. Пароль должен содержать как минимум три из следующих типов символов: заглавные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?). Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя. | |
| availability_zone строка | успех | Указывает имя зоны доступности, где расположен ECS. | |
| config_drive строка | успех | Указывает драйвер конфигурации. | |
| created строка | успех | Указывает время создания ECS. | |
| data_volumes список / элементы=строка | успех | Указывает данные дисков экземпляра ECS. | |
| device строка | успех | Указывает имя устройства диска. | |
| volume_id строка | успех | Указывает идентификатор диска. | |
| description строка | успех | Указывает описание ECS, по умолчанию — пустая строка. Может содержать максимум 85 символов. Не может содержать специальные символы, такие как < и >. | |
| disk_config_type строка | успех | Указывает тип конфигурации диска. MANUAL — объем изображения не расширяется. AUTO — объем системного диска будет расширен, чтобы соответствовать размеру. | |
| eip_id строка | успех | Указывает идентификатор эластичного IP-адреса, назначенного ECS. Можно назначить только эластичные IP-адреса в состоянии DOWN. | |
| enable_auto_recovery булево | успех | Указывает, включена ли автоматическая репликация на ECS. | |
| enterprise_project_id строка | успех | Указывает идентификатор корпоративного проекта, к которому принадлежит ECS. | |
| flavor_name строка | успех | Указывает имя системного шаблона. | |
| host_name строка | успех | Указывает имя хоста ECS. | |
| image_id строка | успех | Указывает идентификатор системного образа. | |
| image_name строка | успех | Указывает имя образа ECS. | |
| name строка | успех | Указывает имя ECS. Требования к значению: «Содержит от 1 до 64 символов, включая буквы, цифры, символы подчеркивания _, тире (-), точки (.).» | |
| nics список / элементы=строка | успех | Указывает информацию о сетевых адаптерах ECS. Сеть сетевого адаптера должна принадлежать VPC, указанному параметром vpc_id. Максимальное количество сетевых адаптеров, которые могут быть подключены к ECS, равно 12. | |
| ip_address строка | успех | Указывает IP-адрес сетевого адаптера. Значение — IPv4-адрес. Значение должно быть неиспользуемым IP-адресом в сегменте сети подсети. | |
| port_id строка | успех | Указывает идентификатор порта, соответствующий IP-адресу. | |
| subnet_id строка | успех | Указывает идентификатор подсети. | |
| power_state целое число | успех | Указывает состояние питания ECS. | |
| root_volume словарь | успех | Указывает конфигурацию системных дисков ECS. | |
| device строка | успех | Указывает имя устройства диска. | |
| size целое число | успех | Указывает размер системного диска в ГБ. Диапазон значений — от 1 до 1024. Размер системного диска должен быть не меньше минимального размера системного диска, поддерживаемого образом (атрибут min_disk образа). Если этот параметр не указан или равен 0, размер системного диска по умолчанию — минимальное значение системного диска в образе (атрибут min_disk образа). | |
| snapshot_id строка | успех | Указывает идентификатор снимка или идентификатор исходного диска данных, содержащегося в полном образе ECS. | |
| volume_id строка | успех | Указывает идентификатор диска. | |
| 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_alias строка | успех | Указывает псевдоним ECS. | |
| server_metadata словарь | успех | Указывает метаданные создаваемого ECS. | |
| server_tags словарь | успех | Указывает теги ECS. При создании ECS один ECS может поддерживать до 10 тегов. | |
| ssh_key_name строка | успех | Указывает имя SSH-ключа, используемого для входа в ECS. | |
| status строка | успех | Указывает состояние ECS. Возможные значения: ACTIVE, REBOOT, HARD_REBOOT, REBUILD, MIGRATING, BUILD, SHUTOFF, RESIZE, VERIFY_RESIZE, ERROR и DELETED. | |
| user_data строка | успех | Указывает данные пользователя, которые необходимо ввести во время создания ECS. Можно вводить текст, текстовые файлы и файлы в формате gzip. Содержимое должно быть закодировано в base64. Максимальный размер содержимого (до кодирования) — 32 КБ. Для Linux-ECS этот параметр не применяется при использовании adminPass. | |
| vpc_id строка | успех | Указывает идентификатор VPC, к которому принадлежит ECS. | |
Авторы
- Huawei Inc. (@huaweicloud)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/hwc_ecs_instance_module.html