openstack/openstack-ansible
Code Issues Proposed changes

[doc] Adjustments for Victoria release cycle

Browse Source 
Change-Id: I5de435a4f79ae204b3bb5699499e7491b75c6bc1
This commit is contained in:
Dmitriy Rabotyagov 2020-08-18 17:42:29 +03:00 committed by Dmitriy Rabotyagov (noonedeadpunk)
parent b7ce47c5f8
commit ab4097f26c
7 changed files with 26 additions and 103 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
deploy-guide/source/app-aboutosa.rst
View File

@ -5,8 +5,8 @@ About OpenStack-Ansible
=======================
OpenStack-Ansible (OSA) uses the `Ansible <https://www.ansible.com/how-ansible-works>`_
IT automation engine to deploy an OpenStack environment on Ubuntu, with CentOS and
openSUSE currently in Beta release.
IT automation engine to deploy an OpenStack environment on Ubuntu, Debian
and CentOS.
For isolation and ease of maintenance, you can install OpenStack components
into machine containers.
@ -21,8 +21,7 @@ listed in our :dev_docs:`architecture reference <reference/architecture/index.ht
Why choose OpenStack-Ansible?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Supports the major Linux distributions Ubuntu, CentOS, Debian
and OpenSUSE (experimental).
* Supports the major Linux distributions Ubuntu, CentOS, Debian.
* Supports the major CPU architectures x86, ppc64, s390x (WIP).
* Offers automation for upgrades between major OpenStack releases.
* Uses OpenStack defaults for each of the project roles, and provides

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

@ -29,9 +29,7 @@ hosts:
* `Ubuntu server 18.04 (Bionic Beaver) LTS 64-bit <http://releases.ubuntu.com/18.04/>`_
* `Ubuntu server 20.04 (Focal Fossa) LTS 64-bit <http://releases.ubuntu.com/20.04/>`_
* `Debian 10 (Buster) LTS 64-bit <https://www.debian.org/distrib/>`_
* `Centos 7 64-bit <http://isoredirect.centos.org/centos/7/isos/x86_64/>`_
* `Centos 8 64-bit <http://isoredirect.centos.org/centos/8/isos/x86_64/>`_
* `openSUSE 15.X (experimental) 64-bit <https://software.opensuse.org/distributions/leap>`_
Configure at least one network interface to access the Internet or suitable
local repositories.
@ -107,29 +105,6 @@ Before you begin, we recommend upgrading your system packages and kernel.
deployments. Until that work is complete, deployers must maintain their
own firewall rulesets or disable the firewall entirely.
Configure openSUSE
~~~~~~~~~~~~~~~~~~
Install additional software packages and configure Network Time Protocol (NTP).
Before you begin, we recommend upgrading your system packages and kernel.
#. Upgrade the system packages and kernel
.. code-block:: shell-session
# zypper up
#. Reboot the host.
#. Install additional software packages if they were not installed
during the operating system installation:
.. parsed-literal::
# 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.
Configure SSH keys
==================

13
deploy-guide/source/overview-requirements.rst
View File

@ -20,23 +20,10 @@ following minimum requirements:
* CentOS
.. note::
CentOS 7 supports only source installs, installation of OpenStack
with distro packages is not supported.
* Centos 7, fully updated.
* Centos 8
* Linux kernel version ``3.10.0`` or later.
* openSUSE (support is experimental)
* Leap 15.X, fully updated.
* Linux kernel version ``4.4.X`` or later.
* Secure Shell (SSH) client and server that support public key
authentication

43
deploy-guide/source/targethosts-prepare.rst
View File

