Bug 1160833

Summary:	Fedora 21 Beta Atomic Image: broken links, incomplete documentation, missing "docker" executable
Product:	[Retired] Atomic	Reporter:	M. Edward (Ed) Borasky <znmeb>
Component:	docker-io	Assignee:	Colin Walters <walters>
Status:	CLOSED CURRENTRELEASE	QA Contact:
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	unspecified	CC:	admiller, dwalsh, golang-updates, herrold, hushan.jia, jperrin, jzb, lsm5, mattdm, mgoldman, miminar, ricardo.arguello, s, thrcka, vbatts, walters, znmeb
Target Milestone:	---
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-06-03 12:21:22 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description M. Edward (Ed) Borasky 2014-11-05 18:37:19 UTC

Description of problem: Multiple problems with Fedora 21 Beta Atomic Image: broken links, incomplete documentation, missing "docker" executable


Version-Release number of selected component (if applicable): Atomic Images beta

Steps to Reproduce:
1. Browse to http://fedoraproject.org/en/get-prerelease#cloud.
2. Attempt to download and discover broken link to qcow2 and raw disk images on the beta release page.
3. Find, download, verify checksum of images at http://mirror.pnl.gov/fedora/linux/releases/test/21-Beta/Cloud/Images/x86_64/
4. Prepare an initialization ISO file as described in http://www.projectatomic.io/docs/quickstart/ and https://www.technovelty.org//linux/running-cloud-images-locally.html. Note that said documentation
    a. Is *not* part of the Fedora documentation, which is something I expect for something carrying the "Fedora Cloud" brand, and
    b. Nowhere is it *explicitly* stated that the username is "fedora" or that once you log in as "fedora", "sudo su -" works to get you into "root" on the console.
5. Log in as "fedora", type "sudo su -" and type "docker ps". 

Actual results: '-bash: docker: command not found'


Expected results: 
1. Working links on the beta release page
2. Fedora-branded documentation with the username and how to obtain root.
3. Docker installed and ready to create images and containers.

Comment 1 Matthew Miller 2014-11-05 19:06:32 UTC

Thanks; I'll make sure these reports get to the right people. We're working on a respin that will address at least some of them.

for "4", the expectation is that you will launch the image in OpenStack or in EC2. Needing better documentation for running locally is noted, however.

Comment 2 Matthew Miller 2014-11-05 19:12:34 UTC

The missing links may just be badly synced mirrors, but the redirects are only _supposed_ to go to mirrors which have the file. I can reproduce, so clearly something is wrong.

Comment 3 Joe Brockmeier 2014-11-05 19:24:34 UTC

Note that the image used here is a regular cloud image, not the Atomic image - so it won't have Docker, etc. We need to fix the missing image problem, of course, but the other issues (docker not found) won't apply.

Comment 4 M. Edward (Ed) Borasky 2014-11-05 20:10:18 UTC

(In reply to Joe Brockmeier from comment #3)
> Note that the image used here is a regular cloud image, not the Atomic image
> - so it won't have Docker, etc. We need to fix the missing image problem, of
> course, but the other issues (docker not found) won't apply.

"The Fedora Atomic Base image is a minimal set of Fedora packages optimized for use as a Docker container host. Read more about Docker Container Images."

How can you use an image as a Docker container *host* if it does not include the docker-io package?

Comment 5 Matthew Miller 2014-11-05 21:47:29 UTC

(In reply to M. Edward (Ed) Borasky from comment #4)
> "The Fedora Atomic Base image is a minimal set of Fedora packages optimized
> for use as a Docker container host. Read more about Docker Container Images."
> 
> How can you use an image as a Docker container *host* if it does not include
> the docker-io package?

As Joe said, the Atomic image isn't the one you found. We'll fix the distribution problem soon, but we're also putting together a new spin with some (other) problems fixed and new features which should be ready in a day or so. In the  meantime, it *did* get uploaded to EC2, so you can use that (use the launch it button on the prerelease page) -- but, really, it's probably better to wait a few days.

Or, you can use the _regular_ cloud image (the Fedora Cloud Base image), which _is_ the one you found, and "sudo yum install docker".

Comment 6 M. Edward (Ed) Borasky 2014-11-06 04:57:21 UTC

(In reply to Matthew Miller from comment #5)
> (In reply to M. Edward (Ed) Borasky from comment #4)
> > "The Fedora Atomic Base image is a minimal set of Fedora packages optimized
> > for use as a Docker container host. Read more about Docker Container Images."
> > 
> > How can you use an image as a Docker container *host* if it does not include
> > the docker-io package?
> 
> As Joe said, the Atomic image isn't the one you found. We'll fix the
> distribution problem soon, but we're also putting together a new spin with
> some (other) problems fixed and new features which should be ready in a day
> or so. In the  meantime, it *did* get uploaded to EC2, so you can use that
> (use the launch it button on the prerelease page) -- but, really, it's
> probably better to wait a few days.
> 
> Or, you can use the _regular_ cloud image (the Fedora Cloud Base image),
> which _is_ the one you found, and "sudo yum install docker".

Thanks! I'll wait a few days - Docker is running flawlessly on my Fedora 21 Beta workstation.

Comment 7 Lokesh Mandvekar 2014-11-06 14:56:46 UTC

Matt, Joe: btw, who owns the f21 atomic image? Just making sure they're on the cc list, if not assignee

Comment 8 Lokesh Mandvekar 2014-12-12 16:37:03 UTC

Colin, Matt: ping, what's the status on this one? Fixed in the final 21 release image?