Skip to content

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) ​

VariabileDescrizione
EZ_ENVdevelopment
SITE_NAMESite Frappe (es. factory.local)
ADMIN_PASSWORDPassword Administrator
DB_HOST, DB_PORT, DB_ROOT_PASSWORD, DB_NAME, DB_USER, DB_PASSWORDMariaDB
DB_PUBLISH_PORT, REDIS_PUBLISH_PORT, HTTP_PUBLISH_PORT, SOCKETIO_PUBLISH_PORTPorte host
REDIS_CACHE, REDIS_QUEUE, REDIS_SOCKETIOURL Redis
FRAPPE_BRANCH, BENCH_PATH, DEVELOPER_MODE, LIVE_RELOADBench
BUSINESS_CUBE_API_URL, BUSINESS_CUBE_API_KEYPresenti 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_TOKENGateway OT

Staging / Production ​

Oltre a DB/Redis/Node-RED:

VariabileDescrizione
CUSTOM_IMAGE, CUSTOM_TAG, PULL_POLICY, RESTART_POLICYImmagine GHCR
MARIADB_VERSION, REDIS_VERSIONTag immagini db e redis-* (default 11.8 / 8.8; MARIADB_VERSION=10.6 sui volumi esistenti)
SECRET_KEYEncryption key site
WEB_URL, CORS_ALLOWED_ORIGINSURL pubblici
GUNICORN_WORKERS, GUNICORN_THREADS, GUNICORN_TIMEOUTBackend
MUTE_EMAILS, DISABLE_EXTERNAL_WEBHOOKSSolo staging (safety)

Node-RED ​

VariabileDescrizione
NODE_RED_CREDENTIAL_SECRET, FACTORYOS_API_TOKENSegreti gateway
MQTT_URL, MQTT_USERNAME, MQTT_PASSWORDBroker interno
OT_WRITES_ENABLED, OT_SIMULATION_MODE, OT_FORCE_REALPolicy OT (default sicuri: writes 0, simulation 1)
DISABLE_EDITOREditor off in staging/prod
FRAPPE_BASE_URL, FRAPPE_API_KEY, FRAPPE_API_SECRET, FRAPPE_GATEWAY_TOKENCallback Desk
MODBUS_WEIGHER_ENDPOINT, OPCUA_BAGGING_ENDPOINTEndpoint PLC letti dal gateway secondo inventario machines.inventory.json
CONTROL_URL, CONTROL_SSO_SECRETSSO one-click da Control verso editor Node-RED

Control (Coolify app) ​

VariabileDescrizione
CONTROL_BACKUP_WEBHOOK_TOKENToken per POST /api/webhooks/backup/{env} (GitHub Actions)
CONTROL_SSO_SECRETSegreto condiviso con FactoryOS e Node-RED per consume ticket SSO
CONTROL_URLURL pubblico Control (magic link / redirect)

FactoryOS (site_config / env container) ​

VariabileDescrizione
CONTROL_URLBase URL Control per consume SSO
CONTROL_SSO_SECRETStesso valore di Control

GitHub Secrets ​

SecretEnvironmentUso
GITHUB_TOKENrepoPush GHCR (automatico)
DOKPLOY_WEBHOOK_DEVdevelopmentDeploy Coolify (legacy name)
DOKPLOY_WEBHOOK_STAGINGstagingDeploy Coolify
DOKPLOY_WEBHOOK_PRODUCTIONproductionDeploy Coolify
COOLIFY_DEPLOY_TOKENstaging/productionBearer webhook
COOLIFY_DOCS_WEBHOOKrepoDeploy VitePress
COOLIFY_WEBHOOK_NODERED_{DEV,STAGING,PRODUCTION}relativiDeploy Node-RED
BACKUP_WEBHOOK_{STAGING,PRODUCTION}relativiURL Control /api/webhooks/backup/{env}?token=… (pre-deploy obbligatorio)
ROLLBACK_WEBHOOK_PRODUCTIONproductionRollback opzionale
S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEYstaging/productionUpload backup (opzionale, via scripts/s3-upload.sh)

Variabili S3 correlate: S3_ENDPOINT, S3_BUCKET, S3_REGION.

Verifica ​

  • Nessun secret in git grep su 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.

Ez FactoryOS — MES per Ortobellina / OP Raggio di Sole · App Frappe v16 ez_factoryos