Red Hat Bugzilla – Bug 1270619
[DOCS] [3.1] [Feature] Document the non-interactive Installer for 3.1
Last modified: 2017-03-08 13:13 EST
This is targeted to be done by 10/16 by the eng team.
The use case is to define a declared file (and format) for driving a non-interactive installation.
The interface is classified as public and therefore can only be added to, but not removed.
Check with the productization team for more details.
To go in the Install and Config Guide.
The two stories that are relevant to this request are:
You should be able to see QE's test cases here for usage examples:
From reading the description I think the most important thing will be to document the installation tool's config format. You can join that card and sync with Devan on the latest details. The format is fairly stable now. I suspect in a day or two Sam and Devan can give you a build you can try out for yourself.
One thing to clarify in QE's test cases. They were written before the config file format was finalized. Those tests will be updated once https://trello.com/c/fHy2DzMN/54-5-supported-installation-configuration-file-format is complete. For now just sync with Devan on that card to get the latest config file details.
Thanks Brenton, I have reached out to Devan for details.
Created docs pull request (WIP for now) containing full explanation of new non-interactive install configuration file format.
Waiting on details of how to use file, have pinged SME in Trello card: https://trello.com/c/fHy2DzMN
Alex Dellapenta pulled my work into a new PR since it dove-tailed into something he was working on.
My PR#1126 will be closed in favour of PR#1128.
New PR: https://github.com/openshift/openshift-docs/pull/1128
Got answer from SME in Trello card: https://trello.com/c/fHy2DzMN
1. For "ansible_log_path", this was not defined in the sample you provided. If the user wanted to change this from the default, would it matter what line in the file this was written on? Should it go before or after the "hosts" section?
2. How does the user specify to use this file for an installation, once they've written the file?
for (1) the ansible log path can go anywhere in the config file provided it's not indented like the hosts lines are. Typically it would be written before the hosts line but it doesn't really matter.
For (2) if the default location is used, it will automatically be read and re-used the next time the user runs the installation. Same holds true if they use a different location with -c, they just have to provide the same -c again on each run.
Added comments into Alex's PR#1128 since I'm not sure how to pull his PR, make changes, and push back to his fork. I don't think that's possible unless he gives me permissions on his personal GitHub fork.
Submitted new PR to include "version", which was recently added to this installation configuration file specification:
I think that should do it. Moving to QA.
^ this commit makes the final changes for this bug.
This has passed QE.
This bug is verified.
This has merged, moving to RELEASE PENDING