Secrets e variabili
Scopo
Elencare nomi di variabili e secret senza valori. Nessuna password o token nel repository.
Prerequisiti
- Generare segreti con
openssl rand -hex 32. - Template:
.env.example,deploy/env/.env.*.example,deploy/node-red/env/.env.*.example.
Development (.env)
| Variabile | Descrizione |
|---|---|
EZ_ENV | development |
SITE_NAME | Site Frappe (es. factory.local) |
ADMIN_PASSWORD | Password Administrator |
DB_HOST, DB_PORT, DB_ROOT_PASSWORD, DB_NAME, DB_USER, DB_PASSWORD | MariaDB |
DB_PUBLISH_PORT, REDIS_PUBLISH_PORT, HTTP_PUBLISH_PORT, SOCKETIO_PUBLISH_PORT | Porte host |
REDIS_CACHE, REDIS_QUEUE, REDIS_SOCKETIO | URL Redis |
FRAPPE_BRANCH, BENCH_PATH, DEVELOPER_MODE, LIVE_RELOAD | Bench |
BUSINESS_CUBE_API_URL, BUSINESS_CUBE_API_KEY | Presenti nel template; nessun client nel codice le legge (riferimento manuale via external_id su Work Order) |
NODE_RED_BASE_URL, NODE_RED_API_TOKEN, NODE_RED_GATEWAY_TOKEN | Gateway OT |
Staging / Production
Oltre a DB/Redis/Node-RED:
| Variabile | Descrizione |
|---|---|
CUSTOM_IMAGE, CUSTOM_TAG, PULL_POLICY, RESTART_POLICY | Immagine GHCR |
MARIADB_VERSION, REDIS_VERSION | Tag immagini db e redis-* (default 11.8 / 8.8; MARIADB_VERSION=10.6 sui volumi esistenti) |
SECRET_KEY | Encryption key site |
WEB_URL, CORS_ALLOWED_ORIGINS | URL pubblici |
GUNICORN_WORKERS, GUNICORN_THREADS, GUNICORN_TIMEOUT | Backend |
MUTE_EMAILS, DISABLE_EXTERNAL_WEBHOOKS | Solo staging (safety) |
Node-RED
| Variabile | Descrizione |
|---|---|
NODE_RED_CREDENTIAL_SECRET, FACTORYOS_API_TOKEN | Segreti gateway |
MQTT_URL, MQTT_USERNAME, MQTT_PASSWORD | Broker interno |
OT_WRITES_ENABLED, OT_SIMULATION_MODE, OT_FORCE_REAL | Policy OT (default sicuri: writes 0, simulation 1) |
DISABLE_EDITOR | Editor off in staging/prod |
FRAPPE_BASE_URL, FRAPPE_API_KEY, FRAPPE_API_SECRET, FRAPPE_GATEWAY_TOKEN | Callback Desk |
MODBUS_WEIGHER_ENDPOINT, OPCUA_BAGGING_ENDPOINT | Endpoint PLC letti dal gateway secondo inventario machines.inventory.json |
CONTROL_URL, CONTROL_SSO_SECRET | SSO one-click da Control verso editor Node-RED |
Control (Coolify app)
| Variabile | Descrizione |
|---|---|
CONTROL_BACKUP_WEBHOOK_TOKEN | Token per POST /api/webhooks/backup/{env} (GitHub Actions) |
CONTROL_SSO_SECRET | Segreto condiviso con FactoryOS e Node-RED per consume ticket SSO |
CONTROL_URL | URL pubblico Control (magic link / redirect) |
FactoryOS (site_config / env container)
| Variabile | Descrizione |
|---|---|
CONTROL_URL | Base URL Control per consume SSO |
CONTROL_SSO_SECRET | Stesso valore di Control |
GitHub Secrets
| Secret | Environment | Uso |
|---|---|---|
GITHUB_TOKEN | repo | Push GHCR (automatico) |
DOKPLOY_WEBHOOK_DEV | development | Deploy Coolify (legacy name) |
DOKPLOY_WEBHOOK_STAGING | staging | Deploy Coolify |
DOKPLOY_WEBHOOK_PRODUCTION | production | Deploy Coolify |
COOLIFY_DEPLOY_TOKEN | staging/production | Bearer webhook |
COOLIFY_DOCS_WEBHOOK | repo | Deploy VitePress |
COOLIFY_WEBHOOK_NODERED_{DEV,STAGING,PRODUCTION} | relativi | Deploy Node-RED |
BACKUP_WEBHOOK_{STAGING,PRODUCTION} | relativi | URL Control /api/webhooks/backup/{env}?token=… (pre-deploy obbligatorio) |
ROLLBACK_WEBHOOK_PRODUCTION | production | Rollback opzionale |
S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEY | staging/production | Upload backup (opzionale, via scripts/s3-upload.sh) |
Variabili S3 correlate: S3_ENDPOINT, S3_BUCKET, S3_REGION.
Verifica
- Nessun secret in
git grepsu valori reali. - Secret scanning CI verde su PR verso main.
Troubleshooting
Token mismatch Frappe↔Node-RED → Connection Profile Error. Rigenerare e allineare entrambi i lati.
