greenlock-store-sequelize.js/README.md

144 lines
3.5 KiB
Markdown
Raw Normal View History

2019-04-20 22:02:45 +00:00
# [greenlock-store-sequelize](https://git.rootprojects.org/root/greenlock-store-sequelize.js) | A [Root](https://rootprojects.org) project
> A database-driven Greenlock storage plugin with wildcard support.
2019-05-09 06:35:02 +00:00
## Features
* Many [Supported SQL Databases](http://docs.sequelizejs.com/manual/getting-started.html)
* [x] PostgreSQL (**best**)
* [x] SQLite3 (**easiest**)
* [x] Microsoft SQL Server (mssql)
* [x] MySQL, MariaDB
* Works on all platforms
* [x] Mac, Linux, VPS
* [x] AWS, Heroku, Akkeris, Docker
* [x] Windows
## Usage
2019-05-09 06:35:02 +00:00
To use, provide this Greenlock storage plugin as the `store` option when you
invoke `create`:
```js
2019-05-09 06:35:02 +00:00
Greenlock.create({
store: require('greenlock-store-sequelize')
...
});
```
2019-04-10 14:17:15 +00:00
## Configuration
2019-05-09 06:35:02 +00:00
* SQLite3 (default)
* Database URLs / Connection Strings
* Environment variables
* Table Prefixes
2019-04-10 14:17:15 +00:00
2019-05-09 06:35:02 +00:00
### SQLite3 (default)
2019-05-09 06:35:02 +00:00
SQLite3 is the default database, however, since it has a large number of dependencies
and may require a native module to be built, you must explicitly install
[sqlite3](https://www.npmjs.com/package/sqlite3):
2019-05-09 06:35:02 +00:00
```bash
npm install --save sqlite3
```
2019-04-10 14:11:38 +00:00
2019-05-09 06:35:02 +00:00
The default db file will be written wherever Greenlock's `configDir` is set to,
which is probably `~/acme` or `~/letsencrypt`.
2019-04-10 14:11:38 +00:00
2019-05-09 06:35:02 +00:00
```bash
~/acme/db.sqlite3
```
If you wish to set special options you may do so by passing a pre-configured `Sequelize` instance:
```js
var Sequelize = require('sequelize');
var db = new Sequelize({ dialect: 'sqlite', storage: '/Users/me/acme/db.sqlite3' });
Greenlock.create({
store: require('greenlock-store-sequelize').create({ db: db })
...
2019-04-10 14:11:38 +00:00
});
```
2019-05-09 06:35:02 +00:00
### Database URL Connection String
2019-04-10 14:11:38 +00:00
2019-05-09 06:35:02 +00:00
You may use database URLs (also known as 'connection strings') to initialize sequelize:
```js
var Sequelize = require('sequelize');
var db = new Sequelize('postgres://user:pass@hostname:port/database');
Greenlock.create({
store: require('greenlock-store-sequelize').create({ db: db })
...
});
```
If you need to use **custom options**, just instantiate sequelize directly:
```js
var dbUrl = 'postgres://user:pass@hostname:port/database';
Greenlock.create({
store: require('greenlock-store-sequelize').create({ storeDatabaseUrl: dbUrl })
...
});
```
For more information, see the [Sequelize Getting Started](http://docs.sequelizejs.com/manual/getting-started.html) docs.
### ENVs (i.e. for Docker, Heroku, Akkeris)
If your database connection string is in an environment variable,
you would use the usual standard for your platform.
For example, if you're using Heroku, Akkeris, or Docker you're
database connection string is probably `DATABASE_URL`, so you'd do something like this:
```js
var Sequelize = require('sequelize');
var databaseUrl = process.env['DATABASE_URL'];
var db = new Sequelize(databaseUrl);
Greenlock.create({
store: require('greenlock-store-sequelize').create({ db: db })
...
2019-04-10 14:11:38 +00:00
});
```
2019-05-09 06:35:02 +00:00
### Table Prefixes
The default table names are as follows:
2019-04-10 14:17:15 +00:00
2019-05-09 06:35:02 +00:00
* Keypair
* Domain
* Certificate
* Chain
2019-04-10 14:17:15 +00:00
2019-05-09 06:35:02 +00:00
If you'd like to add a table name prefix or define a specific schema within the database (PostgreSQL, SQL Server),
you can do so like this:
```js
var Sequelize = require('sequelize');
var databaseUrl = process.env['DATABASE_URL'];
var db = new Sequelize(databaseUrl, {
define: {
hooks: {
beforeDefine: function (name, attrs) {
console.log(name);
console.log(attrs);
attrs.tableName = 'MyPrefix' + attrs.tableName;
//attrs.schema = 'public';
}
}
}
});
2019-05-09 06:35:02 +00:00
Greenlock.create({
store: require('greenlock-store-sequelize').create({ db: db })
...
2019-04-10 14:17:15 +00:00
});
```