Manual environment creation again, more notification states

The magic environment creation doesn't work with forks because the ref
at Netlify is the name of the ref on the fork. It's not possible to call
a workflow_dispatch on a PR ref, so the environment needs to be manually
created.

Also subscribe to deploy preview started, failed and succeeded events,
not just succeeded.

Author: cmbuckley

.github/workflows/deploy-preview.yml

@@ -1,33 +1,73 @@
-name: Netlify deploy-preview success
+name: Netlify deploy-preview
 on:
   workflow_dispatch:
     inputs:
       issue:
         description: Issue number
+        required: true
+        type: number
+      status:
+        description: Deployment status
+        required: true
+        type: choice
+        options:
+          - in_progress
+          - failure
+          - success
       log:
         description: Netlify log URL
+        required: true
+        type: string
 
 jobs:
   notify:
     name: Notify about deployment
     runs-on: ubuntu-latest
-    environment:
-      name: staging-${{ github.event.inputs.issue }}
-      url: ${{ steps.get-url.outputs.url }}
-
     steps:
-      - name: Get deployment URL
-        id: get-url
+      - name: Create deployment
+        id: deployment
+        env:
+          GH_REPO: ${{ github.repository }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN_MANAGE_ENVS }}
         run: |
-          echo "url=https://staging-${{ github.event.inputs.issue }}.cmbuckley.co.uk" >> $GITHUB_OUTPUT
+          ref=$(gh pr view ${{ github.event.inputs.issue }} --json headRefOid -q .headRefOid)
+          env=staging-${{ github.event.inputs.issue }}
+          url=https://$env.cmbuckley.co.uk
+          echo "url=$url" >> $GITHUB_OUTPUT
+
+          # create environment, deployment and success status
+          gh api -X PUT repos/{owner}/{repo}/environments/$env
+          deployment=$(gh api repos/{owner}/{repo}/deployments \
+            -f ref=$ref \
+            -f environment=$env \
+            -F required_contexts[]=netlify/{owner}/deploy-preview -q .id)
+          gh api -X POST repos/{owner}/{repo}/deployments/$deployment/statuses \
+            -f state=success \
+            -f environment_url=$url
+
+      - name: Get comment text
+        id: get-text
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const status = github.events.inputs.status,
+              data = {
+                in_progress: ['👷', 'in progress', false],
+                failure:     ['❌', 'failed', false],
+                success:     ['✅', 'ready', true],
+              };
+
+            core.setOutput('emoji', data[status][0]);
+            core.setOutput('title', data[status][1]);
+            core.setOutput('preview', data[status][2]);
 
       - name: Find Comment
-        uses: peter-evans/find-comment@v3
         id: find-comment
+        uses: peter-evans/find-comment@v3
         with:
           issue-number: ${{ github.event.inputs.issue }}
           comment-author: 'github-actions[bot]'
-          body-includes: Deploy Preview ready
+          body-includes: Deploy Preview
 
       - name: Create comment
         uses: peter-evans/create-or-update-comment@v4
@@ -36,9 +76,9 @@ jobs:
           comment-id: ${{ steps.find-comment.outputs.comment-id }}
           edit-mode: replace
           body: |
-            ### <span aria-hidden="true">✅</span> Deploy Preview ready!
+            ### <span aria-hidden="true">${{ steps.get-text.outputs.emoji }}</span> Deploy Preview ${{ steps.get-text.outputs.title }}!
 
-            |      Name      | Link                             |
-            |----------------|----------------------------------|
-            | Deploy Preview | ${{ steps.get-url.outputs.url }} |
-            | Deploy Log     | ${{ github.event.inputs.log }}   |
+            |      Name      | Link |
+            |----------------|------|
+            ${{ steps.get-text.outputs.preview && format('| Deploy Preview | {0} |\n', steps.deployment.outputs.url) || ''}}
+            | Deploy Log     | ${{ github.event.inputs.log }} |

_cf/netlify-deployment-status/index.js

@@ -88,14 +88,14 @@ async function handleRequest(request) {
   if (!payload) { return error("Must POST JSON") }
   console.log('Payload:', payload)
 
-  if (payload.context == "deploy-preview" && payload.state == "ready") {
+  if (payload.context == "deploy-preview") {
     const apiUrl = (payload.review_url || "")
       .replace('//github.com', '//api.github.com/repos')
       .replace(/pull\/\d+$/, '');
     let workflowDispatch;
 
     if (!payload.review_id) { return error("Missing PR number") }
-    console.log(`Dispatching to ${apiUrl} with issue ${payload.review_id}`);
+    console.log(`Dispatching to ${apiUrl} with issue ${payload.review_id} and status ${payload.state}`);
 
     try {
       workflowDispatch = await fetch(apiUrl + 'actions/workflows/deploy-preview.yml/dispatches', {
@@ -107,9 +107,10 @@ async function handleRequest(request) {
           "Content-Type": "application/json",
         },
         body: JSON.stringify({
-          ref: `pull/${payload.review_id}/head`,
+          ref: 'main',
           inputs: {
             issue: payload.review_id.toString(),
+            status: {building: 'in_progress', ready: 'success', error: 'failure'}[payload.state],
             log: `${payload.admin_url}/deploys/${payload.id}`,
           }
         })