Kubernetes cluster on Digital Ocean

Terraform module which creates a basic Kubernetes cluster on DigitalOcean

Supports:

• Kubernetes v1.8.8
• Kubernetes v1.9.4

Features:

This module creates a simple Kubernetes cluster on DigitalOcean with the following features:

• Single Kubernetes master
• Configurable number of Kubernetes worker nodes
• Firewall configured to deny external access other than port 22 by default
• DigitalOcean private network
• DigitalOcean cloud controller which automatically creates a DigitalOcean load balancer creation when a new service is defined
• Packer build with base software

Usage:

To create a Kubernetes cluster create the base image with Packer as shown in the example cluster , then add the following module to your Terraform config replacing the values for the inputs as required.

module "k8s_cluster" {
  source = "nicholasjackson/k8s/digitalocean"

  namespace = "my_k8s_cluster"

  ssh_public_key  = "~/.ssh/server_rsa.pub"
  ssh_private_key = "~/.ssh/server_rsa"

  image_name = "k8s-1.9.4-00-ubuntu-16-04-x64"
  size       = "s-1vcpu-1gb"

  k8s_version = "v1.9.4"
  k8s_workers = 2

  digitalocean_api_token = "${var.digitalocean_api_token}"
}

variable "digitalocean_api_token" {
  description = "API token for digital ocean, required by the K8s cloud controller"
}

Inputs

The module defines the following inputs:

Outputs

The module defines the following outputs:

Example

For more detailed example on useage, including instructions on creating a base image with Packer, and how to access the cluster using kubectl please see the README in the examples folder.

example cluster

Digital Ocean Droplet Sizes

The table below lists the currently available droplets, data obtained from the DigitalOcean API 19/03/2018. NOTE: Kubernetes requires a minimum of 1024mb of ram to run.