Home

Awesome

Ember-cli-deploy-couchdb

An ember-cli-deploy plugin to upload files to CouchDB

This plugin uploads an Ember App to a CouchDB design doc. The Ember App is served directly to the browser from CouchDB, without any other software in the stack.

What is an ember-cli-deploy plugin?

A plugin is an addon that can be executed as a part of the ember-cli-deploy pipeline. A plugin will implement one or more of the ember-cli-deploy's pipeline hooks.

For more information on what plugins are and how they work, please refer to the Plugin Documentation.

Quick Start

To get up and running quickly, do the following:

$ ember install ember-cli-deploy-couchdb

ENV.couchdb = {
  db: 'http://localhost:5984/emberapp'

  // optionally, if you are using ember-cli-deploy-build instead of
  // ember-cli-deploy-build-plus, also include the following

  // ddocname: emberapp,
  // couchDir: 'tmp/deploy-dist',
  // distDir: 'tmp/deploy-dist/_attachments'
}

If you are using ember-cli-deploy-build, you will also need to add the following to your build hook

ENV.build = {
  outputPath: 'tmp/deploy-dist/_attachments'
}

if (environment === 'production') {
  ENV.rootURL = '/emberapp/_design/ddocname/_rewrite/';
}

If a vhost is used do the following:

if (environment === 'production') {
  ENV.rootURL = '/';
}

$ ember deploy

Installation

Run the following command in your terminal:

ember install ember-cli-deploy-couchdb

ember-cli-deploy Hooks Implemented

For detailed information on what plugin hooks are and how they work, please refer to the Plugin Documentation.

Configuration Options

For detailed information on how configuration of plugins works, please refer to the Plugin Documentation.

db (required)

The CouchDB URL

Default: undefined

ddocname

The Ember App is uploaded to the ddocname URL as _design/ddocname.

Default: context.project.name()

couchappignore

Array of regexps for files to skip upload.

Default: []

distDir

The root directory where the files will be searched for. By default, this option will use the distDir property of the deployment context, provided by ember-cli-deploy-build-plus.

Default: context.distDir

Prerequisites

The following properties are expected to be present on the deployment context object:

Issues

You can use the issue tracker to provide feedback, suggest features or report bugs.

Running Tests