116 lines
2.8 KiB
Markdown
116 lines
2.8 KiB
Markdown
|
# Production Deployment Checklist
|
||
|
|
|
||
|
|
## Before Going Live
|
||
|
|
|
||
|
|
### 1. Environment Configuration
|
||
|
|
|
||
|
|
- [ ] Copy `.env.example` to `.env` on the Pi
|
||
|
|
- [ ] Set a strong `ADMIN_PASSWORD` in `.env`
|
||
|
|
- [ ] Generate and set `SESSION_SECRET` in `.env`:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# On the Pi, generate a secure random key:
|
||
|
|
openssl rand -hex 32
|
||
|
|
# Copy the output and add to .env as SESSION_SECRET
|
||
|
|
```
|
||
|
|
|
||
|
|
### 2. Security
|
||
|
|
|
||
|
|
- [ ] Ensure `.env` is in `.gitignore` (already done)
|
||
|
|
- [ ] Never commit `.env` file to git
|
||
|
|
- [ ] Change default admin password from example
|
||
|
|
|
||
|
|
### 3. Hardware Setup
|
||
|
|
|
||
|
|
- [ ] Thermal printer connected via GPIO (Yellow to Pin 8, GND to Pin 6)
|
||
|
|
- [ ] External 9V power supply for printer
|
||
|
|
- [ ] Verify printer works: `echo -e "\x1B\x40Test\n\n\n" > /dev/serial0`
|
||
|
|
- [ ] Serial port enabled: `ls -la /dev/serial0` should point to ttyAMA0
|
||
|
|
|
||
|
|
### 4. Service Configuration
|
||
|
|
|
||
|
|
- [ ] Run `./setup_service.sh` to enable autostart
|
||
|
|
- [ ] Verify service is running: `sudo systemctl status autokanban`
|
||
|
|
- [ ] Test autostart by rebooting: `sudo reboot`
|
||
|
|
|
||
|
|
### 5. Network Access
|
||
|
|
|
||
|
|
- [ ] Set hostname to `autokanban`: `sudo hostnamectl set-hostname autokanban`
|
||
|
|
- [ ] Access app at `http://autokanban.local:8000`
|
||
|
|
- [ ] Verify 124 Hub link in header works
|
||
|
|
|
||
|
|
### 6. Production Settings Verified
|
||
|
|
|
||
|
|
- [ ] `ENABLE_PHYSICAL_PRINTER = True` in `app/main.py`
|
||
|
|
- [ ] Debug print statements removed
|
||
|
|
- [ ] Session secret loaded from environment variable
|
||
|
|
- [ ] Service runs without `--reload` flag
|
||
|
|
|
||
|
|
### 7. Testing
|
||
|
|
|
||
|
|
- [ ] Submit a test task
|
||
|
|
- [ ] Approve task as admin
|
||
|
|
- [ ] Print task and verify:
|
||
|
|
- [ ] Preview image shows on website
|
||
|
|
- [ ] Physical card prints with formatting
|
||
|
|
- [ ] Icon appears correctly
|
||
|
|
- [ ] Text is readable (larger fonts)
|
||
|
|
- [ ] Test "Erneut drucken" (reprint) function
|
||
|
|
- [ ] Test service restart: `sudo systemctl restart autokanban`
|
||
|
|
|
||
|
|
### 8. Monitoring
|
||
|
|
|
||
|
|
- [ ] Check logs: `sudo journalctl -u autokanban -f`
|
||
|
|
- [ ] Verify no errors in startup
|
||
|
|
- [ ] Test graceful shutdown: `sudo systemctl stop autokanban`
|
||
|
|
|
||
|
|
## Post-Deployment
|
||
|
|
|
||
|
|
### Regular Maintenance
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Update code
|
||
|
|
cd ~/autokanban
|
||
|
|
git pull
|
||
|
|
sudo systemctl restart autokanban
|
||
|
|
|
||
|
|
# View logs
|
||
|
|
sudo journalctl -u autokanban -n 100
|
||
|
|
|
||
|
|
# Check service status
|
||
|
|
sudo systemctl status autokanban
|
||
|
|
|
||
|
|
# Backup tasks
|
||
|
|
cp data/tasks.json data/tasks.json.backup
|
||
|
|
```
|
||
|
|
|
||
|
|
### Troubleshooting
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Service won't start
|
||
|
|
sudo journalctl -u autokanban -n 50
|
||
|
|
|
||
|
|
# Printer not working
|
||
|
|
ls -la /dev/serial0
|
||
|
|
stty -F /dev/serial0
|
||
|
|
|
||
|
|
# Check if port is accessible
|
||
|
|
curl http://localhost:8000
|
||
|
|
|
||
|
|
# Restart service
|
||
|
|
sudo systemctl restart autokanban
|
||
|
|
```
|
||
|
|
|
||
|
|
## Current Configuration
|
||
|
|
|
||
|
|
- **Port**: 8000
|
||
|
|
- **Hostname**: autokanban.local
|
||
|
|
- **Access URL**: <http://autokanban.local:8000>
|
||
|
|
- **Printer**: GPIO serial (/dev/serial0, 19200 baud)
|
||
|
|
- **Service**: Systemd with autostart enabled
|
||
|
|
- **Data**: JSON file at `data/tasks.json`
|
||
|
|
- **Previews**: PNG files in `out/`
|
||
|
|
|
||
|
|
---
|
||
|
|
Last updated: 2025-11-20
|