Record reuse.coulomb.social DNS; add deploy runbook; close T03
This commit is contained in:
68
docs/reuse-surface-on-railiance01.md
Normal file
68
docs/reuse-surface-on-railiance01.md
Normal file
@@ -0,0 +1,68 @@
|
||||
# reuse-surface on railiance01
|
||||
|
||||
Federation service deployment for **`https://reuse.coulomb.social`**.
|
||||
|
||||
Companion workplans: **RAILIANCE-WP-0007** (Helm release), **REUSE-WP-0011**
|
||||
(service + CLI).
|
||||
|
||||
## DNS
|
||||
|
||||
| Record | Value | Status |
|
||||
|---|---|---|
|
||||
| `reuse.coulomb.social` A | `92.205.62.239` | Operator confirmed 2026-06-15 |
|
||||
|
||||
Verify before deploy (propagation may lag):
|
||||
|
||||
```bash
|
||||
dig +short reuse.coulomb.social A
|
||||
```
|
||||
|
||||
Ingress host in chart: `charts/reuse-surface/values.yaml` → `ingress.host`.
|
||||
|
||||
## Release surface
|
||||
|
||||
| Item | Value |
|
||||
|---|---|
|
||||
| Namespace | `reuse` |
|
||||
| Helm release | `reuse` |
|
||||
| Chart | `charts/reuse-surface` |
|
||||
| Values | `helm/reuse-surface-values.yaml` |
|
||||
| Image | `gitea.coulomb.social/coulomb/reuse-surface:<tag>` |
|
||||
| Secret | `reuse-surface-env` (`REUSE_SURFACE_TOKEN`) |
|
||||
|
||||
## Deploy
|
||||
|
||||
```bash
|
||||
# 1. Pin image tag in helm/reuse-surface-values.yaml
|
||||
# 2. Create secret (example — use SOPS handoff in production)
|
||||
kubectl create namespace reuse --dry-run=client -o yaml | kubectl apply -f -
|
||||
kubectl create secret generic reuse-surface-env \
|
||||
--namespace reuse \
|
||||
--from-literal=REUSE_SURFACE_TOKEN='<token>' \
|
||||
--dry-run=client -o yaml | kubectl apply -f -
|
||||
|
||||
make reuse-dry-run
|
||||
make reuse-deploy
|
||||
make reuse-status
|
||||
```
|
||||
|
||||
## Smoke checks
|
||||
|
||||
```bash
|
||||
curl -fsS https://reuse.coulomb.social/health
|
||||
|
||||
export REUSE_SURFACE_URL=https://reuse.coulomb.social
|
||||
export REUSE_SURFACE_TOKEN=<token>
|
||||
reuse-surface hub status
|
||||
reuse-surface hub list
|
||||
```
|
||||
|
||||
## Operations
|
||||
|
||||
```bash
|
||||
make reuse-logs
|
||||
make reuse-status
|
||||
```
|
||||
|
||||
Image promotion: build from `coulomb/reuse-surface`, push to Gitea OCI, update
|
||||
`helm/reuse-surface-values.yaml` `image.tag`, `make reuse-deploy`.
|
||||
@@ -26,6 +26,11 @@ per-machine `sources.yaml` maintenance.
|
||||
Gitea repo: `coulomb/reuse-surface`
|
||||
OCI image: `gitea.coulomb.social/coulomb/reuse-surface:<tag>`
|
||||
|
||||
## DNS evidence
|
||||
|
||||
`reuse.coulomb.social` A → **`92.205.62.239`** (operator confirmed 2026-06-15).
|
||||
Ingress host configured in `charts/reuse-surface/values.yaml`.
|
||||
|
||||
## Upstream dependency
|
||||
|
||||
| Upstream | Workplan | Required artifact |
|
||||
@@ -80,7 +85,7 @@ Makefile `reuse-*` targets.
|
||||
|
||||
```task
|
||||
id: RAILIANCE-WP-0007-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "80dc308a-3c0f-4027-9b40-67df5f17aca7"
|
||||
```
|
||||
@@ -91,7 +96,7 @@ Ingress enabled in chart values:
|
||||
- `cert-manager.io/cluster-issuer: letsencrypt-prod`
|
||||
- Traefik annotations matching `inter-hub`
|
||||
|
||||
Confirm DNS A record in `coulomb.social` zone.
|
||||
DNS A record live: `reuse.coulomb.social → 92.205.62.239`.
|
||||
|
||||
## Deploy Release To railiance01
|
||||
|
||||
@@ -113,12 +118,13 @@ When image is available:
|
||||
|
||||
```task
|
||||
id: RAILIANCE-WP-0007-T05
|
||||
status: todo
|
||||
status: progress
|
||||
priority: low
|
||||
state_hub_task_id: "30b08789-38bb-409a-b5b1-b3c73ff31a96"
|
||||
```
|
||||
|
||||
Add `docs/reuse-surface-on-railiance01.md` with smoke checks:
|
||||
Added `docs/reuse-surface-on-railiance01.md`. Complete after first deploy with
|
||||
live smoke checks:
|
||||
|
||||
```bash
|
||||
export REUSE_SURFACE_URL=https://reuse.coulomb.social
|
||||
|
||||
Reference in New Issue
Block a user