Skip to content

Latest commit

 

History

History
74 lines (47 loc) · 1.74 KB

README.md

File metadata and controls

74 lines (47 loc) · 1.74 KB

k8s-kops

This is a templated version of k8s, kops-based cluster.

Purpose

The main purposes of this repository:

  • Provide a repository to manage multiple Kubernetes clusters with kops.
  • Keep Kubernetes clusters Configuration as Code.
  • Have an easy way to change Kubernetes cluster's parameters.
  • Have a templated version of Kubernetes cluster deployed on Amazon Web Services.
  • Provide a Kubernetes cluster with basic security policies applied.
  • Automate workflow with kops.

Usage

First of all, kops must be installed. [kops-installation] Then, you can use the templated version of the cluster. Have fun.

  • Export KOPS_STATE_STORE environment variable:
export KOPS_STATE_STORE="s3://exampleenv-kops-s3

You always have to set this environment variable.

Automated installation

  • It is possible to use Makefile target, for example:
make dist/clusters/cluster-exampleenv.yml

Notice that this target assumes equality of <cluster-name> between dist/clusters/<cluster-name>.yml and values/<cluster-name>.yml

Manual installation
  • Create a template from values:
kops toolbox template --fail-on-missing \
                      --format-yaml \
                      --template src/eu-west-1/templates \
                      --snippets src/eu-west-1/snippets \
                      --values values/cluster-exampleenv.yml \
                      > dist/clusters/cluster-exampleenv.yml
  • Generate a cluster from template:
kops create -f clusters/cluster-exampleenv.yml

Contribution

Make sure all tests passes from the following target:

make test

Its requirement is pre-commit.