@ -16,7 +16,6 @@ target host:
* Debian 10 64-bit
* Centos 7 64-bit
* Centos 8 64-bit
* openSUSE 15.X 64-bit
Configure at least one network interface to access the Internet or
suitable local repositories.
@ -140,48 +139,6 @@ Configure CentOS
#. Reboot the host to activate the changes and use the new kernel.
Configure openSUSE
~~~~~~~~~~~~~~~~~~
#. Upgrade the system packages and kernel:
.. code-block:: shell-session
# zypper up
#. Reboot the host.
#. Ensure that the kernel version is ``4.4`` or later:
.. code-block:: shell-session
# uname -r
#. Install additional software packages:
.. code-block:: shell-session
# zypper install bridge-utils iputils lsof lvm2 \
chrony opensshr sudo tcpdump python3
#. Add the appropriate kernel modules to the ``/etc/modules-load.d`` file to
enable VLAN and bond interfaces:
.. code-block:: shell-session
# echo 'bonding' >> /etc/modules-load.d/openstack-ansible.conf
# echo '8021q' >> /etc/modules-load.d/openstack-ansible.conf
#. Configure Network Time Protocol (NTP) in ``/etc/chrony.conf`` to
synchronize with a suitable time source and start the service:
.. code-block:: shell-session
# systemctl enable chronyd.service
# systemctl start chronyd.service
#. Reboot the host to activate the changes and use the new kernel.
Configure SSH keys
==================

3
doc/source/contributor/periodic-work.rst
View File

@ -163,8 +163,7 @@ development team by performing one of the following recurring tasks:
* After official project release, before official OpenStack-Ansible release:
* Bump RDO, Ubuntu Cloud Archive and openSUSE OBS OpenStack Cloud
repositories if they are ready on time.
* Bump RDO and Ubuntu Cloud Archive repositories if they are ready on time.
* Immediately after official OpenStack-Ansible release:

22
doc/source/index.rst
View File

@ -9,11 +9,10 @@ configuration of an OpenStack environment.
Documentation for each of the following releases is available.
Ussuri: Maintained
~~~~~~~~~~~~~~~~~~~~~~~~~
Victoria: Under Development
~~~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack-Ansible Ussuri series was first released with the 21.0.0 tag on
14 August 2020.
OpenStack-Ansible Victoria is currently in development.
.. toctree::
:maxdepth: 1
@ -26,6 +25,21 @@ OpenStack-Ansible Ussuri series was first released with the 21.0.0 tag on
contributor/index
reference/index
Ussuri: Maintained
~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack-Ansible Ussuri series was first released with the 21.0.0 tag on
14 August 2020.
* `OpenStack-Ansible Ussuri Documentation`_
* `OpenStack-Ansible Ussuri series release notes`_
.. _OpenStack-Ansible Ussuri Documentation: https://docs.openstack.org/openstack-ansible/ussuri/
.. _OpenStack-Ansible Ussuri series release notes: https://docs.openstack.org/releasenotes/openstack-ansible/ussuri.html
Train: Maintained
~~~~~~~~~~~~~~~~~~~~~~~~

16
doc/source/user/aio/quickstart.rst
View File

@ -62,7 +62,7 @@ system packages are upgraded and then reboot into the new kernel:
.. code-block:: shell-session
## Ubuntu
## Ubuntu / Debian
# apt-get update
# apt-get dist-upgrade
# reboot
@ -70,8 +70,8 @@ system packages are upgraded and then reboot into the new kernel:
.. code-block:: shell-session
## CentOS
# yum upgrade
# yum install git
# dnf upgrade
# dnf install git-core
# systemctl stop firewalld
# systemctl mask firewalld
# reboot
@ -83,12 +83,6 @@ system packages are upgraded and then reboot into the new kernel:
SELinux enabled is not currently supported in OpenStack-Ansible
for CentOS/RHEL due to a lack of maintainers for the feature.
.. code-block:: shell-session
## openSUSE
# zypper up
# zypper in git-core
# reboot
.. note::
@ -129,9 +123,7 @@ version.
.. note::
The |current_release_formal_name| release is only compatible with
Debian 10 (buster), Ubuntu 18.04 (Bionic Beaver), Ubuntu 20.04
(Focal Fossa), CentOS 7 and CentOS 8. Experimentat support is
provided for openSUSE Leap 15.X but this is expected to be removed
in the next major release.
(Focal Fossa) and CentOS 8.
The next step is to bootstrap Ansible and the Ansible roles for the
development environment.