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) |
| режим сети для 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