Spec-Zone.ru › Ansible 2.5

gce_net — создание/удаление сетей GCE и правил брандмауэра

Новая версия с 1.5.

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

Обзор

  • Этот модуль может создавать и удалять сети Google Compute Engine и правила брандмауэра https://cloud.google.com/compute/docs/networking. Параметр name зарезервирован для ссылки на сеть, а параметр fwname используется для ссылки на правила брандмауэра. Диапазоны адресов IPv4 должны быть указаны в формате CIDR http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing. Полные инструкции по установке и настройке модулей gce* можно найти в комментариях к файлу ansible/test/gce_tests.py.

Требования

Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.

  • python >= 2.6
  • apache-libcloud >= 0.13.3, >= 0.17.0 при использовании JSON-аутентификации

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allowed Значение по умолчанию:
None
протокол:порты для разрешения ('tcp:80' или 'tcp:80,443' или 'tcp:80-800;udp:1-25') этот параметр обязателен при создании или обновлении правила брандмауэра
credentials_file
(добавлено в 2.1.0)
Значение по умолчанию:
None
путь к JSON-файлу, связанному с электронной почтой учетной записи службы
fwname Значение по умолчанию:
None
имя правила брандмауэра

псевдонимы: fwrule
ipv4_range
диапазон адресов IPv4 в нотации CIDR для сети. Этот параметр необязателен, если вы указали существующую сеть в параметре name, но при создании новой сети этот параметр обязателен.

псевдонимы: cidr
mode
(добавлено в 2.2)
    Варианты:
  • legacy ←
  • auto
  • custom
режим сети для Google Cloud "legacy" указывает на сеть с диапазоном IP-адресов "auto" автоматически генерирует подсети в различных регионах "custom" использует сети для группировки подсетей с указанными пользователем диапазонами IP-адресов https://cloud.google.com/compute/docs/networking#network_types
name Значение по умолчанию:
None
имя сети
pem_file
(добавлено в 1.6)
Значение по умолчанию:
None
путь к файлу pem, связанному с электронной почтой учетной записи службы. Этот параметр устарел. Используйте параметр 'credentials_file'.
project_id
(добавлено в 1.6)
Значение по умолчанию:
None
ваш идентификатор проекта GCE
service_account_email
(добавлено в 1.6)
Значение по умолчанию:
None
электронный адрес учетной записи службы
src_range Значение по умолчанию:
[]
исходный диапазон адресов IPv4 в нотации CIDR

псевдонимы: src_cidr
src_tags Значение по умолчанию:
[]
теги источника экземпляра для создания правила брандмауэра
state
    Варианты:
  • активный
  • настоящий ←
  • отсутствующий
  • удаленный
желаемое состояние сети или правила брандмауэра
subnet_desc
(добавлено в 2.2)
Значение по умолчанию:
None
описание подсети для создания
subnet_name
(добавлено в 2.2)
Значение по умолчанию:
None
имя подсети для создания
subnet_region
(добавлено в 2.2)
Значение по умолчанию:
None
регион подсети для создания
target_tags
(добавлено в 1.9)
Значение по умолчанию:
[]
теги целевого экземпляра для создания правила брандмауэра

Примеры

# Create a 'legacy' Network
- name: Create Legacy Network
  gce_net:
    name: legacynet
    ipv4_range: '10.24.17.0/24'
    mode: legacy
    state: present

# Create an 'auto' Network
- name: Create Auto Network
  gce_net:
    name: autonet
    mode: auto
    state: present

# Create a 'custom' Network
- name: Create Custom Network
  gce_net:
    name: customnet
    mode: custom
    subnet_name: "customsubnet"
    subnet_region: us-east1
    ipv4_range: '10.240.16.0/24'
    state: "present"

# Create Firewall Rule with Source Tags
- name: Create Firewall Rule w/Source Tags
  gce_net:
    name: default
    fwname: "my-firewall-rule"
    allowed: tcp:80
    state: "present"
    src_tags: "foo,bar"

# Create Firewall Rule with Source Range
- name: Create Firewall Rule w/Source Range
  gce_net:
    name: default
    fwname: "my-firewall-rule"
    allowed: tcp:80
    state: "present"
    src_range: ['10.1.1.1/32']

# Create Custom Subnetwork
- name: Create Custom Subnetwork
  gce_net:
    name: privatenet
    mode: custom
    subnet_name: subnet_example
    subnet_region: us-central1
    ipv4_range: '10.0.0.0/16'

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

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

Ключ Возвращаемое значение Описание
allowed
строка
При указании
Правила (порты и протоколы), указанные в этом правиле брандмауэра.

Пример:
tcp:80;icmp
fwname
строка
При указании
Имя правила брандмауэра.

Пример:
my-fwname
ipv4_range
строка
при указании или при создании подсети
Диапазон IPv4 указанной сети или подсети.

Пример:
10.0.0.0/16
name
строка
всегда
Имя сети.

Пример:
my-network
src_range
список
при указании
Блоки IP-адресов, к которым применяется правило брандмауэра.

Пример:
['10.1.1.12/8']
src_tags
список
при указании при создании правила брандмауэра
Теги экземпляра источника, к которым применяется правило брандмауэра.

Пример:
['foo', 'bar']
state
строка
всегда
Состояние обрабатываемого элемента.

Пример:
настоящий
subnet_name
строка
при указании или при создании подсети
Имя подсети.

Пример:
my-subnetwork
subnet_region
строка
при указании или при создании подсети
Регион указанной подсети.

Пример:
us-east1
target_tags
список
при указании при создании правила брандмауэра
Теги экземпляра получателя, которые получают трафик, разрешенный правилом брандмауэра.

Пример:
['foo', 'bar']


Статус

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

Автор

  • Эрик Джонсон (@erjohnso) <erjohnso@google.com>, Том Мелендес (@supertom) <supertom@google.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_net_module.html

Spec-Zone.ru

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