Skip to content

Document the internal GC endpoint and Cloud Scheduler setup#19

Merged
acoshift merged 1 commit into
mainfrom
docs/gc-cloud-scheduler
May 24, 2026
Merged

Document the internal GC endpoint and Cloud Scheduler setup#19
acoshift merged 1 commit into
mainfrom
docs/gc-cloud-scheduler

Conversation

@acoshift
Copy link
Copy Markdown
Member

Summary

  • Document POST /internal/gc in the README: what it deletes (files where expires_at < now() from both GCS and Postgres), its 204 response, that it's safe to re-run, and that nothing runs it on a timer inside the service.
  • Add internal_secret to the environment variable table — the bearer token guarding the endpoint (unauthenticated when unset).
  • Add a "Garbage collection" section with a gcloud scheduler jobs create http example that runs GC hourly, plus notes on --uri reachability (the route shares the public host, so it may only be reachable in-cluster depending on ingress), keeping --headers in sync with internal_secret on rotation, and a gcloud scheduler jobs run command to verify.

Docs-only change; no code touched.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@acoshift acoshift merged commit 0583848 into main May 24, 2026
2 checks passed
@acoshift acoshift deleted the docs/gc-cloud-scheduler branch May 24, 2026 06:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant