Awesome Open Source
Awesome Open Source

Kubestack, The Open Source Gitops Framework


The Open Source Gitops Framework

Status GitHub Issues GitHub Pull Requests

GitHub Repo stars Twitter Follow

Join Our Contributors!


Kubestack is a Gitops framework for managed Kubernetes services based on Terraform and Kustomize.


  • Provides full testability of configuration changes
  • Clearly separates infrastructure and applications (ops & apps cluster pair)
  • Ensures K8s cluster config, surrounding infrastructure (e.g. DNS, IPs) and cluster services (e.g. Ingress) are maintained together
  • Unifies application environments across cloud providers
  • Increases deployment confidance through local deployments that accurately mirror cloud deployments
  • Enables a sustainable and fully automated GitOps workflow

Getting Started

For the easiest way to get started, visit the official Kubestack quickstart. This tutorial will help you get started with the Kubestack GitOps framework. It is divided into three steps.

  1. Develop Locally
    • Scaffold your repository and tweak your config in a local development environment that simulates your actual cloud configuration using Kubernetes in Docker (KinD).
  2. Provision Infrastructure
    • Set-up cloud prerequisites and bootstrap Kubestack's environment and clusters on your cloud provider for the first time.
  3. Set-up Automation
    • Integrate CI/CD to automate changes following Kubestack's GitOps workflow.

See the tests directory for an example of how to extend this towards multi-cluster and/or multi-cloud.

Repository Layout

This repository holds Terraform modules in directories matching the respective provider name, e.g. aws, azurerm, google. Additionally common holds the modules that are used for all providers. Most notably the metadata module that ensures a consistent naming scheme and the cluster_services module which integrates Kustomize into the Terraform apply.

Each cloud provider specific module directory always has a cluster, cluster-local, and _modules directories. The cluster module is user facing and once Kubestack is out of beta the goal is to not change the module interface unless the major version changes. The cluster module then internally uses the module in _modules that holds the actual implementation. The cluster-local module is similar to the cluster module, but configured for local deployments.

The quickstart directory is home to the source for the zip files that are used to bootstrap the user repositories when following the quickstart documentation.

The tests directory holds a set of happy path tests that also act as a example of how to do multiple cluster pairs across multiple clouds from one repository.

Getting Help

Official Documentation
Refer to the official documentation for a deeper dive into how to use and configure Kubestack.

Community Help
If you have any questions while following the tutorial, join the #kubestack channel on the Kubernetes community. To create an account request an invitation.

Professional Services
For organizations interested in accelerating their GitOps journey, professional services are available.


Contributions to the Kubestack framework are welcome and encouraged. Before contributing, please read the Contributing and Code of Conduct Guidelines.

One super simple way to contribute to the success of this project is to give it a star.

GitHub Repo stars

Kubestack Repositories

  • kbst/terraform-kubestack (this repository)
    • Terraform GitOps Framework - Everything you need to build reliable automation for AKS, EKS and GKE Kubernetes clusters in one free and open-source framework.
  • kbst/kbst
    • Kubestack Framework CLI - All-in-one CLI to scaffold your Infrastructure as Code repository and deploy your entire platform stack locally for faster iteration.
  • kbst/terraform-provider-kustomization
    • Kustomize Terraform Provider - A Kubestack maintained Terraform provider for Kustomize, available in the Terraform registry.
  • kbst/catalog
    • Catalog of cluster services as Kustomize bases - Continuously tested and updated Kubernetes services, installed and customizable using native Terraform syntax.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Aws (38,646
Kubernetes (25,177
Azure (17,868
Provider (15,510
Hcl (12,412
Terraform (12,022
Gcp (5,455
Terraform Module (2,112
Kustomize (181
Gitops Framework (7
Terraform Framework (3