Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -1,12 +1,9 @@
|
||||
# Self-Hosted Sentry — Operations Runbook
|
||||
|
||||
This runbook covers the **self-hosted Sentry deployment** that lives in
|
||||
`infra/sentry/`. It is the operational companion to
|
||||
`docs/improvement-plan/02-observability/sentry-selfhost-setup.md` (the
|
||||
planning artefact) and assumes you have current operator-approved SSH access to
|
||||
the `boilerplate-staging` host. The archived
|
||||
`docs/improvement-plan/archive/STAGING-ACCESS.md` file is historical inventory
|
||||
only; prefer live Coolify/Hetzner access records when they differ.
|
||||
`infra/sentry/`. It assumes you have current operator-approved SSH access to
|
||||
the target host. Prefer live Coolify/Hetzner access records over historical
|
||||
staging inventory.
|
||||
|
||||
For the lightweight alternative (GlitchTip, no Performance/Replay/OTLP), see
|
||||
[`sentry-glitchtip-alternative.md`](./sentry-glitchtip-alternative.md).
|
||||
@@ -33,7 +30,7 @@ For the lightweight alternative (GlitchTip, no Performance/Replay/OTLP), see
|
||||
|
||||
```bash
|
||||
cd /data/coolify/services/sentry
|
||||
git clone git@git.tool-ctrl.de:toolctrl-labs/boilerplate.git .
|
||||
git clone git@git.tool-ctrl.de:toolctrl-labs/HiveGrid-Cloud.git .
|
||||
cd infra/sentry
|
||||
cp .env.example .env
|
||||
# Edit .env — fill SENTRY_ADMIN_EMAIL, SENTRY_ADMIN_PASSWORD,
|
||||
@@ -69,18 +66,18 @@ For the lightweight alternative (GlitchTip, no Performance/Replay/OTLP), see
|
||||
```
|
||||
|
||||
5. **Create the three Sentry projects** in the Sentry UI:
|
||||
- `boilerplate-api`
|
||||
- `boilerplate-worker`
|
||||
- `boilerplate-web`
|
||||
- `hivegrid-api`
|
||||
- `hivegrid-worker`
|
||||
- `hivegrid-web`
|
||||
|
||||
Copy their DSNs into `infra/sentry/.env` (`SENTRY_DSN_API`,
|
||||
`SENTRY_DSN_WORKER`, `SENTRY_DSN_WEB`) and into the Coolify secret
|
||||
vault for the respective app containers. The five Coolify worker apps
|
||||
(`worker-general`, `worker-mail`, `worker-import`, `worker-webhook`,
|
||||
`worker-plugin`) intentionally share the server-side
|
||||
`boilerplate-worker` project and `SENTRY_DSN_WORKER` unless the operator
|
||||
`hivegrid-worker` project and `SENTRY_DSN_WORKER` unless the operator
|
||||
explicitly creates per-group Sentry projects later. Per-project
|
||||
allowed-domains list is filled in for the `boilerplate-web` project only
|
||||
allowed-domains list is filled in for the `hivegrid-web` project only
|
||||
(API + Worker DSNs are server-side, no browser exposure).
|
||||
|
||||
6. **Enable 2FA** on the admin account immediately (User Settings →
|
||||
@@ -254,11 +251,11 @@ a one-time operator pass plus a quarterly review.
|
||||
at 100 events/sec. Verify by sending a burst and watching for
|
||||
`429` responses.
|
||||
- [ ] **Per-project allowed-domains list filled.** Project Settings →
|
||||
Client Keys → Allowed Domains. Set for `boilerplate-web` to:
|
||||
Client Keys → Allowed Domains. Set for `hivegrid-web` to:
|
||||
`https://boiler.saas-ctrl.com`,
|
||||
`https://www.boiler.saas-ctrl.com`,
|
||||
`https://admin.boiler.saas-ctrl.com`. Leave **empty** for the
|
||||
`boilerplate-api` and `boilerplate-worker` projects (server-side
|
||||
`hivegrid-api` and `hivegrid-worker` projects (server-side
|
||||
DSNs only).
|
||||
- [ ] **Postgres / ClickHouse / Kafka / Redis NOT public.**
|
||||
`docker-compose.override.yml` uses `ports: !reset []` to strip
|
||||
@@ -278,9 +275,8 @@ a one-time operator pass plus a quarterly review.
|
||||
backups. Copy from Coolify vault to a hardware-backed password
|
||||
manager (1Password, BitWarden Premium with TOTP, YubiKey-backed
|
||||
pass).
|
||||
- [ ] **Traefik dashboard port 8080 firewalled.** See
|
||||
`docs/improvement-plan/archive/STAGING-ACCESS.md` open item; close at Hetzner Cloud Firewall
|
||||
level or front it with basic-auth.
|
||||
- [ ] **Traefik dashboard port 8080 firewalled.** Close at Hetzner Cloud
|
||||
Firewall level or front it with basic-auth.
|
||||
- [ ] **`.env` permissions ≤ 0600.** `ls -l infra/sentry/.env`. The
|
||||
installer enforces 0600 when it copies the file into the upstream
|
||||
tree.
|
||||
@@ -336,7 +332,7 @@ none`.
|
||||
|
||||
### 3. Store secrets in Gitea Actions
|
||||
|
||||
In Gitea (`git.tool-ctrl.de/toolctrl-labs/boilerplate`) open
|
||||
In Gitea (`git.tool-ctrl.de/toolctrl-labs/HiveGrid-Cloud`) open
|
||||
**Repository Settings → Actions → Secrets** and create the same three
|
||||
secrets (`SENTRY_AUTH_TOKEN`, `SENTRY_ORG`, `SENTRY_URL`) with
|
||||
identical values. Gitea's secret scoping rules mirror GitHub's, so the
|
||||
@@ -379,7 +375,7 @@ SENTRY_AUTH_TOKEN=<token> \
|
||||
SENTRY_ORG=sentry \
|
||||
SENTRY_URL=https://sentry.boiler.saas-ctrl.com \
|
||||
bash scripts/ci/sentry-release.sh \
|
||||
--project boilerplate-api \
|
||||
--project hivegrid-api \
|
||||
--environment preview \
|
||||
--release "$(git rev-parse HEAD)" \
|
||||
--sourcemaps none
|
||||
|
||||
Reference in new issue
Block a user