Spec-Zone.ru › Ansible 2.9

gce_mig – Создание, обновление или удаление группы управляемых виртуальных машин (MIG)

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Обзор

  • Создание, обновление или удаление группы управляемых виртуальных машин (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
-
Определение именных портов, которым бэкенд-сервисы могут передавать данные. Формат — список словарей name:port.
project_id
-
Идентификатор проекта GCE
service_account_email
-
Адрес электронной почты учетной записи службы
size
-
Размер группы управляемых виртуальных машин. Если MIG уже существует, его размер будет изменён на указанное здесь значение. Требуется для создания MIG.
state
-
    Варианты:
  • absent
  • present ←
Желаемое состояние ресурса
template
-
Шаблон виртуальной машины, который будет использоваться при создании ВМ. Дополнительную информацию о шаблонах виртуальных машин см. в https://cloud.google.com/compute/docs/instance-templates. Требуется для создания MIG.
zone
- / обязательно
Зона GCE для использования в этой группе управляемых виртуальных машин.

Примечания

Примечание

  • Поддерживается изменение размера и пересоздание ВМ.
  • Для создания группы управляемых виртуальных машин требуется существующий шаблон виртуальной машины.

Примеры

# Following playbook creates, rebuilds instances, resizes and then deletes a MIG.
# Notes:
# - Two valid Instance Templates must exist in your GCE project in order to run
#   this playbook.  Change the fields to match the templates used in your
#   project.
# - The use of the 'pause' module is not required, it is just for convenience.
- name: Managed Instance Group Example
  hosts: localhost
  gather_facts: False
  tasks:
    - name: Create MIG
      gce_mig:
        name: ansible-mig-example
        zone: us-central1-c
        state: present
        size: 1
        template: my-instance-template-1
        named_ports:
        - name: http
          port: 80
        - name: foobar
          port: 82

    - name: Pause for 30 seconds
      pause:
        seconds: 30

    - name: Recreate MIG Instances with Instance Template change.
      gce_mig:
        name: ansible-mig-example
        zone: us-central1-c
        state: present
        template: my-instance-template-2-small
        recreate_instances: yes

    - name: Pause for 30 seconds
      pause:
        seconds: 30

    - name: Resize MIG
      gce_mig:
        name: ansible-mig-example
        zone: us-central1-c
        state: present
        size: 3

    - name: Update MIG with Autoscaler
      gce_mig:
        name: ansible-mig-example
        zone: us-central1-c
        state: present
        size: 3
        template: my-instance-template-2-small
        recreate_instances: yes
        autoscaling:
          enabled: yes
          name: my-autoscaler
          policy:
            min_instances: 2
            max_instances: 5
            cool_down_period: 37
            cpu_utilization:
              target: .39
            load_balancing_utilization:
              target: 0.4

    - name: Pause for 30 seconds
      pause:
        seconds: 30

    - name: Delete MIG
      gce_mig:
        name: ansible-mig-example
        zone: us-central1-c
        state: absent
        autoscaling:
          enabled: no
          name: my-autoscaler

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
created_autoscaler
boolean
При попытке создания аутомасштабирования.
True, если аутомасштабирование было создано. False в противном случае.

Пример:
True
created_instances
list
При создании виртуальных машин.
Имена созданных виртуальных машин.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
deleted_autoscaler
boolean
При попытке удаления аутомасштабирования.
True, если аутомасштабирование было удалено. False, если удаление не удалось.

Пример:
True
deleted_instances
list
При удалении виртуальных машин.
Имена удалённых виртуальных машин.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
name
string
изменённое значение
Имя группы управляемых виртуальных машин.

Пример:
my-managed-instance-group
named_ports
list
при первоначальной установке или обновлении named_ports
Список изменённых именных портов

Пример:
[{'name': 'http', 'port': 80}, {'name': 'foo', 'port': 82}]
recreated_instances
list
При пересоздании виртуальных машин.
Имена пересозданных виртуальных машин.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
resize_created_instances
list
При изменении размера, в результате которого создаются виртуальные машины.
Имена виртуальных машин, созданных при изменении размера.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
resize_deleted_instances
list
При изменении размера, в результате которого удаляются виртуальные машины.
Имена виртуальных машин, удалённых при изменении размера.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
set_named_ports
boolean
именные порты установлены
True, если именные порты установлены

Пример:
True
size
integer
изменённое значение
Количество ВМ в группе управляемых виртуальных машин.

Пример:
4
template
string
изменённое значение
Шаблон виртуальной машины, используемый для ВМ. Должен существовать до использования с MIG.

Пример:
my-instance-template
updated_autoscaler
boolean
При попытке обновления аутомасштабирования.
True, если аутомасштабирование было обновлено. False, если обновление не удалось.

Пример:
True
updated_named_ports
boolean
именные порты обновлены
True, если именные порты обновлены

Пример:
True
zone
string
всегда
Зона, в которой запускается MIG.

Пример:
us-central1-b


Статус

  • Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
  • Этот модуль поддерживается сообществом Ansible. [community]

Авторы

  • Том Мелендес (@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.9/modules/gce_mig_module.html

Spec-Zone.ru

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