CoreOS on AWS or GCE

Kubernetes v1.12 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see latest version.

Official CoreOS Guides

These guides are maintained by CoreOS and deploy Kubernetes the “CoreOS Way” with full TLS, the DNS add-on, and more. These guides pass Kubernetes conformance testing and we encourage you to test this yourself.

AWS Multi-Node

Guide and CLI tool for setting up a multi-node cluster on AWS. CloudFormation is used to set up a master and multiple workers in auto-scaling groups.

Bare Metal Multi-Node

Guide and HTTP/API service for PXE booting and provisioning a multi-node cluster on bare metal. Ignition is used to provision a master and multiple workers on the first boot from disk.

Vagrant Multi-Node

Guide to setting up a multi-node cluster on Vagrant. The deployer can independently configure the number of etcd nodes, master nodes, and worker nodes to bring up a fully HA control plane.

Vagrant Single-Node

The quickest way to set up a Kubernetes development environment locally. As easy as git clone, vagrant up and configuring kubectl.

Full Step by Step Guide

A generic guide to setting up an HA cluster on any cloud or bare metal, with full TLS. Repeat the master or worker steps to configure more machines of that role.

Community Guides

These guides are maintained by community members, cover specific platforms and use cases, and experiment with different ways of configuring Kubernetes on CoreOS.

Easy Multi-node Cluster on Google Compute Engine

Scripted installation of a single master, multi-worker cluster on GCE. Kubernetes components are managed by fleet.

Multi-node cluster using cloud-config and Weave on Vagrant

Configure a Vagrant-based cluster of 3 machines with networking provided by Weave.

Multi-node cluster using cloud-config and Vagrant

Configure a single master, multi-worker cluster locally, running on your choice of hypervisor: VirtualBox, Parallels, or VMware

Single-node cluster using a small macOS App

Guide to running a solo cluster (master + worker) controlled by an macOS menubar application. Uses xhyve + CoreOS under the hood.

Multi-node cluster with Vagrant and fleet units using a small macOS App

Guide to running a single master, multi-worker cluster controlled by an macOS menubar application. Uses Vagrant under the hood.

Multi-node cluster using cloud-config, CoreOS and VMware ESXi

Configure a single master, single worker cluster on VMware ESXi.

Single/Multi-node cluster using cloud-config, CoreOS and Foreman

Configure a standalone Kubernetes or a Kubernetes cluster with Foreman.

IaaS Provider	Config. Mgmt	OS	Networking	Docs	Conforms	Support Level
GCE	CoreOS	CoreOS	flannel	docs		Community (@pires)
Vagrant	CoreOS	CoreOS	flannel	docs		Community (@pires, @AntonioMeireles)

IaaS Provider

Config. Mgmt

Networking

Docs

Conforms

Support Level

GCE

CoreOS

flannel

docs

Community (@pires)

Vagrant

CoreOS

flannel

docs

Community (@pires, @AntonioMeireles)

Feedback

Was this page helpful?

Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.