Spec-Zone.ru › Ansible 2.10

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
булево
    Варианты:
  • no
  • yes
Указывает, включено ли автоматическое восстановление на 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
строка
    Варианты:
  • present ←
  • absent
Указывает, должен ли данный объект существовать в 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API