kubeformation

Cluster Spec v1

Reference documentation for the structure of the config file which contains the specifications for a Kubernetes cluster. The specification remains same for all providers, but possible values for certain keys change depending on the provider (e.g. k8s versions available differs on GKE & AKS).

Complete documentation can be found at v1/ClusterSpec.

Examples

GKE

Single node cluster

version: v1
name: cluster-name
provider: gke
k8sVersion: "1.9"
nodePools:
- name: pool1
  type: n1-standard-1
  size: 1

Two pools with 2 nodes each

version: v1
name: cluster-name
provider: gke
k8sVersion: "1.9"
nodePools:
- name: db-pool
  type: n1-standard-1
  size: 2
  labels:
    app: db
- name: backend-pool
  type: n1-standard-2
  size: 2
  labels:
    app: backend

One pool with 2 nodes, 1 volume

version: v1
name: cluster-name
provider: gke
k8sVersion: "1.9"
nodePools:
- name: db-pool
  type: n1-standard-1
  size: 2
  labels:
    app: db
volumes:
- name: volume-1
  size: 10

AKS

Single node cluster

version: v1
name: cluster-name
provider: aks
k8sVersion: "1.8.1"
nodePools:
- name: pool1
  type: Standard_D2_v2
  size: 1