Get Started with CentOS Atomic Host

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.

To learn more about the concepts behind the Atomic Host model, check out this introduction on the Project Atomic site.

If you're interested in a faster-moving version of CentOS Atomic Host, check out our Continuous and Alpha streams.

Docker and Kubernetes

The host images available for download below ship with Docker configured and ready to run. The images also include the components required to run a Kubernetes node. CentOS Atomic Host ships without the kubernetes-master package built into the image. You can install the master kubernetes components (apiserver, scheduler, and controller-manager) as system containers, using the following commands:

# atomic install --system --system-package=no --name kube-apiserver registry.centos.org/centos/kubernetes-apiserver:latest

# atomic install --system --system-package=no --name kube-scheduler registry.centos.org/centos/kubernetes-scheduler:latest

# atomic install --system --system-package=no --name kube-controller-manager registry.centos.org/centos/kubernetes-controller-manager:latest

Kubernetes 1.8.x

The CentOS Virt SIG is now producing Kubernetes 1.8.x rpms, available through this yum repo. The Atomic SIG is maintaining system containers based on these rpms that can be installed as as follows:

on your master

# atomic install --system --system-package=no --name kube-apiserver registry.centos.org/centos/kubernetes-sig-apiserver:latest 

# atomic install --system --system-package=no --name kube-scheduler registry.centos.org/centos/kubernetes-sig-scheduler:latest

# atomic install --system --system-package=no --name kube-controller-manager registry.centos.org/centos/kubernetes-sig-controller-manager:latest

on your node(s)

# atomic install --system --system-package=no --name kubelet registry.centos.org/centos/kubernetes-sig-kubelet:latest 

# atomic install --system --system-package=no --name kube-proxy registry.centos.org/centos/kubernetes-sig-proxy:latest

Both the 1.5.x and 1.8.x sets of containers have been tested with the kubernetes ansible scripts provided in the upstream contrib repository, and function as drop-in replacements for the installed rpms. If you prefer to run Kubernetes from installed rpms, you can layer the master components onto your Atomic Host image using rpm-ostree package layering with the command: atomic host install kubernetes-master.

These containers are built in and hosted from the CentOS Community Container Pipeline, based on Dockerfiles from the CentOS-Dockerfiles repository.

CentOS Atomic Host Images

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 produced and maintained by the CentOS Atomic SpecialInterestGroup.

All configs and metadata used to produce these builds is hosted on Github at https://github.com/CentOS/sig-atomic-buildscripts/tree/downstream. For more information, get in touch with the SIG on the CentOS-Devel mailing list (http://lists.centos.org). Feel free to get involved!

Generic Cloud Images

These are qcow2 files, that can either be uploaded into a cloud setup like OpenStack, OpenNebula, CloudStack, Eucalyptus, etc, or they can be run locally on your own machine with libvirt kvm or xen.

These images rely on cloud-init for enabling access. Look to your cloud providers' documentation for more information, or, for virtualization tools without built-in cloud-init support, check out this guide.

Image

SHA256Sum

Built On

Uncompressed qcow2

SHA256Sum

2017-Nov-28

xz Compressed qcow2

SHA256Sum

2017-Nov-28

gz Compressed qcow2

SHA256Sum

2017-Nov-28

Vagrant Images

Vagrant images are also available, depending on the vagrant backend being used. We are currently producing libvirt/KVM images and VirtualBox-compatible images.

Image

SHA256Sum

Built On

Libvirt/KVM

SHA256Sum

2017-Nov-28

VirtualBox

SHA256Sum

2017-Nov-28

