Docker Cookbook

See Also
• The project Atomic 
documentation
6.6 Using Project Atomic to Run Docker Containers | 183

---

6.7 Starting an Atomic Instance on AWS to Use Docker
Problem
You do not want to use Vagrant to try Atomic (see 
Recipe 6.6
) and do not want to use
an ISO image either.
Solution
Start an Atomic instance on Amazon EC2. Atomic AMIs are available on AWS EC2.
You can open your AWS management console and go through the instance launch
wizard. Search for a community AMI named 
atomic
; several AMIs are available, most
based on the Fedora 22 release. After having created an SSH key pair, you can launch
the instance, and once it is running, you can connect to it. As an example, here you
connect to an Atomic instance with IP address 52.18.234.151. You will have access to
Docker right away:
$ ssh -i ~/.ssh/ fedora@52.18.234.151
[fedora@ip-172-31-46-186 ~]$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
[fedora@ip-172-31-46-186 ~]$ sudo docker version | version
Client version: 1.5.0-dev
...
Server version: 1.5.0-dev
Such an instance comes with the 
atomic
command, which you can use to upgrade the
host. Check the instance status and launch an upgrade. It will download the new
Atomic version. You will then need to reboot to get on the new version:
[fedora@ip-172-31-46-186 ~]$ atomic host status
TIMESTAMP (UTC) VERSION ID OSNAME REFSPEC
* 2015-05-12 18:53:06 22.66 cd414cba85 fedora-atomic fedora-atomic:...
[fedora@ip-172-31-46-186 ~]$ atomic host upgrade
Updating from: fedora-atomic:fedora-atomic/f22/x86_64/docker-host
[fedora@ip-172-31-46-186 ~]$ sudo systemctl reboot
After reboot, you will see that your host has automatically upgraded to a new version
of Docker, which ships in the latest version of Atomic:
[fedora@ip-172-31-46-186 ~]$ sudo docker version
Client version: 1.7.1.fc22
...
Server version: 1.7.1.fc22
...
Discussion
To start an instance, you can use the AWS command-line tools or use the script pro‐
vided in this recipe. The script has the advantage of being based on Apache Libcloud