Convention-based bootstrapper for LoopBack applications
Go to file
David Cheung 4a815deb27 Dynamic datasources.json from ENV and config.json
Let environment variables override configuration set by config.json
and/or app.set()

Behavior changes
- datasources.json now support dynamic configuration through
  env-vars and config.json
- component-config.json will first consider env-var
  for resolving dynamic conf, then fallback to config.json
- middleware.json will first consider env-var for resolving
  dynamic conf, then fallback to config.json
- for all the dynamic confg, unresolved conf will return as `undefined`

Example:

Consider the following server/datasources.json
```
{
  "mysql" : {
    "name" : "mysql_db",
    "host" : "${MYSQL_DB_HOST}",
    ...
  }
}
```

Now you can provide the parameter through
an environment variable:

```
$ MYSQL_DB_HOST=127.0.0.1 node .
```

or you can set the value in server/config.json

```
{
  "MYSQL_DB_HOST": "127.0.0.1"
}
```
2016-04-06 10:30:23 -04:00
docs support coffee-script models and client code 2014-10-24 10:42:30 -07:00
lib Dynamic datasources.json from ENV and config.json 2016-04-06 10:30:23 -04:00
test Dynamic datasources.json from ENV and config.json 2016-04-06 10:30:23 -04:00
.eslintignore Use eslint with loopback config 2016-04-05 15:42:58 +02:00
.eslintrc Use eslint with loopback config 2016-04-05 15:42:58 +02:00
.gitignore Support for multiple apps in browserified bundle. 2015-03-19 09:57:32 -07:00
.travis.yml Upgrade Travis to container-based infrastructure 2015-08-24 15:35:56 +02:00
CHANGES.md 2.17.0 2016-02-23 12:08:30 +01:00
CONTRIBUTING.md Fix bad CLA URL in CONTRIBUTING.md 2014-12-29 08:27:45 -08:00
LICENSE.md Refer to licenses with a link 2015-11-03 12:27:49 -08:00
README.md Fix broken links 2015-01-29 12:17:24 -08:00
browser.js Support for multiple apps in browserified bundle. 2015-03-19 09:57:32 -07:00
docs.json Remove non-API docs. 2014-07-09 07:36:45 +02:00
index.js Use eslint with loopback config 2016-04-05 15:42:58 +02:00
package.json Use eslint with loopback config 2016-04-05 15:42:58 +02:00

README.md

LoopBack Boot

A convention-based bootstrapper for LoopBack applications.

For full documentation, see the official StrongLoop documentation: Defining boot scripts and Creating a LoopBack application.

Overview

The loopback-boot module initializes (bootstraps) a LoopBack application. Specifically, it:

  • Configures data-sources.
  • Defines custom models
  • Configures models and attaches models to data-sources.
  • Configures application settings
  • Runs additional boot scripts, so you can put custom setup code in multiple small files instead of in the main application file.

For more information, see Defining boot scripts.

Version notes

The version range 1.x is backwards compatible with app.boot provided by LoopBack 1.x versions and the project layout scaffolded by slc lb project up to slc version 2.5.

The version range 2.x supports the new project layout as scaffolded by yo loopback.

This document describes the configuration conventions of the 2.x versions.

Installation

npm install loopback-boot

Usage

var loopback = require('loopback');
var boot = require('loopback-boot');

var app = loopback();
boot(app, __dirname);

app.use(loopback.rest());
app.listen();

See API docs for complete API reference.

License

This module is provided under dual MIT/StrongLoop license. See LICENSE for details.