docs: make deployment SSL handling manual
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 14s
Deploy to Testnet / deploy-testnet (push) Successful in 1m41s
Multi-Node Stress Testing / stress-test (push) Successful in 3s
Node Failover Simulation / failover-test (push) Failing after 2s

This commit is contained in:
aitbc
2026-05-11 08:12:30 +02:00
parent e23fcddbde
commit eeed0c61a3

View File

@@ -56,7 +56,6 @@ This workflow covers the automation of AITBC service deployment with one-command
- Install Python dependencies - Install Python dependencies
- Configure environment variables - Configure environment variables
- Initialize databases - Initialize databases
- Generate SSL certificates
- Start systemd services - Start systemd services
- Run health checks - Run health checks
- Display deployment status - Display deployment status
@@ -122,26 +121,10 @@ This workflow covers the automation of AITBC service deployment with one-command
- Configure restart on health check failure - Configure restart on health check failure
- Use systemd notify for service readiness - Use systemd notify for service readiness
### 5. Automatic SSL Certificate Generation (Let's Encrypt) ### 5. Manual SSL Certificate Handling
1. **Install certbot** - SSL certificate provisioning and renewal are handled manually outside this workflow.
- Script: `scripts/deploy/install-certbot.sh` - Configure nginx with manually issued certificates as needed.
- Install certbot and certbot-auto
- Configure webroot authentication
- Set up auto-renewal cron job
2. **Create certificate generation script**
- Script: `scripts/deploy/generate-ssl.sh`
- Request certificate for domain
- Configure nginx with SSL certificates
- Set up certificate auto-renewal
- Handle certificate renewal hooks
3. **Configure nginx reverse proxy**
- SSL termination at nginx
- Redirect HTTP to HTTPS
- Configure modern TLS settings (TLS 1.3)
- Add security headers (HSTS, X-Frame-Options)
## Verification ## Verification
@@ -149,8 +132,7 @@ This workflow covers the automation of AITBC service deployment with one-command
- [ ] Deployment script completes successfully - [ ] Deployment script completes successfully
- [ ] .env.example template is complete - [ ] .env.example template is complete
- [ ] Health checks pass for all services - [ ] Health checks pass for all services
- [ ] SSL certificates are generated and renewed - [ ] SSL certificates are configured manually and services are accessible via HTTPS
- [ ] Services are accessible via HTTPS
- [ ] Rollback capability tested - [ ] Rollback capability tested
## Troubleshooting ## Troubleshooting
@@ -158,7 +140,7 @@ This workflow covers the automation of AITBC service deployment with one-command
- **Service fails to start**: Check logs with `journalctl -u service-name`, verify dependencies - **Service fails to start**: Check logs with `journalctl -u service-name`, verify dependencies
- **Deployment script fails**: Check error logs, verify prerequisites, test individual steps - **Deployment script fails**: Check error logs, verify prerequisites, test individual steps
- **Health checks fail**: Verify service is running, check endpoint configuration - **Health checks fail**: Verify service is running, check endpoint configuration
- **SSL certificate fails**: Check domain DNS, verify port 80 is open, check certbot logs - **SSL configuration fails**: Check domain DNS, verify nginx config, and confirm the manually issued certificate paths
- **Environment validation fails**: Verify all required variables are set, check formats - **Environment validation fails**: Verify all required variables are set, check formats
## Related Files ## Related Files
@@ -168,5 +150,4 @@ This workflow covers the automation of AITBC service deployment with one-command
- `.env.example` - `.env.example`
- `scripts/deploy/validate-env.sh` - `scripts/deploy/validate-env.sh`
- `scripts/monitoring/health-check.sh` - `scripts/monitoring/health-check.sh`
- `scripts/deploy/generate-ssl.sh`
- `nginx/nginx.conf` - `nginx/nginx.conf`