Spec-Zone.ru › Ansible 2.8

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

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

Описание

  • Этот модуль может создавать и удалять сети 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
-
протокол:порты для разрешения (tcp:80 или tcp:80,443 или tcp:80-800;udp:1-25). Этот параметр является обязательным при создании или обновлении правила брандмауэра
credentials_file
-
добавлено в 2.1.0
путь к JSON-файлу, связанному с адресом электронной почты учетной записи службы
fwname
-
имя правила брандмауэра

псевдонимы: 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
-
имя сети
pem_file
-
путь к PEM-файлу, связанному с адресом электронной почты учетной записи службы. Этот параметр устарел. Используйте credentials_file.
project_id
-
ваш идентификатор проекта GCE
service_account_email
-
адрес электронной почты учетной записи службы
src_range
-
По умолчанию:
[]
исходный диапазон адресов IPv4 в формате CIDR

псевдонимы: src_cidr
src_tags
-
По умолчанию:
[]
метки экземпляров источника для создания правила брандмауэра
state
-
    Варианты:
  • active
  • present ←
  • absent
  • deleted
желаемое состояние сети или правила брандмауэра
subnet_desc
-
добавлено в 2.2
описание подсети для создания
subnet_name
-
добавлено в 2.2
имя подсети для создания
subnet_region
-
добавлено в 2.2
регион для создания подсети
target_tags
-
По умолчанию:
[]
метки экземпляров назначения для создания правила брандмауэра

Примеры

# 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
строка
всегда
Состояние обрабатываемого элемента.

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

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

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

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


Статус

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

Авторы

  • Эрик Джонсон (@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.8/modules/gce_net_module.html

Spec-Zone.ru

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