Spec-Zone.ru › Ansible 2.8

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
Определение именованных портов, на которые службы бэкенда могут передавать данные. Формат — список словарей вида имя:порт.
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
список
При создании виртуальных машин.
Имена созданных виртуальных машин.

Пример:
['ansible-mig-new-0k4y', 'ansible-mig-new-0zk5', 'ansible-mig-new-kp68']
deleted_autoscaler
boolean
При попытке удаления модуля автоматического масштабирования.
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
boolean
именованные порты установлены
True, если именованные порты установлены

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

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

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

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

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

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


Статус

  • Этот модуль не гарантирует обратную совместимость интерфейса. [предварительный просмотр]
  • Этот модуль поддерживается сообществом 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.8/modules/gce_mig_module.html

Spec-Zone.ru

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