Created detailed documentation covering: - Authentication and SSO login flow - Adding new applications (Git and UI methods) - Repository credential rotation procedure - Emergency recovery procedures (with critical safety warnings) - Self-management architecture - Monitoring, maintenance, and troubleshooting - Backup and disaster recovery Updated README.md with Argo CD section and links to docs. Updated docs/README.md to index the new Argo CD documentation. Co-Authored-By: Paperclip <noreply@paperclip.ing>
20 lines
1,011 B
Markdown
20 lines
1,011 B
Markdown
# Documentation
|
|
|
|
This directory contains general documentation for the basicstack.de cluster and deployment processes.
|
|
|
|
## Available Documentation
|
|
|
|
- **[Argo CD - GitOps Platform](argocd.md)**: Comprehensive guide to the Argo CD deployment, including SSO login, managing applications, repository credential rotation, emergency recovery, and troubleshooting
|
|
|
|
## Suggested Future Content
|
|
|
|
- **Architecture**: Overall cluster architecture and design decisions
|
|
- **Deployment Guides**: Step-by-step deployment procedures for specific scenarios
|
|
- **Troubleshooting**: Common cluster-wide issues and solutions
|
|
- **Best Practices**: Standards and conventions for this cluster
|
|
- **Operations Runbooks**: Incident response and operational procedures
|
|
- **Disaster Recovery**: Backup and restore procedures at the cluster level
|
|
|
|
## Note
|
|
|
|
Application-specific documentation should live in the respective `apps/<app-name>/` directories, not here. This directory is for cross-cutting concerns and cluster-wide documentation.
|