Files
hunfabric/modules/cloud-config-container/__need_fixing/onprem
Hemanand eaa420534b Add agent engine BYOC support (#3885)
* feat(agent-engine): add support for container and custom image specs

- Add container_config to deployment_files.
- Add image_spec with build_args to source_config.
- Make agent_framework optional and document supported values.
- Implement dynamic specs for container and source deployments.
- Add examples and automated tests for new deployment types.

* chore: update Google provider version to 7.28.0 across modules

Mechanical update of versions.tf and versions.tofu files using tools/versions.py.

* feat(agent-engine): refactor for container deployments and API alignment

- Group deployment settings under 'deployment_config' (renamed from 'deployment_files').
- Support container-based deployments via 'container_config' and 'image_spec'.
- Refactor 'source_files_config' (renamed from 'source_config') to include mutually exclusive 'python_spec' and 'image_spec'.
- Support 'developer_connect_config' as a source code type.
- Group engine settings (framework, env, secrets) under 'agent_engine_config'.
- Add support for 'memory_bank_config' persistent memory.
- Overhaul reasoning engine resources with dynamic blocks to match provider schema.
- Update all documentation examples, add TOC, and refresh test inventories.

* Update dynamic python_spec block and related example yamls

* Ignore changes setting for developer_connect_source under lifecycle management

* fixing review comments for `try` and default path for `source_path`

---------

Co-authored-by: Hemanand <hemr@google.com>
Co-authored-by: Julio Castillo <jccb@google.com>
2026-04-21 17:46:20 +00:00
..
2026-04-18 10:07:14 +02:00
2026-04-18 10:07:14 +02:00
2022-12-10 15:40:15 +01:00
2022-12-10 15:40:15 +01:00
2022-12-10 15:40:15 +01:00
2022-12-10 15:40:15 +01:00

Containerized on-premises infrastructure

This module manages a cloud-config configuration that starts an emulated on-premises infrastructure running in Docker Compose on a single instance, and connects it via static or dynamic VPN to a Google Cloud VPN gateway.

The emulated on-premises infrastructure is composed of:

  • a Strongswan container managing the VPN tunnel to GCP
  • an optional Bird container managing the BGP session
  • a CoreDNS container servng local DNS and forwarding to GCP
  • an Nginx container serving a simple static web page
  • a generic Linux container used as a jump host inside the on-premises network

A complete scenario using this module is available in the networking blueprints.

The module renders the generated cloud config in the cloud_config output, to be used in instances or instance templates via the user-data metadata.

Examples

Static VPN

module "cloud-vpn" {
  source        = "./fabric/modules/net-vpn-static"
  project_id    = "my-project"
  region        = "europe-west1"
  network       = "my-vpc"
  name          = "to-on-prem"
  remote_ranges = ["192.168.192.0/24"]
  tunnels = {
    remote-0 = {
      peer_ip           = module.vm.external_ip
      traffic_selectors = { local = ["0.0.0.0/0"], remote = null }
    }
  }
}

module "on-prem" {
  source = "./fabric/modules/cloud-config-container/onprem"
  vpn_config = {
    type          = "static"
    peer_ip       = module.cloud-vpn.address
    shared_secret = module.cloud-vpn.random_secret
  }
}

module "vm" {
  source     = "./fabric/modules/compute-vm"
  project_id = "my-project"
  zone       = "europe-west8-b"
  name       = "cos-nginx-tls"
  network_interfaces = [{
    nat        = true
    network    = "default"
    subnetwork = "gce"
  }]
  metadata = {
    user-data              = module.on-prem.cloud_config
    google-logging-enabled = true
  }
  boot_disk = {
    initialize_params = {
      image = "projects/cos-cloud/global/images/family/cos-stable"
      type  = "pd-ssd"
      size  = 10
    }
  }
  tags = ["ssh"]
}
# tftest skip

Variables

name description type required default
vpn_config VPN configuration, type must be one of 'dynamic' or 'static'. object({…})
config_variables Additional variables used to render the cloud-config and CoreDNS templates. map(any) {}
coredns_config CoreDNS configuration path, if null default will be used. string null
local_ip_cidr_range IP CIDR range used for the Docker onprem network. string "192.168.192.0/24"
vpn_dynamic_config BGP configuration for dynamic VPN, ignored if VPN type is 'static'. object({…}) {…}
vpn_static_ranges Remote CIDR ranges for static VPN, ignored if VPN type is 'dynamic'. list(string) ["10.0.0.0/8"]

Outputs

name description sensitive
cloud_config Rendered cloud-config file to be passed as user-data instance metadata.