#156: Need complete Kickstart docs for Atomic Host -------------------------------+--------------------- Reporter: jberkus | Owner: Type: task | Status: new Priority: normal | Milestone: Future Component: Docker Host Image | Keywords: Meeting -------------------------------+--------------------- The documentation here: http://www.projectatomic.io/docs/fedora_atomic_bare_metal_installation/ punts a lot of practical steps off to the main Fedora docs on how to do a kickstart install. Since often atomic bare metal installs will involve a system without full GUI support, we need to make it easy for people to do this.
Part of the issue is that kickstart isn't exactly developer-friendly; it's a bit complicated to use. But we can at least doc a step-by-step.
#156: Need complete Kickstart docs for Atomic Host -------------------------------+--------------------- Reporter: jberkus | Owner: Type: task | Status: new Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+---------------------
Comment (by mmicene):
Last I looked at that doc (which was a while ago) that kickstart file was complete and functional, if short. Aside for support for ostree, there isn't anything specific that Atomic needs from kickstart or kickstart does for Atomic.
What sort of steps do you think are missing? What tasks are folks trying to do with kickstarts that are failing as a result of Atomic? I think there probably are some things we need to document about potential %post behavior differences due to the nature of the layouts.
#156: Need complete Kickstart docs for Atomic Host -------------------------------+--------------------- Reporter: jberkus | Owner: Type: task | Status: new Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+---------------------
Comment (by jberkus):
The docs are fine for people who already know how to use kickstart, but not if they don't. And the man Fedora docs on how to use kickstart files and boot/install from them are confusing and not at all beginner-oriented. Basically I'm approaching this from a "how do I do a headless install" perspective; we want someone to be able to accomplish that without taking a full-day tutorial in Fedora Administration first.
I went over this some with Dusty, and I think doing a simple example of kickstart install from file on laptop + ansible to target server would work as a demonstration case.
#156: Need complete Kickstart docs for Atomic Host -------------------------------+--------------------- Reporter: jberkus | Owner: Type: task | Status: new Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+---------------------
Comment (by mmicene):
Agree that's definitely something we don't have and could be useful. I think we should stress the point that the extremely simple kickstart file is actually complete, especially to lower the stress level of new folks. Or, at least make sure that it is complete, then stress it.
I'm willing to assist you and Dusty here if you like.
#156: Need complete Kickstart docs for Atomic Host -------------------------------+----------------------- Reporter: jberkus | Owner: jberkus Type: task | Status: assigned Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+----------------------- Changes (by jasonbrooks):
* owner: => jberkus * status: new => assigned
#156: Need complete Kickstart docs for Atomic Host -------------------------------+----------------------- Reporter: jberkus | Owner: jberkus Type: task | Status: assigned Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+-----------------------
Comment (by jberkus):
Still working on doc/blog post.
#156: Need complete Kickstart docs for Atomic Host -------------------------------+----------------------- Reporter: jberkus | Owner: jberkus Type: task | Status: assigned Priority: normal | Milestone: Future Component: Docker Host Image | Resolution: Keywords: Meeting | -------------------------------+-----------------------
Comment (by jberkus):
Docs are written, currently in review.