Registry / devops / ember-cli-deploy

ember-cli-deploy

JSON →
library2.0.0jsnpmunverified

Ember CLI Deploy provides a flexible, plugin-based deployment pipeline specifically designed for Ember CLI applications. It integrates directly with the Ember CLI ecosystem, allowing developers to define complex deployment strategies through a configuration-driven approach. The current stable version is 2.0.0. While not following a strict time-based release cadence, it sees regular updates for bug fixes and new features, with major versions introducing significant changes like Node.js version compatibility shifts or configuration overhauls. Its key differentiator is its deep integration with Ember CLI projects and its extensible plugin architecture, which enables deployment to various targets (e.g., S3, FastBoot, gh-pages) with custom hooks and asset handling, making it a tailored solution for Ember applications rather than a general-purpose deployment tool.

npm install ember-cli-deploy
INSTALL
IMPORT
SIG · EMBER-CLI-DEPLOY
E
ember-cli-deploy
devopsjavascriptv2.0.0
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Installation
ember install ember-cli-deploy
npm install ember-cli-deploy
As an Ember CLI addon, it must be installed using `ember install` to properly execute blueprints and set up project-level configurations.
Deployment Command
ember deploy
node_modules/.bin/ember-cli-deploy
The primary interaction is via the `ember` CLI command, exposing `deploy` as a subcommand. Additional options like `--environment` can be appended.
Configuration File Export
module.exports = function(environment) { return { /* ... */ }; };
const config = { /* ... */ };
Configuration is typically defined in `config/deploy.js`. It should export a function that returns the configuration object, often based on the deployment `environment`.

This quickstart demonstrates how to install `ember-cli-deploy` and a basic build plugin, sets up a minimal `config/deploy.js` file, and shows the primary command for initiating a deployment within an Ember CLI project context.

import { execSync } from 'node:child_process'; import { writeFileSync } from 'node:fs'; import { resolve } from 'node:path'; // 1. Install ember-cli-deploy (usually done in your Ember CLI project) console.log('Installing ember-cli-deploy...'); execSync('ember install ember-cli-deploy', { stdio: 'inherit' }); // 2. Install a common deployment plugin (e.g., ember-cli-deploy-build) console.log('Installing ember-cli-deploy-build...'); execSync('ember install ember-cli-deploy-build', { stdio: 'inherit' }); // 3. Create a basic deploy configuration file (config/deploy.js) const deployConfigFileContent = ` module.exports = function(environment) { let ENV = { build: { environment: environment }, // Add other plugins and their configurations here // For example, for S3 deployment: // s3: { // accessKeyId: process.env.AWS_ACCESS_KEY_ID ?? '', // secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY ?? '', // bucket: 'my-ember-app-bucket', // region: 'us-east-1' // } }; return ENV; }; `; const configPath = resolve(process.cwd(), 'config', 'deploy.js'); writeFileSync(configPath, deployConfigFileContent); console.log(`Created dummy config/deploy.js at ${configPath}`); // 4. Run the deploy command (requires an actual Ember CLI project context) console.log('To deploy, navigate to your Ember CLI project and run:'); console.log(' ember deploy --environment=production'); console.log('Make sure you have appropriate plugins installed and configured.');
ember --version
Debug
Known issues
breakingVersion 2.0.0 of `ember-cli-deploy` officially dropped support for Node.js 12. Projects using Node.js 12 will encounter errors or unexpected behavior.
fix
Upgrade your Node.js environment to version 14.*, 16.*, or newer as specified in the package engines. Ensure your CI/CD pipelines also reflect this change.
affects: >=2.0.0
breakingThe `plugins` config option was deprecated in v1.0.0-beta.1 and completely replaced in v1.0.0 with a new, more flexible approach for defining plugin ordering, disabling, and aliasing.
fix
Remove the old `plugins` configuration and adopt the new strategy using properties like `disabled: { pluginName: true }` or `disable: { allExcept: [...] }` directly within your `config/deploy.js` for each plugin. Refer to the official v1.0.x documentation for details.
affects: >=1.0.0
gotchaPlugin name extraction for scoped npm packages (e.g., `@scope/ember-cli-deploy-plugin`) was bugged in versions prior to v2.0.0, potentially causing issues with plugin discovery or usage.
fix
Upgrade to `ember-cli-deploy` version 2.0.0 or later to ensure correct handling of scoped deployment plugins.
affects: <2.0.0
Errors
Common errors & fixes
Error: The `plugins` config option has been removed. Please see the v1.0.0 release notes for the new way to configure plugins.
Using the deprecated `plugins` array in `config/deploy.js` after upgrading to `ember-cli-deploy` v1.0.0 or later.
fix
Refactor your `config/deploy.js` to use the new plugin configuration syntax, specifying `disabled` or `disable` options directly within each plugin's configuration block.
Error: Node.js v12.x is no longer supported by ember-cli-deploy.
Attempting to run `ember-cli-deploy` v2.0.0 or later with a Node.js 12 environment.
fix
Update your Node.js installation to version 14.*, 16.*, or any newer supported LTS release. Confirm your `package.json` engines field also reflects compatible versions.
Error: Command `ember deploy` not found.
Either `ember-cli-deploy` was not installed or it was installed incorrectly (e.g., via `npm install` instead of `ember install`).
fix
Ensure you are in an Ember CLI project directory and run `ember install ember-cli-deploy`. If already installed, try `rm -rf node_modules yarn.lock package-lock.json && npm install` (or `yarn install`) to rebuild dependencies.
Error: Cannot read properties of undefined (reading 'init') related to CoreObject.
An older version of `ember-cli-deploy` or its dependencies had compatibility issues with newer Ember/Ember CLI versions regarding `CoreObject` initialization.
fix
Upgrade `ember-cli-deploy` to at least version `0.6.4` to include fixes for `CoreObject` deprecations and compatibility with newer Ember CLI internals.
Upgrade
Version history
2.0.0latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
2 hits · last 30 days
node
2
Resources
ember-cli-deploy — npm install ember-cli-deploy · libregistry