Add deployment options

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,69 @@
+## Fixes
+
+What bugs does this fix? Use the syntax to auto-close the issue:
+
+https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword
+
+E.g.: "Fixes: #XYZ"
+
+
+## Summary
+
+What does this fix, how did you fix it, what approach did you take, what gotchas are there in your code or compromises did you make?
+
+
+## Deployment
+
+<details>
+<summary>Instructions</summary>
+
+---
+
+The following labels control the deployment of this PR if they’re applied. Please choose which should be applied, then apply them to this PR:
+
+| Label                 | Description                             | Use case                                                                                                                         |
+| --------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `skip-deploy`         | The entire deployment can be skipped.   | This might be the case for a small fix, a tweak to documentation or something like that.                                         |
+| `skip-web-deploy`     | The web tier can be skipped.            | This is the case if you're working on code that doesn't affect the front end, like management commands, tasks, or documentation. |
+| `skip-celery-deploy`  | Deployment to celery can be skipped.    | This is the case if you make no changes to tasks.py or the code that tasks rely on.                                              |
+| `skip-cronjob-deploy` | Deployment to cron jobs can be skipped. | This is the case if no changes are made that affect cronjobs.                                                                    |
+
+**If deployment is required:**
+
+- What extra steps are needed to deploy this beyond the standard deploy?
+- Do scripts need to be run or things like that?
+- If this is more than a quick thing, a new issue should be created in our infra repo: https://github.com/freelawproject/infrastructure/issues/new (if you don’t have access to it, just put the steps here)
+
+---
+
+</details>
+
+**This PR should:**
+
+- [ ] <code>skip-deploy</code>
+- [ ] <code>skip-web-deploy</code>
+- [ ] <code>skip-celery-deploy</code>
+- [ ] <code>skip-cronjob-deploy</code>
+
+Extra steps to deploy this PR:
+1. Run script....
+
+
+## Screenshots
+
+If this changes the front end, please include desktop and mobile screenshots or videos showing the new feature.
+
+<details>
+<summary>Desktop</summary>
+
+YOUR IMAGE(S) HERE
+
+</details>
+
+
+<details>
+<summary>Mobile</summary>
+
+YOUR IMAGE(S) HERE
+
+</details>

.github/workflows/docker-build.yml

@@ -11,8 +11,49 @@ env:
   EKS_NAMESPACE: court-listener
 
 jobs:
+  get-pr-labels:
+    runs-on: ubuntu-latest
+    outputs:
+      labels: ${{ steps.find_pr.outputs.labels }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: Find merged PR by merge_commit_sha
+        id: find_pr
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const commitSha = context.sha;
+            const { data: prs } = await github.rest.pulls.list({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: "closed",
+              sort: "updated",
+              direction: "desc",
+              per_page: 1
+            });
+
+            const pr = prs.find(p => p.merge_commit_sha === commitSha);
+            if (!pr) {
+              core.setOutput("labels", "");
+              core.warning("No merged PR found for this commit.");
+              return;
+            }
+
+            const labels = pr.labels.map(l => l.name);
+            core.setOutput("labels", labels.join(","));
+            console.log(`PR #${pr.number} labels: ${labels.join(", ")}`);
+
   build:
+    needs: get-pr-labels
     runs-on: ubuntu-latest
+    if: >
+      ${{
+        !contains(needs.get-pr-labels.outputs.labels, 'skip-deploy') &&
+        !contains(needs.get-pr-labels.outputs.labels, 'skip-web-deploy') &&
+        !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') &&
+        !contains(needs.get-pr-labels.outputs.labels, 'skip-cronjob-deploy')
+      }}
     steps:
       - uses: actions/checkout@v4
       - name: Login to Docker Hub
@@ -25,8 +66,9 @@ jobs:
           make push-image --file docker/django/Makefile -e VERSION=$(git rev-parse --short HEAD)
 
   deploy:
-    needs: build
+    needs: [get-pr-labels, build]
     runs-on: ubuntu-latest
+    if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-deploy') }}
     concurrency: production
     steps:
       - uses: actions/checkout@v4
@@ -91,24 +133,34 @@ jobs:
           exit 1
       - name: Delete Temporary Pod
         run: kubectl delete pod -n ${{ env.EKS_NAMESPACE }} temp-pod-${{ steps.vars.outputs.sha_short }}
+
       # Rollout new versions one by one (watch "deployments" in k9s)
       - name: Rollout cl-python
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-web-deploy') }}
         run: kubectl set image -n ${{ env.EKS_NAMESPACE }} deployment/cl-python web=freelawproject/courtlistener:${{ steps.vars.outputs.sha_short }}-prod
       - name: Watch cl-python rollout status
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-web-deploy') }}
         run: kubectl rollout status -n ${{ env.EKS_NAMESPACE }} deployment/cl-python
+
       - name: Rollout cl-celery-prefork
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl set image -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork cl-celery-prefork=freelawproject/courtlistener:${{ steps.vars.outputs.sha_short }}-prod
       - name: Watch cl-celery-prefork rollout status
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl rollout status -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork
 
       - name: Rollout cl-celery-prefork-bulk
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl set image -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork-bulk cl-celery-prefork-bulk=freelawproject/courtlistener:${{ steps.vars.outputs.sha_short }}-prod
       - name: Watch cl-celery-prefork-bulk rollout status
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl rollout status -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork-bulk
 
       - name: Rollout cl-celery-prefork-es-sweep
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl set image -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork-es-sweep cl-celery-prefork-es-sweep=freelawproject/courtlistener:${{ steps.vars.outputs.sha_short }}-prod
       - name: Watch cl-celery-prefork-es-sweep rollout status
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-celery-deploy') }}
         run: kubectl rollout status -n ${{ env.EKS_NAMESPACE }} deployment/cl-celery-prefork-es-sweep
 
       - name: Rollout cl-scrape-rss
@@ -136,9 +188,9 @@ jobs:
       - name: Watch cl-iquery-probe rollout status
         run: kubectl rollout status -n ${{ env.EKS_NAMESPACE }} deployment/cl-iquery-probe
 
-
       # Watch "cronjobs" in k9s
       - name: Update cronjobs
+        if: ${{ !contains(needs.get-pr-labels.outputs.labels, 'skip-cronjob-deploy') }}
         run: |
           CRONJOB_NAMES=$(kubectl get cronjobs -n court-listener -o jsonpath='{.items.*.metadata.name}' -l image_type=web-prod);
           for name in $CRONJOB_NAMES; do