New CentOS Atomic Host with Updated Docker, Kubernetes and Etcd

Wednesday, 15, February 2017 Jason Brooks announcement 1 Comment

An updated version of CentOS Atomic Host (tree version 7.20170209), is now available, including significant updates to docker (version 1.12.5), kubernetes (version 1.4) and etcd (version 3.0.15).

CentOS Atomic Host is a lean operating system designed to run Docker containers, built from standard CentOS 7 RPMs, and tracking the component versions included in Red Hat Enterprise Linux Atomic Host.

CentOS Atomic Host is available as a VirtualBox or libvirt-formatted Vagrant box, or as an installable ISO, qcow2 or Amazon Machine image. These images are available for download at The backing ostree repo is published to

CentOS Atomic Host includes these core component versions:

Containerized kubernetes-master

The downstream release of CentOS Atomic Host ships without the kubernetes-master package built into the image. Instead, you can run the master kubernetes components (apiserver, scheduler, and controller-manager) in containers, managed via systemd, using the service files and instructions on the CentOS wiki. The containers referenced in these systemd service files are built in and hosted from the CentOS Community Container Pipeline, based on Dockerfiles from
the CentOS-Dockerfiles repository.

These containers have been tested with the kubernetes ansible scripts provided in the upstream contrib repository, and they work as expected, provided you first copy the service files onto your master.


If you're running a previous version of CentOS Atomic Host, you can upgrade to the current image by running the following command:

$ sudo atomic host upgrade


Vagrant and are Vagrant boxes for Libvirt and Virtualbox providers.

The easiest way to consume these images is via the Atlas / Vagrant Cloud setup (see For example, getting the VirtualBox instance up would involve running the following two commands on a machine with vagrant installed:

$ vagrant init centos/atomic-host && vagrant up --provider virtualbox 


The installer ISO can be used via regular install methods (PXE, CD, USB image, etc.) and uses the Anaconda installer to deliver the CentOS Atomic Host. This image allows users to control the install using kickstarts and to define custom storage, networking and user accounts. This is the recommended option for getting CentOS Atomic Host onto bare metal machines, or for generating your own image sets for custom environments.


The CentOS-Atomic-Host-7-GenericCloud.qcow2 image is suitable for use in on-premise and local virtualized environments. We test this on OpenStack, AWS and local Libvirt installs. If your virtualization platform does not provide its own cloud-init metadata source, you can create your own NoCloud iso image.

Amazon Machine Images

Region Image ID
us-east-1 ami-10f53a06
us-west-2 ami-4d9b1c2d
us-west-1 ami-4ae1bd2a
eu-west-1 ami-1daa8c7b
eu-central-1 ami-e8c20987
ap-southeast-1 ami-a8388fcb
ap-northeast-1 ami-ba2b67dd
ap-southeast-2 ami-1f84857c
ap-northeast-2 ami-adbd6dc3
sa-east-1 ami-1f492e73

SHA Sums

6f8b91373c763cf96ffead6ca044ddf6eea5c0b102a239933c112a7f1089396e  CentOS-Atomic-Host-7.1701-GenericCloud.qcow2
380dcbdd4514f87f8915fee418cc965985c89a91b9182af622e36ffad26c9e04  CentOS-Atomic-Host-7.1701-GenericCloud.qcow2.gz
0bf3d5ec95d40cee94bc80e7c19206b3a260d2835fa43f1e99965bb8f99a777d  CentOS-Atomic-Host-7.1701-GenericCloud.qcow2.xz
bc55326e54832e3e08530e41cb738c4b293a7645c960a4c9be7f66024770a68c  CentOS-Atomic-Host-7.1701-Installer.iso

Release Cycle

The CentOS Atomic Host image follows the upstream Red Hat Enterprise Linux Atomic Host cadence. After sources are released, they're rebuilt and included in new images. After the images are tested by the SIG and deemed ready, we announce them.

Getting Involved

CentOS Atomic Host is produced by the CentOS Atomic SIG, based on upstream work from Project Atomic. If you'd like to work on testing images, help with packaging, documentation -- join us!

The SIG meets weekly on Thursdays at 16:00 UTC in the #centos-devel channel, and you'll often find us in #atomic and/or #centos-devel if you have questions. You can also join the atomic-devel mailing list if you'd like to discuss the direction of Project Atomic, its components, or have other questions.

Getting Help

If you run into any problems with the images or components, feel free to ask on the centos-devel mailing list.

Have questions about using Atomic? See the atomic mailing list or find us in the #atomic channel on Freenode.

One thought on "New CentOS Atomic Host with Updated Docker, Kubernetes and Etcd"

  1. Mark Liggett says:

    I've bashed out a basic Ansible playbook that will install the Kubernetes master service definitions from the wiki, it's available at
    After running you're ready to use the upstream Kubernetes ansible scripts to build the cluster. Happy clustering!

Leave a Reply

Your email address will not be published. Required fields are marked *