Add ability to change apt/yum package state

The current method of installing the distribution packages required is
set in the tasks and cannot be changed by a deployer.

Currently the apt task always installs the latest package. This results
in unexpected binary changes when a deployer may simply be trying to
execute a configuration change.

This patch adds the ability for a deployer to change the desired state
so that the results are predictable.

Change-Id: Ic570c4029b06918e223f21da02012f330911ad51

defaults/main.yml

@@ -13,6 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Set the package install state for distribution packages
+# Options are 'present' and 'latest'
+repo_build_package_state: "latest"
+
 # Use OpenStack's upper-constraints
 repo_build_use_upper_constraints: true
 

releasenotes/notes/package-state-55fceaf0cd23147e.yaml

@@ -0,0 +1,13 @@
+---
+features:
+  - The repo_build role now supports the ability to configure whether
+    apt/yum tasks install the latest available package, or just ensure
+    that the package is present. The default action is to ensure that
+    the latest package is present. The action taken may be changed to
+    only ensure that the package is present by setting
+    ``repo_build_package_state`` to ``present``.
+upgrade:
+  - The repo_build role always checks whether the latest package is
+    installed when executed. If a deployer wishes to change the check to
+    only validate the presence of the package, the option
+    ``repo_build_package_state`` should be set to ``present``.

tasks/install-apt.yml

@@ -16,7 +16,7 @@
 - name: Add Ubuntu Cloud Archive keyring
   apt:
     pkg: ubuntu-cloud-keyring
-    state: latest
+    state: "{{ repo_build_package_state }}"
   register: add_uca_keys
   when: repo_build_uca_enable | bool
 
@@ -58,7 +58,7 @@
 - name: Install apt packages
   apt:
     pkg: "{{ item }}"
-    state: present
+    state: "{{ repo_build_package_state }}"
   register: install_packages
   until: install_packages|success
   retries: 5

tasks/install-yum.yml

@@ -16,7 +16,7 @@
 - name: Install RDO package
   yum:
     pkg: "{{ repo_build_rdo_package }}"
-    state: present
+    state: "{{ repo_build_package_state }}"
   register: install_cloud_rdo_package
   until: install_cloud_rdo_package | success
   retries: 5
@@ -27,7 +27,7 @@
 - name: Install yum packages
   yum:
     pkg: "{{ item }}"
-    state: present
+    state: "{{ repo_build_package_state }}"
   register: install_packages
   until: install_packages | success
   retries: 5