feat(ci): add PuppetCore gem source support to module_ci workflow

- Add ruby_version input parameter with default of '2.7'
- Add puppetcore_api_type input parameter with default of 'forge-key'
- Configure environment variables for Puppet Core authentication
- Update ruby-version in workflow to use the input parameter
- Add documentation on requirements for enabling PuppetCore

Signed-off-by: Gavin Didrichsen <[email protected]>

Author: gavindidrichsen

.github/workflows/module_ci.yml

@@ -19,7 +19,23 @@ on:
         required: false
         default: false
         type: "boolean"
+      ruby_version:
+        description: "Ruby version to use"
+        required: false
+        default: '2.7'
+        type: "string"
+      puppetcore_api_type:
+        description: "The type of API to use for Puppet Core."
+        required: false
+        default: 'forge-key'
+        type: "string"
 
+# ENABLE PUPPETCORE.  The calling workflow must:  
+# - Set a valid PUPPET_FORGE_TOKEN secret on its repository.
+# - Set ruby_version >= 3.1 to override this workflow's default 2.7; otherwise bundle install will fail.  
+env:
+  PUPPET_FORGE_TOKEN: ${{ secrets.PUPPET_FORGE_TOKEN }}
+  BUNDLE_RUBYGEMS___PUPPETCORE__PUPPET__COM: "${{ inputs.puppetcore_api_type }}:${{ secrets.PUPPET_FORGE_TOKEN }}"
 
 jobs:
   setup_matrix:
@@ -41,7 +57,7 @@ jobs:
       - name: "Setup ruby"
         uses: "ruby/setup-ruby@v1"
         with:
-          ruby-version: "2.7"
+          ruby-version: ${{ inputs.ruby_version }}
           bundler-cache: true
 
       - name: "Bundle environment"