Simple, cloud native infrastructure for Kubernetes.
Go Shell Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.circleci Attempt to get ssh test working in CircleCI Mar 9, 2018
apis hacking user data Apr 13, 2018
bootstrap @ 985d6dc bootstrap, version: move bootstrap scripts and refactor version logic Mar 27, 2018
cloud Fix delete after amazon cluster update Apr 17, 2018
cmd updated code to use fix suggested in PR Apr 4, 2018
docker Update references from kris-nova/kubicorn to kubicorn/kubicorn Mar 2, 2018
docs docs: minor fixes Mar 22, 2018
examples Update references from kris-nova/kubicorn to kubicorn/kubicorn Mar 2, 2018
pkg profiles,digitalocean: add controller ubuntu profile Apr 9, 2018
profiles profiles,digitalocean: add controller ubuntu profile Apr 9, 2018
scripts fix sed command on OSX, replaced with echo and simplified logic Aug 9, 2017
test Remove unneeded constants Apr 3, 2018
vendor wooop dep Mar 25, 2018
.gitignore Remove generated documentation Feb 28, 2018
.gitmodules bootstrap, version: move bootstrap scripts and refactor version logic Mar 27, 2018
.travis.yml state,s3: implement s3 state store Feb 28, 2018
AUTHORS Merge branch 'master' into hacking-user-data Apr 13, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jul 17, 2017
CONTRIBUTING.md Update references from kris-nova/kubicorn to kubicorn/kubicorn Mar 2, 2018
Dockerfile Remove leftover environment variable Apr 4, 2018
Gopkg.lock wooop dep Mar 25, 2018
Gopkg.toml Yay, getting it compiled Mar 24, 2018
LICENSE Another commit from somewhere above the rocky mountains.. Jul 1, 2017
Makefile *: version review Mar 27, 2018
README.md readme: link to site instead of _docs Mar 29, 2018
VERSION bootstrap, version: move bootstrap scripts and refactor version logic Mar 27, 2018
main.go Update references from kris-nova/kubicorn to kubicorn/kubicorn Mar 2, 2018

README.md

Create, manage, snapshot, and scale Kubernetes infrastructure in the public cloud.

Build Status Go Report Card

Phonetic pronunciation: KEW - BHIK - OH - AR - IN

Project Update

  • Kubicorn will be going through a breaking API change as we adopt the upstream cluster API
  • Kubicorn has moved to github.com/kubicorn/kubicorn permanently.
  • Kubicorn will be targeting a stable release shortly!

About

kubicorn is an free and open source project that solves the Kubernetes infrastructure problem and gives users a rich golang library to work with infrastructure.

kubicorn is a project that helps a user manage cloud infrastructure for Kubernetes. With kubicorn a user can declaratively create new clusters, modify and scale them.

NOTE: This is a work-in-progress, we do not consider it production ready. Use at your own risk and if you're as excited about it as we are, maybe you want to join us on the #kubicorn channel in the Kubernetes Slack community.

Previously, we mainly used a channel in the Gophers Slack community, which is still active, but we're moving to the Kubernetes Slack. You can also get involved and send your questions to our public mailing list.

We hold developer calls biweekly on Tuesdays, 1pm Pacific Time. By joining the mailing list, you'll get a calendar invite.

Proudly packaged with Golang dep

Core Values

Community first.

This is a community driven project. We love you, and respect you. We are here to help you learn, help you grow, and help you succeed. If you have an idea, please share it.

Developer empathy.

We are all software engineers, and we all work in many different code bases. We want the code to be stable, and approachable. We strive for clean and simple software, and we encourage refactoring and fixing technical debt.

Operational empathy.

We want our tool to work, and work well. If an operator is running kubicorn it should feel comfortable and make sense to them. We want operators to feel empowered.

Infrastructure as software.

We believe that the oh-so important layer of infrastructure should be represented as software (not as code!). We hope that our project demonstrates this idea, so the community can begin thinking in the way of the new paradigm.

Rainbows and Unicorns

We believe that sharing is important, and encouraging our peers is even more important. Part of contributing to kubicorn means respecting, encouraging, and welcoming others to the project.

Installing

$ go get github.com/kubicorn/kubicorn

..or read the Install Guide.

Quickstart

This asciicast shows how to get a Kubernetes cluster on Digital Ocean using kubicorn in less than 5 minutes:

asciicast

Concepts

Create

kubicorn lets a user create a Kubernetes cluster in a cloud of their choice.

Apply

Define what you want, then apply it. That simple.

Scale

kubicorn is powered by a state enforcement pattern. A user defines the intended state of Kubernetes infrastructure, and kubicorn can enforce the intended state.

Enforce

kubicorn is built as a library and a framework. Thus allowing it to be easily vendored into operator and controller patterns to enforce intended state of infrastructure.

Documentation

Name Description Link
Install Install guide for Kubicorn CLI install
Environmental Variables Master list of supported environmental variables envvars
Kops vs Kubicorn Blog about kubicorn with comparison table nivenly.com/kubicorn
Azure Walkthrough A walkthrough guide on installing Kubernetes on Azure walkthrough
AWS Walkthrough A walkthrough guide on installing Kubernetes on AWS walkthrough
DigitalOcean Walkthrough A walkthrough guide on installing Kubernetes on D.O. walkthrough
DigitalOcean Quickstart A quickstart asciicast on installing Kubernetes on D.O. asciinema
Google Compute Engine Walkthrough A walkthrough guide on installing Kubernetes on GCE walkthrough
OVH Walkthrough A walkthrough guide on installing Kubernetes on OVH walkthrough
OVH Video A quickstart asciicast on installing Kubernetes on OVH asciinema
Packet Walkthrough A walkthrough guide on installing Kubernetes on Packet walkthrough
AWS Video A step by step video of using Kubicorn in AWS video
DigitalOcean Video A step by step video of using Kubicorn in DigitalOcean video
Tech N Talk Deep Dive A technical deep dive courtesy of RedHat youtube