4.6 KiB

Raw Blame History

Containerized CoreDNS on Container Optimized OS

This module manages a cloud-config configuration that starts a containerized CoreDNS service on Container Optimized OS, using the official image.

The resulting cloud-config can be customized in a number of ways:

a custom CoreDNS configuration can be set using the coredns_config variable
additional files (eg for hosts or zone files) can be passed in via the files variable
a completely custom cloud-config can be passed in via the cloud_config variable, and additional template variables can be passed in via config_variables

The default instance configuration inserts iptables rules to allow traffic on the DNS TCP and UDP ports, and the 8080 port for the optional HTTP health check that can be enabled via the CoreDNS health plugin.

Logging and monitoring are enabled via the Google Cloud Logging agent configured for the instance via the google-logging-enabled metadata property, and the Node Problem Detector service is started by default on boot.

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.

For convenience during development or for simple use cases, the module can optionally manage a single instance via the test_instance variable. If the instance is not needed the instance*tf files can be safely removed. Refer to the top-level README for more details on the included instance.

Examples

Default CoreDNS configuration

This example will create a cloud-config that uses the module's defaults, creating a simple DNS forwarder.

module "cos-coredns" {
  source = "./fabric/modules/cloud-config-container/coredns"
}

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

Custom CoreDNS configuration

This example will create a cloud-config using a custom CoreDNS configuration, that leverages the CoreDNS hosts plugin to serve a single zone via an included hosts format file.

module "cos-coredns" {
  source         = "./fabric/modules/cloud-config-container/coredns"
  coredns_config = "./fabric/modules/cloud-config-container/coredns/Corefile-hosts"
  files = {
    "/etc/coredns/example.hosts" = {
      content     = "127.0.0.2 foo.example.org foo"
      owner       = null
      permissions = "0644"
    }
  }
}
# tftest modules=0 resources=0

Variables

name	description	type	default
cloud_config	Cloud config template path. If null default will be used.	`string`	`null`
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`
file_defaults	Default owner and permissions for files.	`object({…})`	`{…}`
files	Map of extra files to create on the instance, path as key. Owner and permissions will use defaults if null.	`map(object({…}))`	`{}`

Outputs

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

4.6 KiB Raw Blame History