chore: remove machine-specific dev workflow from tracking
This commit is contained in:
parent
e27b6f2657
commit
702b39740d
2 changed files with 1 additions and 63 deletions
|
|
@ -1,63 +0,0 @@
|
||||||
---
|
|
||||||
description: How the development environment works and how to manage it
|
|
||||||
---
|
|
||||||
|
|
||||||
# Pulse Development Environment
|
|
||||||
|
|
||||||
This is a **development-only machine**. Production is never run here.
|
|
||||||
|
|
||||||
## Primary Service: `pulse-hot-dev`
|
|
||||||
|
|
||||||
The dev environment uses a **single systemd service** that runs both backend and frontend with hot-reloading:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Status check
|
|
||||||
systemctl status pulse-hot-dev
|
|
||||||
|
|
||||||
# Restart (if needed)
|
|
||||||
// turbo
|
|
||||||
sudo systemctl restart pulse-hot-dev
|
|
||||||
|
|
||||||
# View logs
|
|
||||||
journalctl -u pulse-hot-dev -f
|
|
||||||
```
|
|
||||||
|
|
||||||
### What `pulse-hot-dev` does:
|
|
||||||
1. **Go Backend** (`./pulse`): Monitored by `inotifywait` - auto-rebuilds and restarts when `.go` files change
|
|
||||||
2. **Vite Frontend**: HMR enabled - browser updates instantly when frontend files change
|
|
||||||
|
|
||||||
### Access URLs:
|
|
||||||
- **Frontend**: http://192.168.0.123:5173/ (Vite dev server with HMR)
|
|
||||||
- **Backend API**: http://192.168.0.123:7655/ (Go server, proxied through Vite)
|
|
||||||
|
|
||||||
## DO NOT USE these services in development:
|
|
||||||
- `pulse.service` - This is for production (runs pre-built binary without hot-reload)
|
|
||||||
- Do NOT create separate `pulse-frontend.service` - the hot-dev script handles everything
|
|
||||||
|
|
||||||
## When things don't work:
|
|
||||||
|
|
||||||
1. **Frontend not loading at :5173** → Check if `pulse-hot-dev` is running
|
|
||||||
2. **Backend changes not reflected** → Check logs: `journalctl -u pulse-hot-dev -f`
|
|
||||||
3. **Need full restart** → `sudo systemctl restart pulse-hot-dev`
|
|
||||||
|
|
||||||
## Key Files:
|
|
||||||
- **Hot-dev script**: `/opt/pulse/scripts/hot-dev.sh`
|
|
||||||
- **Systemd service**: `/etc/systemd/system/pulse-hot-dev.service`
|
|
||||||
- **Makefile targets**: `make dev` or `make dev-hot`
|
|
||||||
|
|
||||||
## Encryption Key Monitoring
|
|
||||||
|
|
||||||
A watcher service monitors the encryption key file for any changes or deletions:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Check if the watcher is running
|
|
||||||
systemctl status encryption-key-watcher
|
|
||||||
|
|
||||||
# View recent encryption key events
|
|
||||||
sudo journalctl -u encryption-key-watcher -n 50
|
|
||||||
|
|
||||||
# View events around a specific time
|
|
||||||
sudo journalctl -u encryption-key-watcher --since "2025-12-09 14:00" --until "2025-12-09 15:00"
|
|
||||||
```
|
|
||||||
|
|
||||||
If the key ever goes missing, the logs will show what event happened and which processes had files open in `/etc/pulse` at that time.
|
|
||||||
1
.gitignore
vendored
1
.gitignore
vendored
|
|
@ -157,3 +157,4 @@ tmp_*.sh
|
||||||
# Local agent directories
|
# Local agent directories
|
||||||
scripts/agent/
|
scripts/agent/
|
||||||
docs/internal/
|
docs/internal/
|
||||||
|
.agent/
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue