---
constants:
  __name: "{{ name }}_{{ __guid }}"
variables:
  name:
    desc: "Name of the VPC network."
    required: true
    group: Network Details
  auto_create_subnetworks:
    desc: "If set to true, the network is created in auto mode with pre-created subnets."
    required: false
    group: Network Details
    default: false
  description:
    desc: "An optional description of the network."
    required: false
    group: Network Details
  routing_mode:
    desc: "The network routing mode. Options are 'GLOBAL' or 'REGIONAL'."
    required: false
    group: Advanced
    default: "REGIONAL"
    advanced: true
  mtu:
    desc: "The network MTU in bytes. The default value is 1460."
    required: false
    group: Advanced
    default: 1460
    advanced: true
groups:
  Network Details:
    order: 1
    desc: "Basic settings for the VPC network."
  Advanced:
    order: 2
    desc: "Advanced settings for the VPC network."
---

resource "google_compute_network" "__name" {
  name                    = {{ name }}
  auto_create_subnetworks = {{ auto_create_subnetworks }}
  description             = {{ description | required: false }}
  routing_mode            = {{ routing_mode | advanced: true }}
  mtu                     = {{ mtu | advanced: true }}
}

// The network is created in custom mode by default to allow manual subnet creation, promoting best practices in network design and security.
// Advanced options like routing mode and MTU are available for fine-tuning but are set to sensible defaults.
//