Record reuse.coulomb.social DNS; add deploy runbook; close T03

This commit is contained in:
2026-06-15 09:45:17 +02:00
parent 25d6a2484e
commit 37a5c2f690
2 changed files with 78 additions and 4 deletions

View 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`.

View File

@@ -26,6 +26,11 @@ per-machine `sources.yaml` maintenance.
Gitea repo: `coulomb/reuse-surface` Gitea repo: `coulomb/reuse-surface`
OCI image: `gitea.coulomb.social/coulomb/reuse-surface:<tag>` 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 dependency
| Upstream | Workplan | Required artifact | | Upstream | Workplan | Required artifact |
@@ -80,7 +85,7 @@ Makefile `reuse-*` targets.
```task ```task
id: RAILIANCE-WP-0007-T03 id: RAILIANCE-WP-0007-T03
status: todo status: done
priority: medium priority: medium
state_hub_task_id: "80dc308a-3c0f-4027-9b40-67df5f17aca7" 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` - `cert-manager.io/cluster-issuer: letsencrypt-prod`
- Traefik annotations matching `inter-hub` - 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 ## Deploy Release To railiance01
@@ -113,12 +118,13 @@ When image is available:
```task ```task
id: RAILIANCE-WP-0007-T05 id: RAILIANCE-WP-0007-T05
status: todo status: progress
priority: low priority: low
state_hub_task_id: "30b08789-38bb-409a-b5b1-b3c73ff31a96" 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 ```bash
export REUSE_SURFACE_URL=https://reuse.coulomb.social export REUSE_SURFACE_URL=https://reuse.coulomb.social