lab/authz-bridge
1
0
Fork 0
Code Issues 9 Pull requests 6 Projects Releases Packages Wiki Activity Actions 12

docs: portable-cluster deploy runbook for agents #50

Open
ginjiruu wants to merge 0 commits from docs/deploy-runbook into master
pull from: docs/deploy-runbook
merge into: lab:master
Conversation 0 Commits - Files changed -
ginjiruu commented 2026-09-16 12:59:33 +00:00
Owner
Copy link

Adds a deploy runbook so future agents know how to build, deploy, and
verify the bridge live on the portable cluster.

  • docs/agents/deploy.md: task deploy/task logs, the httpbin-auth
    endpoint + routing, how to temporarily raise verbosity to see the V(1)
    flow lines (and revert), the request-ID logging recipe, and the gotcha
    that gateway headers arrive in the ext_authz CheckRequest (not gRPC
    metadata).
  • AGENTS.md: a "Deploying to the portable cluster" section and a
    pointed-at reference to the runbook.

Docs only; no code changes.

Adds a deploy runbook so future agents know how to build, deploy, and verify the bridge live on the `portable` cluster. - `docs/agents/deploy.md`: `task deploy`/`task logs`, the `httpbin-auth` endpoint + routing, how to temporarily raise verbosity to see the `V(1)` flow lines (and revert), the request-ID logging recipe, and the gotcha that gateway headers arrive in the ext_authz CheckRequest (not gRPC metadata). - `AGENTS.md`: a "Deploying to the portable cluster" section and a pointed-at reference to the runbook. Docs only; no code changes.
docs: add portable-cluster deploy runbook for agents
Some checks failed
Lint / Run on Ubuntu (pull_request) Has been cancelled
Details
Tests / Run on Ubuntu (pull_request) Has been cancelled
Details
E2E Tests / Run on Ubuntu (pull_request) Has been cancelled
Details
00bedefeac 
Add docs/agents/deploy.md (task deploy/logs, the httpbin-auth endpoint,
how to temporarily raise verbosity to see V(1) flow lines, and the
CheckRequest-headers gotcha) and point AGENTS.md at it.
Some checks failed
Lint / Run on Ubuntu (pull_request) Has been cancelled
Details
Tests / Run on Ubuntu (pull_request) Has been cancelled
Details
E2E Tests / Run on Ubuntu (pull_request) Has been cancelled
Details
This pull request is broken due to missing fork information.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin docs/deploy-runbook:docs/deploy-runbook
git switch docs/deploy-runbook

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch master
git merge --no-ff docs/deploy-runbook
git switch docs/deploy-runbook
git rebase master
git switch master
git merge --ff-only docs/deploy-runbook
git switch docs/deploy-runbook
git rebase master
git switch master
git merge --no-ff docs/deploy-runbook
git switch master
git merge --squash docs/deploy-runbook
git switch master
git merge --ff-only docs/deploy-runbook
git switch master
git merge docs/deploy-runbook
git push origin master
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
needs-info

   
needs-triage

   
ready-for-agent

   
ready-for-human

   
wontfix
No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lab/authz-bridge!50
No description provided.