Merge "Document and test maximum supported version of Ansible" into stable/train

doc/source/user/quickstart.rst

@@ -93,11 +93,11 @@ If not installing Kolla Ansible in a virtual environment, skip this section.
       pip install -U pip
 
 #. Install `Ansible <http://www.ansible.com>`__. Currently, Kolla Ansible
-   requires Ansible 2.6+.
+   requires Ansible 2.6 to 2.9.
 
    .. code-block:: console
 
-      pip install ansible
+      pip install 'ansible<2.10'
 
 Install dependencies not using a virtual environment
 ----------------------------------------------------
@@ -125,7 +125,7 @@ If installing Kolla Ansible in a virtual environment, skip this section.
       sudo pip install -U pip
 
 #. Install `Ansible <http://www.ansible.com>`__. Currently, Kolla Ansible
-   requires Ansible 2.6+.
+   requires Ansible 2.6 to 2.9.
 
    For CentOS or RHEL, run:
 
@@ -139,6 +139,13 @@ If installing Kolla Ansible in a virtual environment, skip this section.
 
       sudo apt-get install ansible
 
+#. If the version of Ansible provided by the distribution does not meet the
+   above version requirements, install it via pip.
+
+   .. code-block:: console
+
+      sudo pip install 'ansible<2.10'
+
 Install Kolla-ansible
 ~~~~~~~~~~~~~~~~~~~~~
 

tests/run.yml

@@ -170,7 +170,7 @@
         ansible_version_latest: >-
           {{ base_distro == 'ubuntu' or
              (base_distro == 'centos' and groups['all'] | map('extract', hostvars, 'ansible_distribution_major_version') | map('int') | list | max == 8) }}
-        ansible_version_constraint: "{{ '>=2.6' if ansible_version_latest else '<2.7' }}"
+        ansible_version_constraint: "{{ '<2.10' if ansible_version_latest else '<2.7' }}"
       pip:
         name:
           - "{{ kolla_ansible_src_dir }}"