godwinsystems/rb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: switch fetch commands to rb.godwinsystems.com

Browse Source 
The ops -> godwinsystems org move would have made every hand-typed onsite
command 10 characters longer, against the whole reason filenames here are
short. A redirect host makes them shorter than they ever were:

  irm https://gitea.ivangodwin.com/ops/rb/raw/branch/main/od-smb-cred.md
  irm rb.godwinsystems.com/od-smb-cred.md

Flips all 6 hardcoded URLs and documents what the hostname is, where the
route is defined, and that removing it means updating these commands in
the same change.

Verified before committing: the short and canonical URLs return
byte-identical content for 5 files, the scheme-less http:// form resolves
through 301 -> 302 -> 200, bare / lands on the repo page, and a missing
file still 404s at the right path.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HwcG1jLs1T425QRMxtjxP7
This commit is contained in:
Ivan Godwin
2026-09-02 16:06:08 -07:00
parent b2d2a42a9a
commit 6589082317
5 changed files with 26 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+22 -2
View File
@@ -17,19 +17,39 @@ client workstations during on-site work with short, hand-typeable commands.
Fetch and read on the target workstation:
```powershell
irm https://gitea.ivangodwin.com/ops/rb/raw/branch/main/<file> | more
irm rb.godwinsystems.com/<file> | more
```
Run an executable runbook script directly (scripts live under `scripts/`):
```powershell
irm https://gitea.ivangodwin.com/ops/rb/raw/branch/main/scripts/<file>.ps1 | iex
irm rb.godwinsystems.com/scripts/<file>.ps1 | iex
```
Scripts prompt for anything client-specific via `Read-Host` — nothing to edit
before running. See [`scripts/_template.ps1`](scripts/_template.ps1) for the
convention.
No scheme is needed: PowerShell defaults a scheme-less URI to `http://`, and
`rb.godwinsystems.com` answers on :80 with a 301 to HTTPS.
### About that hostname
`rb.godwinsystems.com` is a 302 redirect to this repo's raw path on Gitea. It
exists because these commands are hand-typed on client machines, often
mid-incident — the canonical URL is 63 characters before the filename. The
canonical form still works and is what the redirect targets:
```
https://gitea.ivangodwin.com/godwinsystems/rb/raw/branch/main/<file>
```
The redirect is a backendless Gateway API `HTTPRoute` defined in
`kubernetes-gitops` at `manifests/apps/rb-redirect/`, with a listener on the
public gateway and a DNS-only A record for `rb`. **If that route is ever
removed, update the commands above in the same change** — otherwise every
runbook here documents a dead URL.
## Layout & naming
- **Runbooks** (`.md`) live flat at the repo root with short, hand-typeable