gcp_compute_network – Создаёт сеть GCP

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

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

Обзор

Представляет ресурс сети.
В вашем проекте в Консоли Google Cloud Platform может быть несколько сетей, и каждая сеть может иметь несколько подключенных к ней виртуальных машин. Сеть позволяет вам определить IP-адрес шлюза и диапазон сети для виртуальных машин, подключенных к этой сети. Каждый проект получает по умолчанию сеть с предопределёнными конфигурациями и правилами брандмауэра. Вы можете настроить сеть по умолчанию, добавив или удалив правила, или создать новые сети в этом проекте. Как правило, большинству пользователей нужна только одна сеть, хотя по умолчанию вы можете иметь до пяти сетей на проект.
Сеть принадлежит только одному проекту, и каждая виртуальная машина может принадлежать только одной сети. Все сети Compute Engine используют протокол IPv4. Compute Engine в настоящее время не поддерживает IPv6. Однако Google активно продвигает IPv6, и это важное направление развития в будущем.

Требования

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

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
auth_kind - / обязательно	Варианты: machineaccount serviceaccount application	Тип используемых учетных данных.
auto_create_subnetworks boolean	Варианты: no yes	При значении true сеть создаётся в режиме "автоматического создания подсетей". При значении false сеть создаётся в режиме "настраиваемой подсети". В режиме "автоматического создания подсетей" новая сеть получает CIDR по умолчанию 10.128.0.0/9 и автоматически создаёт по одной подсети на регион.
description -		Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.
gateway_ipv4 -		IP-адрес шлюза для маршрутизации по умолчанию в другие сети. Это значение является только для чтения и выбирается Google Compute Engine, обычно как первый доступный адрес в IPv4Range.
ipv4_range -		Диапазон внутренних адресов, разрешённых в этой сети. Этот диапазон — спецификация CIDR, например: 192.168.0.0/16. Указывается клиентом при создании сети.
name -		Имя ресурса. Указывается клиентом при создании ресурса. Длина имени должна быть от 1 до 63 символов и соответствовать RFC1035. Точнее, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — дефис, строчная буква или цифра, за исключением последнего символа, который не может быть дефисом.
project -	По умолчанию: null	Проект Google Cloud Platform для использования.
scopes -		Массив используемых областей.
service_account_email -		Необязательный адрес электронной почты учётной записи сервиса, если выбран machineaccount и пользователь не хочет использовать адрес по умолчанию.
service_account_file -		Путь к файлу JSON учётной записи сервиса, если в качестве типа выбран serviceaccount.
state -	Варианты: present ← absent	Требуется ли существование данного объекта в GCP

Примечания

Примечание

Для проверки подлинности можно установить service_account_file с помощью переменной среды GCP_SERVICE_ACCOUNT_FILE.
Для проверки подлинности можно установить service_account_email с помощью переменной среды GCP_SERVICE_ACCOUNT_EMAIL.
Для проверки подлинности можно установить auth_kind с помощью переменной среды GCP_AUTH_KIND.
Для проверки подлинности можно установить scopes с помощью переменной среды GCP_SCOPES.
Значения переменных среды будут использоваться только в том случае, если значения в playbook не установлены.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: create a network
  gcp_compute_network:
      name: "test_object"
      auto_create_subnetworks: true
      project: "test_project"
      auth_kind: "service_account"
      service_account_file: "/tmp/auth.pem"
      state: present

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

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

Ключ	Возвращаемое значение	Описание
auto_create_subnetworks boolean	success	При значении true сеть создаётся в режиме "автоматического создания подсетей". При значении false сеть создаётся в режиме "настраиваемой подсети". В режиме "автоматического создания подсетей" новая сеть получает CIDR по умолчанию 10.128.0.0/9 и автоматически создаёт по одной подсети на регион.
creation_timestamp string	success	Дата и время создания в формате RFC3339.
description string	success	Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.
gateway_ipv4 string	success	IP-адрес шлюза для маршрутизации по умолчанию в другие сети. Это значение является только для чтения и выбирается Google Compute Engine, обычно как первый доступный адрес в IPv4Range.
id integer	success	Уникальный идентификатор ресурса.
ipv4_range string	success	Диапазон внутренних адресов, разрешённых в этой сети. Этот диапазон — спецификация CIDR, например: 192.168.0.0/16. Указывается клиентом при создании сети.
name string	success	Имя ресурса. Указывается клиентом при создании ресурса. Длина имени должна быть от 1 до 63 символов и соответствовать RFC1035. Точнее, длина имени должна быть от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы — дефис, строчная буква или цифра, за исключением последнего символа, который не может быть дефисом.
subnetworks list	success	Определённые сервером полные URL-адреса всех подсетей в этой сети.

Статус

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

Авторы

Google Inc. (@googlecloudplatform)

Подсказка

Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/gcp_compute_network_module.html