(tasks,gha) Implement version parameter for install task

Setting openvox_bootstrap::install version will install that version
of the openvox-agent. Does not test for mismatch between collection and
version major.

Author: jpartlow

.github/workflows/pr_testing.yaml

@@ -72,4 +72,31 @@ jobs:
           PT_yum_source: "https://yum.overlookinfratech.com"
         run: ./openvox_bootstrap/tasks/install_linux.sh
       - name: Verify openvox-agent is installed
-        run: /opt/puppetlabs/bin/puppet --version | grep -E '[0-9]+\.[0-9]+'
+        run: /opt/puppetlabs/bin/puppet --version | grep -E '8\.[0-9]+'
+
+  test-install-version:
+    strategy:
+      matrix:
+        image:
+          - rockylinux:9
+          - debian:12
+          # Need to pull in the repo GPG keys for sles
+          #          - registry.suse.com/suse/sle15:15.6
+    needs: shellcheck
+    runs-on: ubuntu-latest
+    container: ${{ matrix.image }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: openvox_bootstrap
+      - id: prep
+        uses: ./openvox_bootstrap/.github/actions/container_task_prep
+      - name: Run openvox-agent install task manually
+        env:
+          PT__installdir: ${{ github.workspace }}
+          PT_version: "8.14.0"
+          PT_apt_source: "https://apt.overlookinfratech.com"
+          PT_yum_source: "https://yum.overlookinfratech.com"
+        run: ./openvox_bootstrap/tasks/install_linux.sh
+      - name: Verify openvox-agent is installed
+        run: /opt/puppetlabs/bin/puppet --version | grep '8.14.0'

files/common.sh

@@ -166,21 +166,36 @@ install_package_file() {
   esac
 }
 
-# TODO add support for the version parameter.
+# Install a package using the system package manager.
 install_package() {
   local _package="$1"
-
-  info "Installing ${_package}"
+  local _version="$2"
+
+  info "Installing ${_package} ${_version}"
+
+  local _package_and_version
+  if [[ -n "${_version}" ]]; then
+    case $family in
+      debian|ubuntu)
+        _package_and_version="${_package}=${_version}"
+        ;;
+      *)
+        _package_and_version="${_package}-${_version}"
+        ;;
+    esac
+  else
+    _package_and_version="${_package}"
+  fi
   if exists 'dnf'; then
-    exec_and_capture dnf install -y "$_package"
+    exec_and_capture dnf install -y "$_package_and_version"
   elif exists 'yum'; then
-    exec_and_capture yum install -y "$_package"
+    exec_and_capture yum install -y "$_package_and_version"
   elif exists 'zypper'; then
-    exec_and_capture zypper install -y "$_package"
+    exec_and_capture zypper install -y "$_package_and_version"
   elif exists 'apt'; then
-    exec_and_capture apt install -y "$_package"
+    exec_and_capture apt install -y "$_package_and_version"
   elif exists 'apt-get'; then
-    exec_and_capture apt-get install -y "$_package"
+    exec_and_capture apt-get install -y "$_package_and_version"
   else
     fail "Unable to install ${_package}. Neither dnf, yum, zypper, apt nor apt-get are installed."
   fi

tasks/install.json

@@ -2,7 +2,7 @@
   "description": "Installs the openvox-agent package.",
   "parameters": {
     "version": {
-      "description": "TODO The version of the openvox-agent package to install. Defaults to latest.",
+      "description": "The version of the openvox-agent package to install. Defaults to latest.",
       "type": "Optional[String]"
     },
     "collection": {

tasks/install_linux.sh

@@ -6,6 +6,8 @@ set -e
 # shellcheck disable=SC2154
 installdir=$PT__installdir
 # shellcheck disable=SC2154
+version=${PT_version:-'latest'}
+# shellcheck disable=SC2154
 collection=${PT_collection:-'openvox8'}
 # shellcheck disable=SC2154
 yum_source=${PT_yum_source:-'https://yum.overlookinfratech.com'}
@@ -82,4 +84,4 @@ download "${package_url}" "${local_release_package}"
 # packages from the collection using the platform package manager.
 install_release_package "${local_release_package}" "${package_type}"
 # Use the platform package manager to install openvox-agent
-install_package 'openvox-agent'
+install_package 'openvox-agent' "${version}"