CLI interattiva per la gestione centralizzata dei **Firebase Functions Secrets** (Firebase Secrets Manager), con sincronizzazione dei riferimenti anche nei file locali del repository.
npm install firebase-secrets-cliCLI interattiva per la gestione centralizzata dei Firebase Functions Secrets (Firebase Secrets Manager), con sincronizzazione dei riferimenti anche nei file locali del repository.
Semplificare e standardizzare le operazioni sui secrets usati dalle Cloud Functions, evitando errori manuali e mantenendo allineati:
- Firebase Secrets Manager (ONLINE): valore reale del secret
- functions/.secret.local (LOCALE): elenco chiavi (e talvolta valori) utile per sviluppo/ops
- functions/src/config/secret.ts (CODICE): “registry” tipizzato delle chiavi disponibili nel progetto
All’avvio, mostra un menu “Firebase Secrets Manager” con queste azioni:
- get: legge e mostra il valore di una secret (accesso online)
- list: mostra tutte le secrets presenti in secret.ts e ne stampa i valori (con conferma, perché espone valori a schermo)
- set: crea una nuova secret online e aggiorna anche .secret.local + secret.ts
- update: aggiorna il valore online e garantisce che la key sia presente in .secret.local e secret.ts
- destroy: elimina la secret online (con conferma) e poi:
- commenta la riga corrispondente in .secret.local
- rimuove la key da secret.ts
- syncToLocal: prende il valore online e lo scrive in .secret.local come KEY=VALUE
- reviveFromLocal: ripristina online una secret partendo da una riga commentata ma con valore in .secret.local (es. # KEY=VALORE), poi:
- scrive online
- aggiunge la key a secret.ts
- decommenta e normalizza la riga in .secret.local
La CLI propone una lista di chiavi lette da functions/src/config/secret.ts, ma permette anche di inserire una chiave manualmente con l’opzione “Other…”.
- L’azione list stampa i valori dei secrets: viene richiesta conferma esplicita.
- Le operazioni usano i comandi firebase functions:secrets:*, quindi serve:
- essere autenticati su Firebase
- avere i permessi corretti sul progetto
- Node.js (progetto TypeScript ESM)
- Firebase CLI installata e autenticata (firebase login)
- Repository che contenga (o che tu voglia allineare a) la struttura:
- functions/.secret.local
- functions/src/config/secret.ts
> Nota: i path sono risolti con process.cwd(). In pratica la CLI si aspetta di essere lanciata dalla root del repo che contiene la cartella functions/.
``bash`
npm i -D firebase-secrets-cli
Il pacchetto espone questi binari (da package.json):
- firebase-secrets → CLI principalecic-index
- → entrypoint secondario (utility/launcher)cic-bump
- → utility di bump versionecic-push
- → utility per aggiornare CHANGELOG.md e gestire commit/tag/push Git
Esempi:
`bashCLI principale
npx firebase-secrets
Troubleshooting
$3
- Verifica di lanciare il comando dalla root del repo (dove esiste
).
- In caso di repo senza i file, la CLI dovrebbe poterli creare/aggiornare quando esegui operazioni tipo set/update (dipende dall’implementazione). Se non ci sono controlli ancora, aggiungerli è una buona prossima patch:
- se manca functions/ → errore chiaro
- se manca .secret.local → creazione file vuoto
- se manca secret.ts → scaffolding minimale del registry$3
Se i comandi
firebase functions:secrets:* falliscono:-
firebase login
- seleziona il progetto corretto ()
- verifica di avere i permessi IAM necessari---
Informazioni dal pacchetto
- Nome:
firebase-secrets-cli
- Versione:
- Bin: , cic:index, cic:bump`- Repo: https://github.com/AntoCic/firebase-secrets-cli
- Issues: https://github.com/AntoCic/firebase-secrets-cli/issues
- Changelog: ./CHANGELOG.md