Pieter
0c4d536246
feat: Add version tracking and maintenance monitoring (issue #15 )
...
Complete implementation of automatic version tracking and drift detection:
New Scripts:
- scripts/collect-client-versions.sh: Query deployed versions from Docker
- Connects via Ansible to running servers
- Extracts versions from container images
- Updates registry automatically
- scripts/check-client-versions.sh: Compare versions across clients
- Multiple formats: table (colorized), CSV, JSON
- Filter by outdated versions
- Highlights drift with color coding
- scripts/detect-version-drift.sh: Identify version differences
- Detects clients with outdated versions
- Threshold-based staleness detection (default 30 days)
- Actionable recommendations
- Exit code 1 if drift detected (CI/monitoring friendly)
Updated Scripts:
- scripts/deploy-client.sh: Auto-collect versions after deployment
- scripts/rebuild-client.sh: Auto-collect versions after rebuild
Documentation:
- docs/maintenance-tracking.md: Complete maintenance guide
- Version management workflows
- Security update procedures
- Monitoring integration examples
- Troubleshooting guide
Features:
✅ Automatic version collection from deployed servers
✅ Multi-client version comparison reports
✅ Version drift detection with recommendations
✅ Integration with deployment workflows
✅ Export to CSV/JSON for external tools
✅ Canary-first update workflow support
Usage Examples:
```bash
# Collect versions
./scripts/collect-client-versions.sh dev
# Compare all clients
./scripts/check-client-versions.sh
# Detect drift
./scripts/detect-version-drift.sh
# Export for monitoring
./scripts/check-client-versions.sh --format=json
```
Closes #15
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-17 20:53:15 +01:00
Pieter
bf4659f662
feat: Implement client registry system (issue #12 )
...
Add comprehensive client registry for tracking all deployed infrastructure:
Registry System:
- Single source of truth in clients/registry.yml
- Tracks status, server specs, versions, maintenance history
- Supports canary deployment workflow
- Automatic updates via deployment scripts
New Scripts:
- scripts/list-clients.sh: List/filter clients (table/json/csv/summary)
- scripts/client-status.sh: Detailed client info with health checks
- scripts/update-registry.sh: Manual registry updates
Updated Scripts:
- scripts/deploy-client.sh: Auto-updates registry on deploy
- scripts/rebuild-client.sh: Auto-updates registry on rebuild
- scripts/destroy-client.sh: Marks clients as destroyed
Documentation:
- docs/client-registry.md: Complete registry reference
- clients/README.md: Quick start guide
Status tracking: pending → deployed → maintenance → destroyed
Role support: canary (dev) and production clients
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-17 20:24:53 +01:00
Pieter
ac4187d041
feat: Automate SSH key and secrets generation in deployment scripts
...
Simplify client deployment workflow by automating SSH key generation and
secrets file creation. No more manual preparation steps!
## Changes
### Deploy Script Automation
**`scripts/deploy-client.sh`**:
- Auto-generates SSH key pair if missing (calls generate-client-keys.sh)
- Auto-creates secrets file from template if missing
- Opens SOPS editor for user to customize secrets
- Continues with deployment after setup complete
### Rebuild Script Automation
**`scripts/rebuild-client.sh`**:
- Same automation as deploy script
- Ensures SSH key and secrets exist before rebuild
### Documentation Updates
- **`README.md`** - Updated quick start workflow
- **`scripts/README.md`** - Updated script descriptions and examples
## Workflow: Before vs After
### Before (Manual)
```bash
# 1. Generate SSH key
./scripts/generate-client-keys.sh newclient
# 2. Create secrets file
cp secrets/clients/template.sops.yaml secrets/clients/newclient.sops.yaml
sops secrets/clients/newclient.sops.yaml
# 3. Add to terraform.tfvars
vim tofu/terraform.tfvars
# 4. Deploy
./scripts/deploy-client.sh newclient
```
### After (Automated)
```bash
# 1. Add to terraform.tfvars
vim tofu/terraform.tfvars
# 2. Deploy (everything else is automatic!)
./scripts/deploy-client.sh newclient
# Script automatically:
# - Generates SSH key if missing
# - Creates secrets file from template if missing
# - Opens editor for you to customize
# - Continues with deployment
```
## Benefits
✅ **Fewer manual steps**: 4 steps → 2 steps
✅ **Less error-prone**: Can't forget to generate SSH key
✅ **Better UX**: Script guides you through setup
✅ **Still flexible**: Can pre-create SSH key/secrets if desired
✅ **Idempotent**: Won't regenerate if already exists
## Backward Compatible
Existing workflows still work:
- If SSH key already exists, script uses it
- If secrets file already exists, script uses it
- Can still use generate-client-keys.sh manually if preferred
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-17 20:04:29 +01:00
Pieter
a5fe631717
feat: Complete Authentik SSO integration with automated OIDC setup
...
## Changes
### Identity Provider (Authentik)
- ✅ Deployed Authentik 2025.10.3 as identity provider
- ✅ Configured automatic bootstrap with admin account (akadmin)
- ✅ Fixed OIDC provider creation with correct redirect_uris format
- ✅ Added automated OAuth2/OIDC provider configuration for Nextcloud
- ✅ API-driven provider setup eliminates manual configuration
### Nextcloud Configuration
- ✅ Fixed reverse proxy header configuration (trusted_proxies)
- ✅ Added missing database indices (fs_storage_path_prefix)
- ✅ Ran mimetype migrations for proper file type handling
- ✅ Verified PHP upload limits (16GB upload_max_filesize)
- ✅ Configured OIDC integration with Authentik
- ✅ "Login with Authentik" button auto-configured
### Automation Scripts
- ✅ Added deploy-client.sh for automated client deployment
- ✅ Added rebuild-client.sh for infrastructure rebuild
- ✅ Added destroy-client.sh for cleanup
- ✅ Full deployment now takes ~10-15 minutes end-to-end
### Documentation
- ✅ Updated README with automated deployment instructions
- ✅ Added SSO automation workflow documentation
- ✅ Added automation status tracking
- ✅ Updated project reference with Authentik details
### Technical Fixes
- Fixed Authentik API redirect_uris format (requires list of dicts with matching_mode)
- Fixed Nextcloud OIDC command (user_oidc:provider not user_oidc:provider:add)
- Fixed file lookup in Ansible (changed to slurp for remote files)
- Updated Traefik to v3.6 for Docker API 1.44 compatibility
- Improved error handling in app installation tasks
## Security
- All credentials stored in SOPS-encrypted secrets
- Trusted proxy configuration prevents IP spoofing
- Bootstrap tokens auto-generated and secured
## Result
Fully automated SSO deployment - no manual configuration required!
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-08 16:56:19 +01:00
