Initial commit: a0_software_orchestrator v1.0
- Auto-Registration-Bug behoben (register_project/get_project_id/resolve_project Trennung) - 25 Tests gruen (Pytest) - block_compactor-Tool refactored (Option B: Soft-Check statt Hard-Block) - 4 Restbaustellen gefixt - DB-Schema: plugin_settings-Tabelle hinzugefuegt - 3 Schattenprojekte aus DB geloescht - Plan v3 + Refactor-Plan + Worklog dokumentiert
This commit is contained in:
@@ -0,0 +1,39 @@
|
||||
---
|
||||
name: deployment-basics
|
||||
description: Deployment documentation, environment setup, runbook, and rollback basics.
|
||||
tags: ['operations', 'deployment']
|
||||
---
|
||||
|
||||
# Deployment Basics
|
||||
|
||||
## Purpose
|
||||
Standardize deployment operations: environment documentation, runbook creation, rollback procedures.
|
||||
|
||||
## When to Use
|
||||
- Before any production deployment
|
||||
- When setting up a new environment
|
||||
- After a release for handoff
|
||||
- When rollback is needed
|
||||
|
||||
## Procedure: Environment Setup
|
||||
1. Document required variable names from safe sources only (`.env.example`, docs, schemas, compose placeholders, Coolify redacted status). Do not read live `.env`, runtime env dumps, credential stores, shell history, or logs to discover secret values.
|
||||
2. Document required system dependencies
|
||||
3. Document required network access (ports, domains)
|
||||
4. Create env.example file with placeholders
|
||||
|
||||
## Procedure: Runbook
|
||||
1. Pre-deploy: verify env, run tests, backup current state
|
||||
2. Deploy: step-by-step commands with expected output
|
||||
3. Post-deploy: health check, optional public reachability test, bounded error-log review
|
||||
4. Rollback: revert steps, restore backup, verify
|
||||
|
||||
## Procedure: Rollback
|
||||
1. Identify the last known good state
|
||||
2. Revert code (git checkout <tag>)
|
||||
3. Restore database (if schema changed)
|
||||
4. Verify health and public reachability tests; skip authenticated tests unless user-provided test account exists for this task
|
||||
5. Document rollback reason in worklog
|
||||
|
||||
## See Also
|
||||
- Tool: `deployment_runner` (if available in plugin)
|
||||
- Help: `operations/runtime.md`
|
||||
Reference in New Issue
Block a user