ANSIBLE.GCE_NET(3)

NAME
gce_net - create/destroy GCE networks and firewall rules

DESCRIPTION

This module can create and destroy Google Compue Engine networks and firewall rules https://developers.google.com/compute/docs/networking. The name parameter is reserved for referencing a network while the fwname parameter is used to reference firewall rules. IPv4 Address ranges must be specified using the CIDR http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing format. Full install/configuration instructions for the gce* modules can be found in the comments of ansible/test/gce_tests.py.

OPTIONS

allowed
    the protocol:ports to allow ('tcp:80' or 'tcp:80,443' or 'tcp:80-800')

fwname
    name of the firewall rule

ipv4_range
    the IPv4 address range in CIDR notation for the network

name
    name of the network

src_range
    the source IPv4 address range in CIDR notation

src_tags
    the source instance tags for creating a firewall rule

state
    desired state of the persistent disk Choices: active,present,absent,deleted. (default: present).

EXAMPLES
# Simple example of creating a new network
- local_action:
    module: gce_net
    name: privatenet
    ipv4_range: '10.240.16.0/24'

# Simple example of creating a new firewall rule
- local_action:
    module: gce_net
    name: privatenet
    allowed: tcp:80,8080
    src_tags: ["web", "proxy"]

AUTHOR
Eric Johnson <erjohnso@google.com>

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#gce-net