Prepare the deployment host in OpenStack-Ansible: who should create /etc/openstack_deploy?

[Marcin Dulak]

- [x] This doc is inaccurate in this way:

On CentOS7, the first run of `cd /opt/openstack-ansible&& ./scripts/bootstrap-ansible.sh`
does not create the `/etc/openstack_deploy` directory. This directory appears only after the second run of `cd /opt/openstack-ansible&& ./scripts/bootstrap-ansible.sh`.

On the other hand the https://docs.openstack.org/project-deploy-guide/openstack-ansible/latest/configure.html#initial-environment-configuration page says:

"1.Copy the contents of the /opt/openstack-ansible/etc/openstack_deploy directory to the /etc/openstack_deploy directory."

which to me sounds like the step 1. assumes `/etc/openstack_deploy` should already be present.

-----------------------------------
Release: 17.0.0.0b3.dev68 on 2018-01-19 22:04
SHA: eb67707b5ddabef8b4536324bc2c096f23f16d17
Source: https://git.openstack.org/cgit/openstack/openstack-ansible/tree/deploy-guide/source/deploymenthost.rst
URL: https://docs.openstack.org/project-deploy-guide/openstack-ansible/latest/deploymenthost.html

[Jean-Philippe Evrard (jean-philippe-evrard)]

bootstrap ansible shouldn't care about the openstack_deploy folder: it's only used for downloading the roles necessary to deploy and put them to a location you can use with ansible, by also creating our wrapper script named "openstack-ansible".

It should not be linked the /etc/openstack_deploy, and that steps still need to be done.

I am not sure to understand what's the accuracy issue, or the expectation issue? Should we state more explicitly what the bootstrap-ansible.sh script is doing maybe?

[Marcin Dulak (marcin-dulak)]

My impression is that running bootstrap-ansible.sh for the second time creates /etc/openstack_deploy and I found this confusing.

I would say maybe https://docs.openstack.org/project-deploy-guide/openstack-ansible/latest/configure.html#initial-environment-configuration could say explicitly:

Copy /opt/openstack-ansible/etc/openstack_deploy directory to the /etc directory.

By the way, would it be a good idea to state the shell commands instead of describing the operations in language?

cp -r /opt/openstack-ansible/etc/openstack_deploy /etc

That would make it easier to copy-paste the tutorial, or maybe even run the tutorial commands automatically from a script against an existing test environment, what I do.

[Marcin Dulak (marcin-dulak)]

Please remove the incomplete flag.
The suggestion for changes in the doc has been given.

[Launchpad Janitor (janitor)]

[Expired for openstack-ansible because there has been no activity for 60 days.]