Home

Awesome

<p align="center"> <img src="./assets/favicon.png" alt="Kubestack, The Open Source Gitops Framework" width="25%" height="25%" /> </p> <h1 align="center">Kubestack</h1> <h3 align="center">The Open Source Terraform framework for Kubernetes Platform Engineering</h3> <div align="center">

Status GitHub Issues GitHub Pull Requests

</div> <div align="center">

GitHub Repo stars Twitter Follow

</div> <h3 align="center"><a href="#Contributing">Join Our Contributors!</a></h3> <div align="center"> <a href="https://github.com/kbst/terraform-kubestack/graphs/contributors"> <img src="https://contrib.rocks/image?repo=kbst/terraform-kubestack&max=36" /> </a> </div>

Introduction

Kubestack is a Terraform framework for Kubernetes Platform Engineering teams to define the entire cloud native stack in one Terraform code base and continuously evolve the platform safely through GitOps.

Highlights

Getting Started

For the easiest way to get started, follow the Kubestack tutorial. The tutorial will help you get started with the Kubestack framework and build a Kubernetes platform application teams love.

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.

Contributing

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 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 quickstart directory is home to the source for the zip files that are used to bootstrap the user repositories when following the tutorial.

The tests directory holds a set of happy path tests.

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.

<div align="center">

GitHub Repo stars

</div>

Kubestack Repositories