From 0efcce2984b2567561bafa7bc0739fa99444113b Mon Sep 17 00:00:00 2001
From: Erich Blume <blume.erich@gmail.com>
Date: Wed, 11 Feb 2026 13:33:26 -0800
Subject: [PATCH] Purge Fly.io proxy cache after docs release (#154)

## Summary
- The Fly.io nginx proxy caches docs responses for 24h (`proxy_cache_valid 200 1d`)
- After a release, docs.eblu.me kept serving stale content until the cache expired
- This caused v1.5.4 to show v1.5.3 on the CHANGELOG page
- Adds `flyctl` install and `fly ssh console` cache purge steps to the build workflow, running after the ArgoCD deploy completes

## Test plan
- [ ] Next release should show the correct version on docs.eblu.me/CHANGELOG immediately
- [ ] Verify the `fly ssh console` command succeeds in the workflow logs

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/154
---
 .forgejo/workflows/build-blumeops.yaml              | 13 +++++++++++++
 .../fix-purge-fly-cache-on-release.bugfix.md        |  1 +
 2 files changed, 14 insertions(+)
 create mode 100644 docs/changelog.d/fix-purge-fly-cache-on-release.bugfix.md

diff --git a/.forgejo/workflows/build-blumeops.yaml b/.forgejo/workflows/build-blumeops.yaml
index 89f84f3..859174d 100644
--- a/.forgejo/workflows/build-blumeops.yaml
+++ b/.forgejo/workflows/build-blumeops.yaml
@@ -322,6 +322,19 @@ jobs:
 
           echo "Docs app synced successfully!"
 
+      - name: Install flyctl
+        run: |
+          curl -L https://fly.io/install.sh | sh
+          echo "/root/.fly/bin" >> "$GITHUB_PATH"
+
+      - name: Purge Fly.io proxy cache
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_DEPLOY_TOKEN }}
+        run: |
+          echo "Purging nginx cache on Fly.io proxy..."
+          fly ssh console -a blumeops-proxy -C "rm -rf /tmp/cache && nginx -s reload"
+          echo "Cache purged"
+
       - name: Summary
         run: |
           VERSION="${{ steps.version.outputs.version }}"
diff --git a/docs/changelog.d/fix-purge-fly-cache-on-release.bugfix.md b/docs/changelog.d/fix-purge-fly-cache-on-release.bugfix.md
new file mode 100644
index 0000000..289377b
--- /dev/null
+++ b/docs/changelog.d/fix-purge-fly-cache-on-release.bugfix.md
@@ -0,0 +1 @@
+Purge Fly.io proxy cache after docs deploy so new releases are served immediately.