deploy-to-control-plane-review-app.yml

name: Deploy PR Review App to Control Plane

run-name: Deploy PR Review App - PR #${{ github.event.pull_request.number || github.event.issue.number || github.event.inputs.pr_number }}

# Controls when the workflow will run
on:
  pull_request:
    types: [synchronize, reopened]
  issue_comment:
    types: [created]
  workflow_dispatch:
    inputs:
      pr_number:
        description: 'Pull Request number to deploy'
        required: true
        type: number

env:
  PREFIX: ${{ vars.REVIEW_APP_PREFIX }}
  APP_NAME: ${{ vars.REVIEW_APP_PREFIX }}-${{ 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 || github.event.inputs.pr_number }}

jobs:
  deploy:
    if: |
      (github.event_name == 'pull_request') ||
      (github.event_name == 'workflow_dispatch') ||
      (github.event_name == 'issue_comment' && 
       github.event.issue.pull_request && 
       contains(github.event.comment.body, '/deploy-review-app'))
    runs-on: ubuntu-latest
    steps:
      - name: Initial Checkout
        uses: actions/checkout@v4

      - name: Get PR HEAD Ref
        id: getRef
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          # Get PR number based on event type
          case "${{ github.event_name }}" in
            "workflow_dispatch")
              PR_NUMBER="${{ github.event.inputs.pr_number }}"
              ;;
            "issue_comment")
              PR_NUMBER="${{ github.event.issue.number }}"
              ;;
            "pull_request")
              PR_NUMBER="${{ github.event.pull_request.number }}"
              ;;
            *)
              echo "Error: Unsupported event type ${{ github.event_name }}"
              exit 1
              ;;
          esac

          if [[ -z "$PR_NUMBER" ]]; then
            echo "Error: Could not determine PR number"
            echo "Event type: ${{ github.event_name }}"
            echo "Event action: ${{ github.event.action }}"
            echo "Ref name: ${{ github.ref_name }}"
            echo "Available event data:"
            echo "- PR number from inputs: ${{ github.event.inputs.pr_number }}"
            echo "- PR number from issue: ${{ github.event.issue.number }}"
            echo "- PR number from pull_request: ${{ github.event.pull_request.number }}"
            exit 1
          fi
          
          # Get PR data
          if [[ -z "$PR_DATA" ]]; then
            PR_DATA=$(gh pr view "$PR_NUMBER" --json headRefName,headRefOid)
            if [[ -z "$PR_DATA" ]]; then
              echo "Error: PR DATA for PR #$PR_NUMBER not found"
              echo "Event type: ${{ github.event_name }}"
              echo "Event action: ${{ github.event.action }}"
              echo "Ref name: ${{ github.ref_name }}"
              echo "Attempted to fetch PR data with: gh pr view $PR_NUMBER"
              exit 1
            fi
          fi
          
          # Extract and set PR data
          echo "PR_NUMBER=$PR_NUMBER" >> $GITHUB_ENV
          echo "APP_NAME=${{ vars.REVIEW_APP_PREFIX }}-$PR_NUMBER" >> $GITHUB_ENV
          echo "PR_REF=$(echo $PR_DATA | jq -r .headRefName)" >> $GITHUB_OUTPUT
          echo "PR_SHA=$(echo $PR_DATA | jq -r .headRefOid)" >> $GITHUB_ENV

      - name: Checkout the correct ref
        uses: actions/checkout@v4
        with:
          ref: ${{ env.PR_SHA }}

      - name: Setup Environment
        uses: ./.github/actions/setup-environment
        with:
          token: ${{ secrets.CPLN_TOKEN_STAGING }}
          org: ${{ vars.CPLN_ORG_STAGING }}

      - name: Check if Review App Exists
        id: check-app
        env:
          CPLN_TOKEN: ${{ secrets.CPLN_TOKEN_STAGING }}
        run: |
          # First check if cpflow exists
          if ! command -v cpflow &> /dev/null; then
            echo "Error: cpflow command not found"
            exit 1
          fi

          # Check if app exists and save state
          if ! cpflow exists -a ${{ env.APP_NAME }}; then
            if [[ "${{ github.event_name }}" == "pull_request" ]]; then
              echo "Canceling job as review app has not been previously deployed."
            fi
            echo "APP_EXISTS=false" >> $GITHUB_ENV
          else
            echo "APP_EXISTS=true" >> $GITHUB_ENV
          fi

      - name: Setup Control Plane App if Not Existing
        if: env.APP_EXISTS == 'false' && github.event_name != 'pull_request'
        env:
          CPLN_TOKEN: ${{ secrets.CPLN_TOKEN_STAGING }}
        run: |
          echo "🔧 Setting up new Control Plane app..."
          cpflow setup-app -a ${{ env.APP_NAME }} --org ${{ vars.CPLN_ORG_STAGING }}
          echo "APP_EXISTS=true" >> $GITHUB_ENV

      - name: Create Initial Comment
        if: env.APP_EXISTS == 'true'
        uses: actions/github-script@v7
        id: create-comment
        with:
          script: |
            const result = await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: process.env.PR_NUMBER,
              body: '🚀 Starting deployment process...\n\n'
            });
            core.setOutput('comment-id', result.data.id);

      - name: Set Deployment URLs
        if: env.APP_EXISTS == 'true'
        id: set-urls
        uses: actions/github-script@v7
        with:
          script: |
            // Set workflow URL for logs
            const getWorkflowUrl = async (runId) => {
              const { data: run } = await github.rest.actions.getWorkflowRun({
                owner: context.repo.owner,
                repo: context.repo.repo,
                run_id: runId
              });
              
              // Get the job ID for this specific job
              const { data: jobs } = await github.rest.actions.listJobsForWorkflowRun({
                owner: context.repo.owner,
                repo: context.repo.repo,
                run_id: runId
              });
              
              const currentJob = jobs.jobs.find(job => job.name === context.job);
              return `${run.html_url}/job/${currentJob.id}`;
            };
            
            const workflowUrl = await getWorkflowUrl(context.runId);
            core.exportVariable('WORKFLOW_URL', workflowUrl);
            core.exportVariable('CONSOLE_LINK', 
              '🎮 [Control Plane Console](' + 
              'https://console.cpln.io/console/org/' + process.env.CPLN_ORG + '/gvc/' + process.env.APP_NAME + '/-info)'
            );

      - name: Initialize GitHub Deployment
        if: env.APP_EXISTS == 'true'
        uses: actions/github-script@v7
        id: init-deployment
        with:
          script: |
            const ref = process.env.PR_SHA;
            const environment = process.env.ENVIRONMENT_NAME || 'review-app';
            
            const deployment = await github.rest.repos.createDeployment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              ref: ref,
              environment: environment,
              auto_merge: false,
              required_contexts: [],
              description: `Deployment for PR #${process.env.PR_NUMBER}`
            });
            
            // Create initial deployment status
            await github.rest.repos.createDeploymentStatus({
              owner: context.repo.owner,
              repo: context.repo.repo,
              deployment_id: deployment.data.id,
              state: 'in_progress',
              description: 'Deployment started'
            });
            
            return deployment.data.id;

      - name: Update Status - Building
        if: env.APP_EXISTS == 'true'
        uses: actions/github-script@v7
        with:
          script: |
            const buildingMessage = [
              '🏗️ Building Docker image for PR #${{ env.PR_NUMBER }}, commit ${{ env.PR_SHA }}',
              '',
              '📝 [View Build Logs](${{ env.WORKFLOW_URL }})',
              '',
              process.env.CONSOLE_LINK
            ].join('\n');
            
            await github.rest.issues.updateComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              comment_id: ${{ steps.create-comment.outputs.comment-id }},
              body: buildingMessage
            });

      - name: Build Docker Image
        if: env.APP_EXISTS == 'true'
        id: build
        uses: ./.github/actions/build-docker-image
        with:
          app_name: ${{ env.APP_NAME }}
          org: ${{ vars.CPLN_ORG_STAGING }}
          commit: ${{ env.PR_SHA }}
          PR_NUMBER: ${{ env.PR_NUMBER }}

      - name: Update Status - Deploying
        if: env.APP_EXISTS == 'true'
        uses: actions/github-script@v7
        with:
          script: |
            const deployingMessage = [
              '🚀 Deploying to Control Plane...',
              '',
              '⏳ Waiting for deployment to be ready...',
              '',
              '📝 [View Deploy Logs](${{ env.WORKFLOW_URL }})',
              '',
              process.env.CONSOLE_LINK
            ].join('\n');
            
            await github.rest.issues.updateComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              comment_id: ${{ steps.create-comment.outputs.comment-id }},
              body: deployingMessage
            });

      - name: Deploy to Control Plane
        if: env.APP_EXISTS == 'true'
        run: cpflow deploy-image -a ${{ env.APP_NAME }} --run-release-phase --org ${{ vars.CPLN_ORG_STAGING }} --verbose

      - name: Retrieve App URL
        if: env.APP_EXISTS == 'true'
        id: workload
        run: echo "WORKLOAD_URL=$(cpln workload get rails --gvc ${{ env.APP_NAME }} | tee | grep -oP 'https://[^[:space:]]*\.cpln\.app(?=\s|$)' | head -n1)"  >> "$GITHUB_OUTPUT"

      - name: Update Status - Deployment Complete
        if: env.APP_EXISTS == 'true'
        uses: actions/github-script@v7
        with:
          script: |
            const prNumber = process.env.PR_NUMBER;
            const appUrl = '${{ steps.workload.outputs.WORKLOAD_URL }}';
            const workflowUrl = process.env.WORKFLOW_URL;
            const isSuccess = '${{ job.status }}' === 'success';
            
            const consoleLink = process.env.CONSOLE_LINK;
            
            // Create GitHub deployment status
            const deploymentStatus = {
              owner: context.repo.owner,
              repo: context.repo.repo,
              deployment_id: ${{ steps.init-deployment.outputs.result }},
              state: isSuccess ? 'success' : 'failure',
              environment_url: isSuccess ? appUrl : undefined,
              log_url: workflowUrl,
              environment: 'review'
            };
            
            await github.rest.repos.createDeploymentStatus(deploymentStatus);
            
            // Define messages based on deployment status
            const successMessage = [
              '✅ Deployment complete for PR #' + prNumber + ', commit ' + '${{ env.PR_SHA }}',
              '',
              '🚀 [Review App for PR #' + prNumber + '](' + appUrl + ')',
              consoleLink,
              '',
              '📋 [View Completed Action Build and Deploy Logs](' + workflowUrl + ')'
            ].join('\n');
            
            const failureMessage = [
              '❌ Deployment failed for PR #' + prNumber + ', commit ' + '${{ env.PR_SHA }}',
              '',
              consoleLink,
              '',
              '📋 [View Deployment Logs with Errors](' + workflowUrl + ')'
            ].join('\n');
            
            // Update the existing comment
            await github.rest.issues.updateComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              comment_id: ${{ steps.create-comment.outputs.comment-id }},
              body: isSuccess ? successMessage : failureMessage
            });