feat(workflow): add job to install PE with legacy compilers

- Renamed job `install` to `convert_compiler` for clarity.
- Added new job `install` to install PE with legacy compilers.
- Included steps to start SSH session, checkout source, activate Ruby 2.7, provision test cluster, set up yq, create params.json file, install PE, wait for SSH debugging, and tear down test cluster.

Author: CoMfUcIoS

.github/workflows/test-upgrade-legacy.yaml renamed to .github/workflows/test-convert-to-legacy.yaml

@@ -1,5 +1,5 @@
 ---
-name: Convert 1 compiler to legacy
+name: Convert compiler to legacy
 on:
   pull_request:
     paths:
@@ -31,8 +31,8 @@ on:
         required: true
         default: 'false'
 jobs:
-  install:
-    name: Install and convert compilers to legacy
+  convert_compiler:
+    name: Convert compilers to legacy
     runs-on: ubuntu-20.04
     env:
       BOLT_GEM: true
@@ -159,3 +159,107 @@ jobs:
               cat request.json || true; echo
             echo ::endgroup::
           fi
+  install:
+    name: Install PE with legacy compilers
+    runs-on: ubuntu-20.04
+    env:
+      BOLT_GEM: true
+      BOLT_DISABLE_ANALYTICS: true
+      LANG: en_US.UTF-8
+    steps:
+      - name: Start SSH session
+        if: ${{ github.event.inputs.ssh-debugging == 'true' }}
+        uses: luchihoratiu/debug-via-ssh@main
+        with:
+          NGROK_AUTH_TOKEN: ${{ secrets.NGROK_AUTH_TOKEN }}
+          SSH_PASS: ${{ secrets.SSH_PASS }}
+      - name: Checkout Source
+        uses: actions/checkout@v2
+      - name: Activate Ruby 2.7
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '2.7'
+          bundler-cache: true
+      - name: Print bundle environment
+        if: ${{ github.repository_owner == 'puppetlabs' }}
+        run: |
+          echo ::group::info:bundler
+            bundle env
+          echo ::endgroup::
+      - name: Provision test cluster
+        timeout-minutes: 15
+        run: |
+          echo ::group::prepare
+            mkdir -p $HOME/.ssh
+            echo 'Host *'                      >  $HOME/.ssh/config
+            echo '    ServerAliveInterval 150' >> $HOME/.ssh/config
+            echo '    ServerAliveCountMax 2'   >> $HOME/.ssh/config
+            bundle exec rake spec_prep
+          echo ::endgroup::
+          echo ::group::provision
+            bundle exec bolt plan run peadm_spec::provision_test_cluster \
+              --modulepath spec/fixtures/modules \
+              provider=provision_service \
+              image=almalinux-cloud/almalinux-8 \
+              architecture=large-with-dr
+          echo ::endgroup::
+          echo ::group::certnames
+            bundle exec bolt plan run peadm_spec::add_inventory_hostnames \
+            --inventory spec/fixtures/litmus_inventory.yaml \
+            --modulepath spec/fixtures/modules \
+            --no-host-key-check \
+            inventory_file=spec/fixtures/litmus_inventory.yaml
+          echo ::endgroup::
+          echo ::group::info:request
+            cat request.json || true; echo
+          echo ::endgroup::
+          echo ::group::info:inventory
+            sed -e 's/password: .*/password: "[redacted]"/' < spec/fixtures/litmus_inventory.yaml || true
+          echo ::endgroup::
+      - name: Set up yq
+        uses: frenck/action-setup-yq@v1
+        with:
+          version: v4.30.5
+      - name: Create the params.json file
+        run: |
+          primary=$(yq '.groups[].targets[] | select(.vars.role == "primary") | .name' spec/fixtures/litmus_inventory.yaml)
+          compiler=$(yq '.groups[].targets[] | select(.vars.role == "compiler") | .name' spec/fixtures/litmus_inventory.yaml | head -n 1)
+          legacy_compiler=$(yq '.groups[].targets[] | select(.vars.role == "compiler") | .name' spec/fixtures/litmus_inventory.yaml | head -n 2)
+          jq -n --arg primary_host "$primary" \
+            --argjson legacy_compilers '[$legacy_compiler]' \
+            --argjson compiler_hosts '[$compiler]' \
+            --arg version "2023.8.0" \
+            --arg console_password "${{ secrets.CONSOLE_PASSWORD }}" \
+            '{primary_host: $primary_host, legacy_compilers: $legacy_compilers, compiler_hosts: $compiler_hosts, version: $version, console_password: $console_password}' > params.json
+      - name: Install PE with legacy compilers
+        timeout-minutes: 120
+        run: |
+          echo ::group::params.json
+            cat params.json
+          echo ::endgroup::
+          echo ::group::install
+          bundle exec bolt plan run peadm::install \
+            --inventoryfile spec/fixtures/litmus_inventory.yaml \
+            --modulepath spec/fixtures/modules \
+            @params.json
+          echo ::endgroup::
+      - name: Wait as long as the file ${HOME}/pause file is present
+        if: ${{ always() && github.event.inputs.ssh-debugging == 'true' }}
+        run: |
+          while [ -f "${HOME}/pause" ] ; do
+            echo "${HOME}/pause present, sleeping for 60 seconds..."
+            sleep 60
+          done 
+          echo "${HOME}/pause absent, continuing workflow."
+      - name: Tear down test cluster
+        if: ${{ always() }}
+        continue-on-error: true
+        run: |-
+          if [ -f spec/fixtures/litmus_inventory.yaml ]; then
+            echo ::group::tear_down
+              bundle exec rake 'litmus:tear_down'
+            echo ::endgroup::
+            echo ::group::info:request
+              cat request.json || true; echo
+            echo ::endgroup::
+          fi