Spec-Zone.ru › Ansible 2.5

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 Значение по умолчанию:
None
Словарь настроек для автоматического масштабирования. Поля 'enabled (bool)', 'name (str)' и policy.max_instances (int) обязательны при использовании автоматического масштабирования. См. https://cloud.google.com/compute/docs/reference/beta/autoscalers для получения дополнительной информации об автоматическом масштабировании.
credentials_file Значение по умолчанию:
None
Путь к JSON-файлу, связанному с электронным адресом учетной записи службы.
name
обязательно
Имя группы управляемых виртуальных машин.
named_ports
(добавлено в 2.3)
Значение по умолчанию:
None
Определяет имена портов, на которые бэкенд-сервисы могут пересылать данные. Формат — список словарей "имя:порт".
project_id Значение по умолчанию:
None
Идентификатор проекта GCE.
service_account_email Значение по умолчанию:
None
Электронный адрес учетной записи службы.
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
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
named_ports установлены
True, если named_ports установлены

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

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

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

Пример:
True
updated_named_ports
bool
named_ports обновлены
True, если named_ports обновлены

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

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


Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратной совместимости.

Автор

  • Tom Melendez (@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.5/modules/gce_mig_module.html

Spec-Zone.ru

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