gce_mig - Создание, обновление или удаление группы управляемых виртуальных машин (MIG).
Новая в версии 2.2.
Обзор
- Создание, обновление или удаление группы управляемых виртуальных машин (MIG). См. https://cloud.google.com/compute/docs/instance-groups для обзора. Полные инструкции по установке и настройке модулей gce* можно найти в комментариях в файле ansible/test/gce_tests.py.
Требования
Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.
- python >= 2.6
- apache-libcloud >= 1.2.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| autoscaling | Словарь настроек для автоматического масштабирования. Поля 'enabled (bool)', 'name (str)' и policy.max_instances (int) являются обязательными, если используется автоматическое масштабирование. Смотрите https://cloud.google.com/compute/docs/reference/beta/autoscalers для получения дополнительной информации об автоматическом масштабировании. | |
| credentials_file | Путь к JSON-файлу, связанному с электронным адресом учетной записи службы. | |
| name обязательно | Имя группы управляемых виртуальных машин. | |
| named_ports (добавлено в 2.3) | Определение именованных портов, которым службы бэкенда могут передавать данные. Формат — список словарей name:port. | |
| project_id | Идентификатор проекта GCE | |
| service_account_email | Электронный адрес учетной записи службы | |
| size | Размер группы управляемых виртуальных машин. Если MIG уже существует, он будет изменен на указанное здесь значение. Требуется для создания MIG. | |
| state |
| Желаемое состояние ресурса. |
| template | Шаблон виртуальной машины, который будет использоваться при создании виртуальных машин. См. https://cloud.google.com/compute/docs/instance-templates, чтобы узнать больше о шаблонах виртуальных машин. Требуется для создания MIG. | |
| zone обязательно | Зона GCE для использования этой группы управляемых виртуальных машин. |
Примечания
Примечание
- Поддерживается изменение размера и создание новых виртуальных машин.
- Для создания группы управляемых виртуальных машин требуется существующий шаблон виртуальной машины.
Примеры
%%%CODE_BLOCK_0%%Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, а следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| created_autoscaler bool | При попытке создания автоматического масштабирования. | True, если попытка создания автоматического масштабирования была успешной. Иначе — False. Пример: True |
| created_instances список | При создании виртуальных машин. | Имена созданных виртуальных машин. Пример: ['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68'] |
| deleted_autoscaler bool | При попытке удаления автоматического масштабирования. | True, если удаление автоматического масштабирования выполнено успешно. False — если удаление не удалось. Пример: True |
| deleted_instances список | При удалении виртуальных машин. | Имена удалённых виртуальных машин. Пример: ['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68'] |
| name строка | изменилось | Имя группы управляемых виртуальных машин. Пример: my-managed-instance-group |
| named_ports список | при первоначальной установке или обновлении named_ports | список обработанных именованных портов Пример: [{'name': 'http', 'port': 80}, {'name': 'foo', 'port': 82}] |
| recreated_instances список | При повторном создании виртуальных машин. | Имена повторно созданных виртуальных машин. Пример: ['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68'] |
| resize_created_instances список | При изменении размера с созданием виртуальных машин. | Имена созданных виртуальных машин при изменении размера. Пример: ['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68'] |
| resize_deleted_instances список | При изменении размера с удалением виртуальных машин. | Имена удаленных виртуальных машин при изменении размера. Пример: ['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68'] |
| set_named_ports bool | именованные порты установлены | True, если именованные порты установлены Пример: True |
| size целое число | изменилось | Количество виртуальных машин в группе управляемых виртуальных машин. Пример: 4 |
| template строка | изменилось | Шаблон виртуальной машины для использования с виртуальными машинами. Должен существовать перед использованием с MIG. Пример: my-instance-template |
| updated_autoscaler bool | При попытке обновления автоматического масштабирования. | True, если обновление автоматического масштабирования выполнено успешно. False — если обновление не удалось. Пример: True |
| updated_named_ports bool | именованные порты обновлены | True, если именованные порты обновлены Пример: True |
| zone строка | всегда | Зона запуска MIG. Пример: us-central1-b |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. в этом разделе.
Автор
- Том Мелендес (@supertom) <tom@supertom.com>
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/gce_mig_module.html
