Kubernetes Bootstrapper: An extendable framework to set up production grade clusters

Bootstrapping a Kubernetes cluster using Terraform and Argo CD, powered by DigitalOcean.

The goal of this framework is to aid the kubernetes adoption journey of startups and SMBs.

Who is this for?

Kubernetes adopters
SMBs who are looking to speed up the k8s adoption
Builders and curious souls

Prerequisites

Set up the infrastructure on DigitalOcean

The terraform module will create a DigitalOcean Kubernetes cluster(DOKS) and a DigitalOcean Container Registry(DOCR.)

git clone https://github.com/hivenetes/k8s-bootstrapper.git
cd infrastructure
# Initialise terraform modules
terraform init
# Modify the `variables.tfvars.example` as per your requirements
# To view the infra plan
terraform plan -var-file="variables.tfvars.example"
# To apply the infra plan
terraform apply -var-file="variables.tfvars.example" --auto-approve
# It takes around 4 minutes to spin up a cluster depending on the size of the nodes etc
# Once terraform has execute the plan it will output the "cluster_id"
# To update cluster credentials to kubeconfig and setup current context run,
# Example: doctl kubernetes cluster kubeconfig save e74d2c45-c513-4c45-9ca3-f592ece1be76
doctl kubernetes cluster kubeconfig save <cluster-id>

Authenticate with DigitalOcean Container Registry

Follow this one-click guide to integrate the registry with the Kubernetes cluster.

NOTE: Intended for experimentation/evaluation ONLY. You will be responsible for all infrastructure costs incurred by the used resources.

Alternatively: Set up infrastructure on DigitalOcean using doctl

Install Argo CD: Declarative Continuous Delivery for Kubernetes

We have leveraged Argo CD: App of Apps pattern to bootstrap the Kubernetes cluster.

# Once the cluster is up and running
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# Get the argo password
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d

# Expose the argocd-server and login with the credentials on localhost:8080
kubectl -n argocd port-forward svc/argocd-server 8080:80

# Open the browser and go to localhost:8080 to access Argo CD UI
# Login with username: `admin`, password: `paste the value from the previous step`

Let the bootstrap begin

# Install industry standard open source tools to build a production grade k8s stack
kubectl apply -f https://raw.githubusercontent.com/hivenetes/k8s-bootstrapper/main/bootstrap/bootstrap.yaml

Overview of the bootstrapped cluster

Shoutout

This project takes inspiration from the amazing work done by Alex Jones of Cloud Native Skunkworks.

morawskiOZ/k8s-bootstrapper