Update to allow specifying PR to deploy

Author: justin808

.github/readme.md

@@ -0,0 +1,85 @@
+# Developing and Testing Github Actions
+
+Testing Github Actions on an existing repository is tricky.
+                                                                               
+The main issue boils down to the fact that Github Actions uses the workflow files in the branch where the event originates. This is fine for push events, but it becomes a problem when you want to test workflows that are triggered by comments on a pull request.
+
+Here's a summary of the behavior:
+  
+Behavior of push and pull_request Events
+	1.	Push on a Branch:
+	•	When you push changes to a branch (e.g., feature-branch), GitHub Actions uses the workflow files in that same branch.
+	•	This is why changes to workflows work seamlessly when testing with push events.
+	2.	Pull Request Events:
+	•	For pull_request events (e.g., a PR from feature-branch into master), GitHub Actions will always use the workflow files from the target branch (e.g., master), not the source branch (e.g., feature-branch).
+	•	This is a security feature to prevent someone from introducing malicious code in a PR that modifies the workflow files themselves.
+
+Impact on Comment-Triggered Workflows
+
+When you want to trigger workflows via comments (issue_comment) in a pull request:
+	•	The workflow code used will always come from the master branch (or the default branch), regardless of the branch where the PR originates.
+	•	This means the PR’s changes to the workflow won’t be used, and the action invoked by the comment will also use code from master.
+
+Workarounds to Test Comment-Triggered Workflows
+
+If you want to test workflows in a way that uses the changes in the pull request, here are your options:
+
+1. Use Push Events for Testing
+	•	Test your changes on a branch with push triggers.
+	•	Use workflow_dispatch to simulate the events you need (like invoking actions via comments).
+
+This allows you to confirm that your changes to the workflow file or actions behave as expected before merging into master.
+
+2. Merge the Workflow to master Temporarily
+
+If you absolutely need the workflow to run as part of a pull_request event:
+	1.	Merge your workflow changes into master temporarily.
+	2.	Open a PR to test your comment-triggered workflows.
+	3.	Revert the changes in master if necessary.
+
+This ensures the workflow changes are active in master while still testing with the pull_request context.
+
+3. Add Logic to Detect the Source Branch
+
+Use github.event.pull_request.head.ref to add custom logic in your workflow that behaves differently based on the source branch.
+	•	Example:
+
+jobs:
+  test-pr:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.pull_request.head.ref == 'feature-branch' }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Debug
+        run: echo "Testing workflow changes in feature-branch"
+
+However, this still requires the workflow itself to exist in master.
+
+4. Use a Fork or a Temporary Repo
+
+Create a temporary repository or a fork to test workflows in isolation:
+	•	Push your workflow changes to master in the test repository.
+	•	Open a PR in the fork to test how workflows behave with issue_comment events and PR contexts.
+
+Once confirmed, you can replicate the changes in your main repository.
+
+6. Alternative Approach: Split Workflows
+
+If your workflow includes comment-based triggers (issue_comment), consider splitting your workflows:
+	•	A base workflow in master that handles triggering.
+	•	A test-specific workflow for validating changes on a branch.
+
+For example:
+	1.	The base workflow triggers when a comment like /run-tests is added.
+	2.	The test-specific workflow runs in response to the base workflow but uses the branch’s code.
+
+Summary
+	•	For push events: The branch-specific workflow is used, so testing changes is easy.
+	•	For pull_request and issue_comment events: GitHub always uses workflows from the master branch, and there’s no direct way to bypass this.
+
+To test comment-triggered workflows:
+	1.	Use push or workflow_dispatch to validate changes.
+	2.	Merge workflow changes temporarily into master to test with pull_request events.
+	3.	Use tools like act for local simulation.

.github/workflows/deploy-to-control-plane.yml

@@ -1,28 +1,35 @@
 name: Deploy Review App to Control Plane
 
