openstack
/
openstack-ansible
Code Issues Proposed changes

Ensure that RDO/SUSE series repo instructions stay up to date 

The deployment host documentation gets out of date really quickly.
This patch makes it self maintaining.

Note that due to the fact that this is a stable branch and that
the documentation configuration is vastly different to master,
this is a re-implementation rather than a backport.

Some formatting adjustments have made to prevent the interpretation
of URL's as links by sphinx and to remove the use of multi-line shell
commands.

Closes-Bug: #1759721
Change-Id: Id28540d335390a52e0eb65a734a1d594235265d6
This commit is contained in:
Jesse Pretorius 2018-04-04 11:33:48 +01:00
parent 90d0679d20
commit 611ba5b20c
2 changed files with 14 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
deploy-guide/source/conf.py
View File

@ -319,6 +319,8 @@ rst_epilog = """
.. |current_release_formal_name| replace:: %s
.. |upgrade_backup_dir| replace:: %s
.. |latest_tag| replace:: %s
.. |rdo_series| replace:: %s
.. |suse_series| replace:: %s
""" % (previous_release_branch_name,
current_release_branch_name,
previous_release_capital_name,
@ -326,7 +328,9 @@ rst_epilog = """
current_release_capital_name,
current_release_formal_name,
upgrade_backup_dir,
latest_tag)
latest_tag,
current_release_branch_name,
current_release_formal_name)
watermark = os.popen("git branch --contains $(git rev-parse HEAD) | awk -F/ '/stable/ {print $2}'").read().strip(' \n\t').capitalize()
if watermark == "":

23
deploy-guide/source/deploymenthost.rst
View File

@ -59,8 +59,7 @@ Before you begin, we recommend upgrading your system packages and kernel.
.. code-block:: shell-session
# apt-get install aptitude build-essential git ntp ntpdate \
openssh-server python-dev sudo
# apt-get install aptitude build-essential git ntp ntpdate openssh-server python-dev sudo
#. Configure NTP to synchronize with a suitable time source.
@ -81,11 +80,10 @@ Before you begin, we recommend upgrading your system packages and kernel.
#. Install additional software packages if they were not installed
during the operating system installation:
.. code-block:: shell-session
.. parsed-literal::
# yum install https://rdoproject.org/repos/openstack-pike/rdo-release-pike.rpm
# yum install git ntp ntpdate openssh-server python-devel \
sudo '@Development Tools'
# yum install \https://rdoproject.org/repos/openstack-|rdo_series|/rdo-release-|rdo_series|.rpm
# yum install git ntp ntpdate openssh-server python-devel sudo '\@Development Tools'
#. Configure NTP to synchronize with a suitable time source.
@ -123,11 +121,10 @@ Before you begin, we recommend upgrading your system packages and kernel.
#. Install additional software packages if they were not installed
during the operating system installation:
.. code-block:: shell-session
.. parsed-literal::
# zypper ar http://download.opensuse.org/repositories/Cloud:/OpenStack:/Pike/openSUSE_Leap_42.3 OBS:Cloud:OpenStack:Pike
# zypper install git-core ntp openssh python-devel \
sudo gcc libffi-devel libopenssl-devel
# zypper ar \http://download.opensuse.org/repositories/Cloud:/OpenStack:/|suse_series|/openSUSE_Leap_42.3 OBS:Cloud:OpenStack:|suse_series|
# zypper install git-core ntp openssh python-devel sudo gcc libffi-devel libopenssl-devel
#. Configure NTP to synchronize with a suitable time source.
@ -176,16 +173,14 @@ Install the source and dependencies for the deployment host.
.. parsed-literal::
# git clone -b |latest_tag| https://git.openstack.org/openstack/openstack-ansible \\
/opt/openstack-ansible
# git clone -b |latest_tag| \https://git.openstack.org/openstack/openstack-ansible /opt/openstack-ansible
If git.openstack.org can not be accessed to run git clone, github.com can be used
as an alternative repo:
.. parsed-literal::
# git clone -b |latest_tag| https://github.com/openstack/openstack-ansible.git \\
/opt/openstack-ansible
# git clone -b |latest_tag| \https://github.com/openstack/openstack-ansible.git /opt/openstack-ansible
#. Change to the ``/opt/openstack-ansible`` directory, and run the
Ansible bootstrap script: