Production Readiness-checklist andreaslop-site-hosting (test)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
+36
@@ -0,0 +1,36 @@
|
||||
# Production Readiness Checklist - andreaslop-site-hosting
|
||||
|
||||
Scope: the TEST environment `test.andreaslop.nl`. Production is out of scope; its open items are only listed at the end.
|
||||
|
||||
## Deployment
|
||||
- **Status**: Configured
|
||||
- **Method**: CI/CD (Gitea Actions) to the on-premises Pi, test only; switch `ASF_TEST_DEPLOY_ENABLED`
|
||||
- **Rollback Plan**: Yes (`operations/deployment/rollback-plan.md`: previous release kept, symlink + restart; saved proxy block; CI switch off). Not yet exercised on the Pi.
|
||||
|
||||
## Monitoring
|
||||
- **Status**: Configured (documented; alert rules not yet created)
|
||||
- **Approach**: Combination: journald + Sentry (website project, environment `test`) with alert rules and an uptime check; no new dashboards
|
||||
|
||||
## Additional Readiness Items
|
||||
- **Backups**: Database `AndreaSlopFotografieTest` must be in the Pi DB backup script (manual step 7, Pi-Main). Status to be confirmed by Pi-Main. The website files live on `/mnt/storage1` and are rebuilt from the website repo. Data Protection keys live in the database.
|
||||
- **Secrets Management**: Pass. Only in Gitea secrets (`PI_MAIN_*`) and the Pi file `shared/env` (mode 600); `Identity__Setup__Token` is removed after the first administrator exists; nothing secret is committed.
|
||||
- **Runbook/Support Handover**: Yes. `deployment-instructions.md`, `rollback-plan.md`, `manual-steps-for-bryan.md`, `monitoring-setup.md` are enough for someone other than the author.
|
||||
- **Alert Ownership**: Bryan receives Sentry e-mail alerts as project owner; fixing is owned by Bryan with the CMS & API and Pi-Main sessions. Rules are created after the first successful deploy.
|
||||
|
||||
## .NET Appsettings Compliance
|
||||
- **Three-file pattern present**: Yes for `Api.AndreaSlopFotografie` (`appsettings.json`, `appsettings.Development.json`, git-ignored optional `appsettings.local.json`, created locally with a placeholder only).
|
||||
- **No committed secrets**: Pass. `appsettings.json` holds placeholders (`<db-password>`, `<secure-long-random-secret-key-from-env>`), empty token, empty DSN. `appsettings.Development.json` holds the same development-only JWT secret the other clients use and a placeholder database password.
|
||||
- **`appsettings.local.json` gitignored**: Yes (`.gitignore` line `appsettings.local.json`).
|
||||
- **Production secrets wired to env vars/secrets manager**: Yes for the test host: `ConnectionStrings__DefaultConnection`, `JwtSettings__Secret`, `Identity__Setup__Token`, `Observability__SentryDsn` via `shared/env`. (Production uses the same mechanism later.)
|
||||
|
||||
## Overall Readiness
|
||||
- **Ready for Production**: Not applicable to production. For TEST: Yes with caveats (below).
|
||||
- **Open Follow-ups**:
|
||||
1. CI proof pending: Bryan starts `workflow_dispatch` on the branch (deploy boxes unticked); `backend-test` (MariaDB: `Api.Tests`, ASF `HostPipelineTests`), frontend and vulnerability scan must be green.
|
||||
2. First test deploy not done (needs the explicit go from CMS & API/Bryan; Pi preparation reported done, proxy route already switched, `ASF_TEST_DEPLOY_ENABLED` unset).
|
||||
3. After the first deploy: verification list (manual steps 14-18), forwarded-header observation, optional Pi timing, remove the setup token, report in the hand-back.
|
||||
4. Sentry alert rules to be created after the first successful deploy (by the CMS & API session, with Bryan's go).
|
||||
5. Backup entry for the test database to be confirmed (Pi-Main).
|
||||
6. Merging to master deploys the shared Core change and patched packages to SlpSoftware test automatically; watch that deploy.
|
||||
7. Doc-only commits are local and unpushed.
|
||||
8. Production for Andrea Slop Fotografie (not prepared, listed only): own database and user, port 5201, own proxy route and certificate, `Website__NoIndex=false`, own `shared/env`, production deploy path/variables and an approval decision, production Sentry environment and alert rules, backup entry, HSTS preload/redirect review, decision on the placeholder radius and dark mode.
|
||||
Reference in New Issue
Block a user