-run-name: ${{ github.event_name == 'issue_comment' && 'Deploying Review App' || format('Updating Review App for {0}', github.ref_name) }}
+run-name: ${{ github.event_name == 'workflow_dispatch' && format('Deploying Review App for PR #{0}', github.event.inputs.pr_number) || github.event_name == 'issue_comment' && 'Deploying Review App' || format('Updating Review App for {0}', github.ref_name) }}
 
 on:
   pull_request:
     types: [opened, synchronize, reopened]
   issue_comment:
     types: [created]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: 'Pull Request number to deploy'
+        required: true
+        type: number
 
 # Use concurrency to cancel in-progress runs
 concurrency:
-  group: deploy-pr-${{ github.event.pull_request.number || github.event.issue.number }}
+  group: deploy-pr-${{ github.event.pull_request.number || github.event.issue.number || github.event.inputs.pr_number }}
   cancel-in-progress: true
 
 env:
-  APP_NAME: qa-react-webpack-rails-tutorial-pr-${{ github.event.pull_request.number || github.event.issue.number }}
+  APP_NAME: qa-react-webpack-rails-tutorial-pr-${{ github.event.pull_request.number || github.event.issue.number || github.event.inputs.pr_number }}
   CPLN_TOKEN: ${{ secrets.CPLN_TOKEN_STAGING }}
   CPLN_ORG: ${{ vars.CPLN_ORG_STAGING }}
-  PR_NUMBER: ${{ github.event.pull_request.number || github.event.issue.number }}
+  PR_NUMBER: ${{ github.event.pull_request.number || github.event.issue.number || github.event.inputs.pr_number }}
 
 jobs:
   Process-Deployment-Command:
     if: |
       (github.event_name == 'pull_request') ||
+      (github.event_name == 'workflow_dispatch') ||
       (github.event_name == 'issue_comment' && 
        github.event.issue.pull_request && 
        github.event.comment.body == '/deploy-review-app')
@@ -34,6 +41,17 @@ jobs:
       issues: write
 
     steps:
+      - name: Get PR HEAD Ref
+        if: github.event_name == 'issue_comment' || github.event_name == 'workflow_dispatch'
+        id: getRef
+        run: |
+          echo "PR_NUMBER=${{ github.event.issue.number || github.event.inputs.pr_number }}" >> $GITHUB_ENV
+          echo "APP_NAME=qa-react-webpack-rails-tutorial-pr-${{ github.event.issue.number || github.event.inputs.pr_number }}" >> $GITHUB_ENV
+          # Get the PR head commit
+          PR_DATA=$(gh pr view ${{ github.event.issue.number || github.event.inputs.pr_number }} --repo ${{ github.repository }} --json headRefName,headRefOid)
+          echo "PR_REF=$(echo $PR_DATA | jq -r .headRefName)" >> $GITHUB_OUTPUT
+          echo "PR_SHA=$(echo $PR_DATA | jq -r .headRefOid)" >> $GITHUB_ENV
+
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
@@ -45,18 +63,6 @@ jobs:
           token: ${{ env.CPLN_TOKEN }}
           org: ${{ env.CPLN_ORG }}
 
-      - name: Get PR HEAD Ref
-        if: github.event_name == 'issue_comment'
-        run: |
-          echo "PR_NUMBER=${{ github.event.issue.number }}" >> $GITHUB_ENV
-          echo "APP_NAME=qa-react-webpack-rails-tutorial-pr-${{ github.event.issue.number }}" >> $GITHUB_ENV
-          # For PR comments, get the actual PR head commit
-          PR_DATA=$(gh pr view $PR_NUMBER --repo ${{ github.repository }} --json headRefName,headRefOid)
-          echo "PR_REF=$(echo "$PR_DATA" | jq -r '.headRefName')" >> $GITHUB_OUTPUT
-          echo "PR_SHA=$(echo "$PR_DATA" | jq -r '.headRefOid')" >> $GITHUB_OUTPUT
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
       - name: Check if Review App Exists
         id: check-app
         if: github.event_name == 'push'