blumeops/docs/how-to
Erich Blume 22f418d0dc Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191)
## Summary

Review session covering 3 docs, plus a codebase-wide cleanup:

### Docs reviewed
- **connect-to-postgres** — verified end-to-end (psql connection tested), stamped
- **create-release-artifact-workflow** — clarified that `build-blumeops.yaml` is only a version bump example (not a packages API example)
- **deploy-k8s-service** — fixed stale repoURL (`indri:2200` → `forge.ops.eblu.me:2222`), wrong Caddy config keys (`upstream` → `backend`, added missing `host`), updated Homepage group to "Services", added Tailscale tag documentation

### Codebase cleanup
- Migrated all remaining `op item get --fields` calls to `op read` URI syntax across 7 files (docs, READMEs, YAML comments)
- Simplified the `op read` vs `op item get` guidance in CLAUDE.md

## Side findings (not addressed)
- New `immich-pg` CNPG cluster not yet documented in the postgresql reference card

## Test plan
- [x] `psql` connection to `pg.ops.eblu.me` verified
- [x] All pre-commit hooks pass
- [x] `docs-check-links`, `docs-check-index`, `docs-check-frontmatter` pass

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/191
2026-02-15 07:42:01 -08:00
..
knowledgebase Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
plans Deploy Frigate NVR stack with Mosquitto, Ntfy, and frigate-notify (#190) 2026-02-14 21:27:44 -08:00
add-ansible-role.md Review add-ansible-role doc (#185) 2026-02-13 16:54:42 -08:00
connect-to-postgres.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
create-release-artifact-workflow.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
deploy-k8s-service.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
expose-service-publicly.md Update CV release to v1.0.3, add X-Clacks-Overhead header (#176) 2026-02-12 17:08:22 -08:00
gandi-operations.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
how-to.md Abandon UniFi IaC, add manual network segmentation plan (#189) 2026-02-14 09:47:04 -08:00
manage-flyio-proxy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
restart-indri.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
restore-1password-backup.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
troubleshooting.md Doc review: connect-to-postgres, create-release-artifact-workflow, deploy-k8s-service (#191) 2026-02-15 07:42:01 -08:00
update-documentation.md Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178) 2026-02-12 19:18:46 -08:00
update-tailscale-acls.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00
use-pypi-proxy.md Fix frontmatter field name for Quartz date display (#158) 2026-02-11 16:45:12 -08:00