Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • 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
  • Значения переменных среды будут использованы только в том случае, если значения в книге задач не заданы.

Примеры

# 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

Spec-Zone.ru

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