Skip to content

jjongsma/grunt-eb-deploy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grunt-eb-deploy

A simple Grunt task to replace eb deploy from the Elastic Beanstalk CLI, which also allows deploying a custom application distribution instead of the entire repository root.

To use this task, you should install the AWS SDK CLI and configure your credentials first with aws configure.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-eb-deploy --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-eb-deploy');

The "ebDeploy" task

Overview

In your project's Gruntfile, add a section named ebDeploy to the data object passed into grunt.initConfig().

grunt.initConfig({
  ebDeploy: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
});

File Lists

ebDeploy uses grunt-contrib-compress internally to generate a ZIP archive before uploading it to ElasticBeanstalk. For reference on how to specify file lists, please see the compress task documentation

Options

options.region

Type: String Default value: us-east-1

The AWS region to deploy the application to.

options.application

Type: String Required: true

The ElasticBeanstalk application name.

options.environment

Type: String Required: true

The ElasticBeanstalk application environment to update.

options.archive

Type: String Default value: .tmp/dist.zip

The location of the ZIP archive to generate before uploading to ElasticBeanstalk.

options.profile

Type: String Default: none

The local credential profile to use for the AWS SDK (see "Using Profiles with the SDK" section of the Node AWS SDK docs.)

Usage Examples

Single Environment Deployment

Deploy to a single application environment.

grunt.initConfig({
  ebDeploy: {
    options: {
		application: 'eb-test-app',
		environment: 'eb-test-app-dev'
	},
	files: [
	  { src: ['.ebextensions/*'] },
	  { cwd: 'dist/', src: ['**'], expand: true }
	]
  },
});

Multiple Environment Deployment

Deploy to multiple environments of an application.

grunt.initConfig({
  ebDeploy: {
    options: {
		application: 'eb-test-app',
	},
	dev: {
		options: {
			environment: 'eb-test-app-dev'
		},
		files: [
		  { src: ['.ebextensions/*'] },
		  { cwd: 'dist/', src: ['**'], expand: true }
		]
	},
	prod: {
		options: {
			environment: 'eb-test-app-prod'
		},
		files: [
		  { src: ['.ebextensions/*'] },
		  { cwd: 'dist/', src: ['**'], expand: true }
		]
	},
  },
});

Release History

0.1.3 - Feb 10, 2015

Ok, so I'm new to this. Changed task name to match Grunt conventions.

0.1.2 - Feb 10, 2015

Added ZIP archive generation.

0.1.1 - Feb 10, 2015

Added credential profile support.

0.1.0 - Feb 9, 2015

Initial release.

About

Grunt ElasticBeanstalk deployment task

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published