A framework for building repeatable, containerized, cloud-based infrastructure as code with Kubernetes.
Branch: master
Clone or download
Latest commit 0fceaa4 Feb 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci making a failure of the release script a non-blocker for the build. A… Oct 29, 2018
.github adding stale bot configuration Jan 8, 2019
bin making supporting changes Mar 30, 2018
docs adding project_name to the gcp created inventory to work around an er… Feb 19, 2019
example-component making the module install without -e Dec 29, 2017
pentagon adding project_name to the gcp created inventory to work around an er… Feb 19, 2019
tests fixing test for az calculation Oct 17, 2018
.gitignore adding pypi upload to circleci config, making setup.py email match py… Sep 20, 2018
CHANGELOG.md updating CHANGELOG.md Feb 11, 2019
CODE_OF_CONDUCT.md adding DESIGN moving code of conduct Jan 9, 2019
CONTRIBUTING.md formatting Feb 8, 2019
DESIGN.md fixing spelling mistakes Jan 9, 2019
Dockerfile Making ubuntu linux compatible Oct 13, 2017
LICENSE Update LICENSE May 26, 2017
MANIFEST.in making the module install without -e Dec 29, 2017
setup.py replacing ordered yaml libaray, tweaking a migration to fail more gr… Dec 31, 2018



What is Pentagon?

Pentagon is a cli tool to generate repeatable, cloud-based Kubernetes infrastructure. It can be used as a “batteries included” default which can:

  • provide a network with a cluster
  • Two HA KOPS based Kubernetes clusters
  • Segregated multiple development / non-production environments
  • VPN-based access control
  • A highly-available network, built across multiple Availability Zones

How does it work?

Pentagon produces a directory. The directory defines a basic set of configurations for Ansible, Terraform and kops). When those tools are run in a specific order the result is a VPC with a VPN and a Kubernetes Cluster in AWS. GKE Support is built in but not default. It is designed to be customizable while at the same time built with defaults that fit the needs of most web application companies.

Getting Started

The Getting Started has information about installing Pentagon and creating your first project.

Table Of Contents

AWS Virtual Private Cloud

A VPC configuration is provided with Terraform. Details can be found on the VPC Setup Page.

Virtual Private Network

Configuration is provided for an OpenVPN setup in the VPC. Details can be found on the VPN Setup Page.

CLA assistant