alphagov / terraform-render-bootkube

Render kubernetes-incubator/bootkube assets with Terraform

terraform-render-bootkube

terraform-render-bootkube is a Terraform module that renders kubernetes-incubator/bootkube assets for bootstrapping a Kubernetes cluster.

Audience

terraform-render-bootkube is a low-level component of the Typhoon Kubernetes distribution. Use Typhoon modules to create and manage Kubernetes clusters across supported platforms. Use the bootkube module if you'd like to customize a Kubernetes control plane or build your own distribution.

Usage

Use the module to declare bootkube assets. Check variables.tf for options and terraform.tfvars.example for examples.

module "bootkube" {
  source = "git::https://github.com/poseidon/terraform-render-bootkube.git?ref=SHA"

  cluster_name = "example"
  api_servers = ["node1.example.com"]
  etcd_servers = ["node1.example.com"]
  asset_dir = "/home/core/clusters/mycluster"
}

Generate the assets.

terraform init
terraform get --update
terraform plan
terraform apply

Find bootkube assets rendered to the asset_dir path. That's it.

Comparison

Render bootkube assets directly with bootkube v0.12.0.

bootkube render --asset-dir=assets --api-servers=https://node1.example.com:6443 --api-server-alt-names=DNS=node1.example.com --etcd-servers=https://node1.example.com:2379

Compare assets. Rendered assets may differ slightly from bootkube assets to reflect decisions made by the Typhoon distribution.

pushd /home/core/mycluster
mv manifests-networking/* manifests
popd
diff -rw assets /home/core/mycluster