Node-config par lorenwest

NPM État de construction notes de version

Introduction

Node-config organise les configurations hiérarchiques pour vos déploiements d’applications.

Il vous permet de définir un ensemble de paramètres par défaut, et de les étendre pour différents environnements de déploiement (développement, assurance qualité, staging, production, etc.).Les configurations

sont stockées dans des fichiers de configuration au sein de votre application et peuvent être remplacées et étendues par des variables d’environnement, des paramètres de ligne de commande ou des sources externes.

Cela donne à votre application une interface de configuration cohérente partagée entre une liste croissante de modules npm utilisant également node-config.

Lignes directrices du projet

Simple – Démarrez rapidement
Puissant – Pour le déploiement d’entreprise multi-nœuds
Flexible – Prise en charge de plusieurs formats de fichiers de configuration
Léger – Faible encombrement des fichiers et de la mémoire
Prévisible – Base bien testée pour les développeurs de modules et d’applications

Démarrage rapide

Les exemples suivants sont au format JSON, mais les configurations peuvent être dans d’autres formats de fichiers.

Installez dans le répertoire de votre application et modifiez le fichier de configuration par défaut.

$ npm install config$ mkdir config$ vi config/default.json{ // Customter module configs "Customer": { "dbConfig": { "host": "localhost", "port": 5984, "dbName": "customers" }, "credit": { "initialLimit": 100, // Set low for development "initialDays": 1 } }}

Modifier les remplacements de configuration pour le déploiement en production:

$ vi config/production.json{ "Customer": { "dbConfig": { "host": "prod-db-server" }, "credit": { "initialDays": 30 } }}

Utilisez des configs dans votre code:

var config = require('config');...var dbConfig = config.get('Customer.dbConfig');db.connect(dbConfig, ...);

Démarrez votre serveur d’applications:

$ export NODE_ENV=production$ node my-app.js

S’exécutant dans cette configuration, les éléments port et dbName de dbConfig proviendront du fichier default.json, et l’élément host proviendront du fichier de substitution production.json.

Articles

Fichiers de configuration
Usage courant
Variables d’environnement
Mots réservés
Remplacements de ligne de commande
Instances de nœuds multiples
Configuration de sous-modules
Configuration à partir d’une Source DB/Externe
Outils de Gestion de Configuration externes
Examen des Sources de configuration
Utilisation des Utilitaires de configuration
Mise à niveau à partir de la Configuration 0.x

Contributors

lorenwest	josx	enyo	eheikes	th507	nsabovic
Osterjour	jberrisch	nitzan-shaked	Alaneor	roncli	keis
cmcculloh	abh	DMajrekar	jonjonsonjr	k-j-kleist	GUI
bolgovr	Askelkana	hisayan	Esya	eiriksm	jscharlach
mmoczulski	supersheep