The easiest way to consume these images is via the Atlas / Vagrant Cloud setup (see https://atlas.hashicorp.com/centos/boxes/atomic-host. 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 

Installable ISO Images

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 is the recommended process for getting CentOS Atomic Host onto bare metal machines, or to generate your own image sets for custom environments.

Image

SHA256Sum

Built On

ISO Image

SHA256Sum

2017-Nov-28

Amazon AMIs

7.201705

Ami ID

Type

Region

Built On

ami-70e8fd66

8GB EBS HVM gp2

us-east-1

2017-07-17

ami-c0c4bdaf

8GB EBS HVM gp2

ap-south-1

2017-07-17

ami-dba8bebf

8GB EBS HVM gp2

eu-west-2

2017-07-17

ami-42b6593b

8GB EBS HVM gp2

eu-west-1

2017-07-17

ami-7b5e8015

8GB EBS HVM gp2

ap-northeast-2

2017-07-17

ami-597a9e3f

8GB EBS HVM gp2

ap-northeast-1

2017-07-17

ami-95aedaf9

8GB EBS HVM gp2

sa-east-1

2017-07-17

ami-473e8123

8GB EBS HVM gp2

ca-central-1

2017-07-17

ami-93b425f0

8GB EBS HVM gp2

ap-southeast-1

2017-07-17

ami-e1332f82

8GB EBS HVM gp2

ap-southeast-2

2017-07-17

ami-e95ffd86

8GB EBS HVM gp2

eu-central-1

2017-07-17

ami-1690b173

8GB EBS HVM gp2

us-east-2

2017-07-17

ami-189fb178

8GB EBS HVM gp2

us-west-1

2017-07-17

ami-a52a34dc

8GB EBS HVM gp2

us-west-2

2017-07-17

Deploying Previous Versions

If you want to roll back to a particular previous version of CentOS Atomic Host, you can do so with the atomic host deploy command. For instance, to revert to the June 2016 release, you would run the commands:

sudo atomic host deploy 7.20160404
sudo systemctl reboot

Previous Tree Versions

version

commit id

date

7.1710

4eaac528349aba28dd988975b4e2b31e4590dd115079946acd7ce1409b51e5ac

2017-11-09 13:54:59

7.1708

33b4f0442242a06096ffeffadcd9655905a41fbd11f36cd6f33ee0d974fdb2a8

2017-09-15 15:32:30

7.1707

0bf6200211dd4fd63be6e9bc5c90bea645e2696c0117b05f83562081813a5b94

2017-07-31 16:12:06

7.1706

4620e591a76a44b624f6526bc6e8222d6db8de111e504ea50bbb544cd904a040

2017-07-06 16:32:44

7.1705.1

550d13d3e1fda491afab6d368adc13e307512ea51734055d83f0cc4d9049e91d

2017-06-20 18:46:11

7.1705

d3d69b6b70bad42becfb8be1cc8fadffb78a1053721c72363e3669dcba814bd4

2017-06-13 08:36:46

7.20170428

67c8af37c5d05bb3b377ec1bd3c127f98664d6f7a78bf2089fcfb02784d12fbd

2017-05-09 16:53:51

7.20170405

91fe03fef75652f68a9974261b391faaeb5bd20f33abf09bb1d45511ba2df04e

2017-04-10 05:19:14

7.20170209

d433342b09673c9c4d75ff6eef50a447e73a7541491e5197e1dde14147b164b8

2017-02-10 00:54:47

7.20170117

5d8b88fbdde5e1df9f50a837f881da9d6031ba5a3af5f1681b9d38793a7f503f

2017-01-17 17:45:04

7.20161104

daf53c718bd1cd9b84b1b5d21843cd9b981d3634c2444c2bcb09cccee771058b

2016-11-04 22:53:08

7.20161006

2ad34dba5286d69de71b61678d5190b246e7836beada3cdfa18f7bfa4ae3c3f0

2016-10-05 23:28:52

7.20160920

54ab8ab29b51eabb82e78932d12a16b16170051dcc983714e7ff11bc8f1deaf0

2016-09-20 16:46:56

7.20160818

709bfd3c4d9274c32bc3b691d642a3f95431136ec1a6b32e4cd5a13764647ba1

2016-08-18 14:28:07

7.20160707

cd47a72eb5246c28515c48726e36afc383487e403361d06cc7403abf61d95985

2016-07-07 21:23:41

7.20160610

3c3786d1ddcaa3cf0895988e7ce14863b8b460acea11d0e8eed7dde04b6ca694

2016-06-10 13:15:00

7.20160404

e39c28570a7ceb765feed1a0f017b94641e75137afd317730c7cd3a6651492f6

2016-04-04 21:25:34

7.20160224

378538275fd9029a92435dc8c1efdb7a3486b04de47a2e6ac96752015b8352e5

2016-02-24 08:01:24

Previous Amazon AMIs

7.201705

Ami ID

Type

Region

Built On

ami-90e7c686

8GB EBS HVM gp2

us-east-1

2017-06-15

ami-2ba1de44

8GB EBS HVM gp2

ap-south-1

2017-06-15

ami-2b44524f

8GB EBS HVM gp2

eu-west-2

2017-06-15

ami-a6c5dbc0

8GB EBS HVM gp2

eu-west-1

2017-06-15

ami-87ba65e9

8GB EBS HVM gp2

ap-northeast-2

2017-06-15

ami-64868e03

8GB EBS HVM gp2

ap-northeast-1

2017-06-15

ami-f9197295

8GB EBS HVM gp2

sa-east-1

2017-06-15

ami-66e55a02

8GB EBS HVM gp2

ca-central-1

2017-06-15

ami-850a88e6

8GB EBS HVM gp2

ap-southeast-1

2017-06-15

ami-caf7e6a9

8GB EBS HVM gp2

ap-southeast-2

2017-06-15

ami-42e84f2d

8GB EBS HVM gp2

eu-central-1

2017-06-15

ami-89bb9dec

8GB EBS HVM gp2

us-east-2

2017-06-15

ami-245b7644

8GB EBS HVM gp2

us-west-1

2017-06-15

ami-68818a11

8GB EBS HVM gp2

us-west-2

2017-06-15

7.20170428

Ami ID

Type

Region

Built On

ami-4a70015c

8GB EBS HVM gp2

us-east-1

2017-05-11

ami-9c7b06f3

8GB EBS HVM gp2

ap-south-1

2017-05-11

ami-14425570

8GB EBS HVM gp2

eu-west-2

2017-05-11

ami-a1b9b7c7

8GB EBS HVM gp2

eu-west-1

2017-05-11

ami-e01cc18e

8GB EBS HVM gp2

ap-northeast-2

2017-05-11

ami-2a0d304d

8GB EBS HVM gp2

ap-northeast-1

2017-05-11

ami-ce7619a2

8GB EBS HVM gp2

sa-east-1

2017-05-11

ami-8b813def

8GB EBS HVM gp2

ca-central-1

2017-05-11

ami-61e36702

8GB EBS HVM gp2

ap-southeast-1

2017-05-11

ami-84c7cde7

8GB EBS HVM gp2

ap-southeast-2

2017-05-11

ami-f970ae96

8GB EBS HVM gp2

eu-central-1

2017-05-11

ami-d2cfe8b7

8GB EBS HVM gp2

us-east-2

2017-05-11

ami-57ba9c37

8GB EBS HVM gp2

us-west-1

2017-05-11

ami-fbd8bd9b

8GB EBS HVM gp2

us-west-2

2017-05-11

7.20170405

Ami ID

Type

Region

Built On

ami-a50d85b3

8GB EBS HVM gp2

us-east-1

2017-04-11

ami-13f6857c

8GB EBS HVM gp2

ap-south-1

2017-04-11

ami-42233726

8GB EBS HVM gp2

eu-west-2

2017-04-11

ami-49063c2f

8GB EBS HVM gp2

eu-west-1

2017-04-11

ami-d1c81abf

8GB EBS HVM gp2

ap-northeast-2

2017-04-11

ami-7b1c3e1c

8GB EBS HVM gp2

ap-northeast-1

2017-04-11

ami-914f2dfd

8GB EBS HVM gp2

sa-east-1

2017-04-11

ami-2de75b49

8GB EBS HVM gp2

ca-central-1

2017-04-11

ami-53328c30

8GB EBS HVM gp2

ap-southeast-1

2017-04-11

ami-6d929c0e

8GB EBS HVM gp2

ap-southeast-2

2017-04-11

ami-dca270b3

8GB EBS HVM gp2

eu-central-1

2017-04-11

ami-18bc987d

8GB EBS HVM gp2

us-east-2

2017-04-11

ami-b22a0fd2

8GB EBS HVM gp2

us-west-1

2017-04-11

ami-2e2bbb4e

8GB EBS HVM gp2

us-west-2

2017-04-11

7.20170209

Ami ID

Type

Region

Built On

ami-ba2b67dd

8GB EBS HVM gp2

ap-northeast-1

2017-Feb-13

ami-adbd6dc3

8GB EBS HVM gp2

ap-northeast-2

2017-Feb-13

ami-a8388fcb

8GB EBS HVM gp2

ap-southeast-1

2017-Feb-13

ami-1f84857c

8GB EBS HVM gp2

ap-southeast-2

2017-Feb-13

ami-e8c20987

8GB EBS HVM gp2

eu-central-1

2017-Feb-13

ami-1daa8c7b

8GB EBS HVM gp2

eu-west-1

2017-Feb-13

ami-1f492e73

8GB EBS HVM gp2

sa-east-1

2017-Feb-13

ami-10f53a06

8GB EBS HVM gp2

us-east-1

2017-Feb-13

ami-4ae1bd2a

8GB EBS HVM gp2

us-west-1

2017-Feb-13

ami-4d9b1c2d

8GB EBS HVM gp2

us-west-2

2017-Feb-13

7.20161006

Ami ID

Type

Region

Built On

ami-494e9628

8GB EBS HVM gp2

ap-northeast-1

2016-Oct-06

ami-07bb6f69

8GB EBS HVM gp2

ap-northeast-2

2016-Oct-06

ami-60b51203

8GB EBS HVM gp2

ap-southeast-1

2016-Oct-06

ami-598cbf3a

8GB EBS HVM gp2

ap-southeast-2

2016-Oct-06

ami-6350af0c

8GB EBS HVM gp2

eu-central-1

2016-Oct-06

ami-8c2c6fff

8GB EBS HVM gp2

eu-west-1

2016-Oct-06

ami-5a51c336

8GB EBS HVM gp2

sa-east-1

2016-Oct-06

ami-cfeca0d8

8GB EBS HVM gp2

us-east-1

2016-Oct-06

ami-71bef711

8GB EBS HVM gp2

us-west-1

2016-Oct-06

ami-f020f890

8GB EBS HVM gp2

us-west-2

2016-Oct-06

7.20160818

Ami ID

Type

Region

Built On

ami-d43d5dc3

8GB EBS HVM gp2

us-east-1

2016-Aug-23

ami-52df9d32

8GB EBS HVM gp2

us-west-1

2016-Aug-23

ami-0227f362

8GB EBS HVM gp2

us-west-2

2016-Aug-23

ami-ed4b3d9e

8GB EBS HVM gp2

eu-west-1

2016-Aug-23

ami-014abb6e

8GB EBS HVM gp2

eu-central-1

2016-Aug-23

ami-6ed34202

8GB EBS HVM gp2

sa-east-1

2016-Aug-23

ami-4d35fa2c

8GB EBS HVM gp2

ap-northeast-1

2016-Aug-23

ami-12ae7b7c

8GB EBS HVM gp2

ap-northeast-2

2016-Aug-23

ami-27a27a44

8GB EBS HVM gp2

ap-southeast-1

2016-Aug-23

ami-65b18606

8GB EBS HVM gp2

ap-southeast-2

2016-Aug-23

7.20160707

Ami ID

Type

Region

Built On

ami-956fe882

8GB EBS HVM gp2

us-east-1

2016-Jul-07

ami-191e5879

8GB EBS HVM gp2

us-west-1

2016-Jul-07

ami-17569677

8GB EBS HVM gp2

us-west-2

2016-Jul-07

ami-a06601d3

8GB EBS HVM gp2

eu-west-1

2016-Jul-07

ami-c431dbab

8GB EBS HVM gp2

eu-central-1

2016-Jul-07

ami-30f96d5c

8GB EBS HVM gp2

sa-east-1

2016-Jul-07

ami-fc867b9d

8GB EBS HVM gp2

ap-northeast-1

2016-Jul-07

ami-aca369c2

8GB EBS HVM gp2

ap-northeast-2

2016-Jul-07

ami-9638e5f5

8GB EBS HVM gp2

ap-southeast-1

2016-Jul-07

ami-6fab800c

8GB EBS HVM gp2

ap-southeast-2

2016-Jul-07

7.20160404

Ami ID

Type

Region

Built On

ami-114f5c7b

8GB EBS HVM gp2

us-east-1

2016-Apr-12

ami-e03e4180

8GB EBS HVM gp2

us-west-1

2016-Apr-12

ami-f0e01790

8GB EBS HVM gp2

us-west-2

2016-Apr-12

ami-0b8a0878

8GB EBS HVM gp2

eu-west-1

2016-Apr-12

ami-d8f919b7

8GB EBS HVM gp2

eu-central-1

2016-Apr-12

ami-c7e16fab

8GB EBS HVM gp2

sa-east-1

2016-Apr-12

ami-1386947d

8GB EBS HVM gp2

ap-northeast-1

2016-Apr-12

ami-49dd1527

8GB EBS HVM gp2

ap-northeast-2

2016-Apr-12

ami-3b598c58

8GB EBS HVM gp2

ap-southeast-1

2016-Apr-12

ami-19e7c57a

8GB EBS HVM gp2

ap-southeast-2

2016-Apr-12

7.20160224

Ami ID

Type

Region

Built On

ami-e6d5e88c

8GB EBS HVM gp2

us-east-1

2016-Feb-24

ami-fd62129d

8GB EBS HVM gp2

us-west-1

2016-Feb-24

ami-3fb05d5f

8GB EBS HVM gp2

us-west-2

2016-Feb-24

ami-451ea236

8GB EBS HVM gp2

eu-west-1

2016-Feb-24

ami-ce8663a1

8GB EBS HVM gp2

eu-central-1

2016-Feb-24

ami-059d1f69

8GB EBS HVM gp2

sa-east-1

2016-Feb-24

ami-c74644a9

8GB EBS HVM gp2

ap-northeast-1

2016-Feb-24

ami-5732fc39

8GB EBS HVM gp2

ap-northeast-2

2016-Feb-24

ami-6c4c850f

8GB EBS HVM gp2

ap-southeast-1

2016-Feb-24

ami-bae8ced9

8GB EBS HVM gp2

ap-southeast-2

2016-Feb-24

7.20160203

Ami ID

Type

Region

Built On

ami-896653e3

8GB EBS HVM gp2

us-east-1

2016-Feb-03

ami-dae791ba

8GB EBS HVM gp2

us-west-1

2016-Feb-03

ami-1f94747f

8GB EBS HVM gp2

us-west-2

2016-Feb-03

ami-430aba30

8GB EBS HVM gp2

eu-west-1

2016-Feb-03

ami-40d6cd2c

8GB EBS HVM gp2

eu-central-1

2016-Feb-03

ami-238d0e4f

8GB EBS HVM gp2

sa-east-1

2016-Feb-03

ami-b54d4adb

8GB EBS HVM gp2

ap-northeast-1

2016-Feb-03

ami-961fd1f8

8GB EBS HVM gp2

ap-northeast-2

2016-Feb-03

ami-4319d720

8GB EBS HVM gp2

ap-southeast-1

2016-Feb-03

ami-27123544

8GB EBS HVM gp2

ap-southeast-2

2016-Feb-03

7.20151118

Ami ID

Type

Region

Built On

ami-19d59073

8GB EBS HVM gp2

us-east-1

2015-Nov-18

ami-48e88628

8GB EBS HVM gp2

us-west-1

2015-Nov-18

ami-cb6878aa

8GB EBS HVM gp2

us-west-2

2015-Nov-18

ami-3c2ff54f

8GB EBS HVM gp2

eu-west-1

2015-Nov-18

ami-f72b399b

8GB EBS HVM gp2

eu-central-1

2015-Nov-18

ami-39348e55

8GB EBS HVM gp2

sa-east-1

2015-Nov-18

ami-cec7e4a0

8GB EBS HVM gp2

ap-northeast-1

2015-Nov-18

ami-49a4652a

8GB EBS HVM gp2

ap-southeast-1

2015-Nov-18

ami-5e421b3d

8GB EBS HVM gp2

ap-southeast-2

2015-Nov-18

7.20151001

Ami ID

Type

Region

Built On

ami-951452f0

8GB EBS HVM gp2

us-east-1

2015-Oct-01

ami-6d9c5a29

8GB EBS HVM gp2

us-west-1

2015-Oct-01

ami-73eaf043

8GB EBS HVM gp2

us-west-2

2015-Oct-01

ami-3936034e

8GB EBS HVM gp2

eu-west-1

2015-Oct-01

ami-7ed1d363

8GB EBS HVM gp2

eu-central-1

2015-Oct-01

ami-1b52c506

8GB EBS HVM gp2

sa-east-1

2015-Oct-01

ami-3428b634

8GB EBS HVM gp2

ap-northeast-1

2015-Oct-01

ami-346f7966

8GB EBS HVM gp2

ap-southeast-1

2015-Oct-01

ami-43f2bb79

8GB EBS HVM gp2

ap-southeast-2

2015-Oct-01

7.20150908

Ami ID

Type

Region

Built On

ami-69c3aa0c

8GB EBS HVM gp2

us-east-1

2015-Sep-08

ami-69679d2d

8GB EBS HVM gp2

us-west-1

2015-Sep-08

ami-a5b6ab95

8GB EBS HVM gp2

us-west-2

2015-Sep-08

ami-0b6e4d7c

8GB EBS HVM gp2

eu-west-1

2015-Sep-08

ami-8c111191

8GB EBS HVM gp2

eu-central-1

2015-Sep-08

ami-47ed785a

8GB EBS HVM gp2

sa-east-1

2015-Sep-08

ami-3458d234

8GB EBS HVM gp2

ap-northeast-1

2015-Sep-08

ami-dc99938e

8GB EBS HVM gp2

ap-southeast-1

2015-Sep-08

ami-05511e3f

8GB EBS HVM gp2

ap-southeast-2

2015-Sep-08

SpecialInterestGroup/Atomic/Download (last edited 2017-12-05 04:09:40 by JasonBrooks)