A grunt plugin to help develop AWS Lambda functions. 

tim-b

grunt-aws-lambda

    "description": "A grunt plugin to help develop AWS Lambda functions.",

    "homepage": "https://github.com/Tim-B/grunt-aws-lambda",

        "url": "git://github.com/Tim-B/grunt-aws-lambda.git"

        "url": "https://github.com/Tim-B/grunt-aws-lambda/issues"

            "url": "https://github.com/Tim-B/grunt-aws-lambda/blob/master/LICENSE-MIT"

        "grunt-contrib-jshint": "^0.9.2",

        "grunt-contrib-nodeunit": "^0.3.3",

> A grunt plugin to assist in developing functions for [AWS Lambda](http://aws.amazon.com/lambda/).

[![Build Status](https://travis-ci.org/Tim-B/grunt-aws-lambda.svg)](https://travis-ci.org/Tim-B/grunt-aws-lambda)

* Managing npm dependencies which are required by your function

* Packaging required dependencies with your function in a Lambda compatible zip

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

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

This will save you from packaging previous packages in future ones.

For example your `.npmignore` might look something like this:

### Include your dependencies in bundledDependencies

npm packages which should be bundled with your lambda function must be included in the `bundledDependencies` of your

## Specify AWS credentials in ~/.aws/credentials

This will save you from accidentally committing AWS credentials.

* lambda_invoke - Wrapper to run and test lambda functions locally and view output.

* lambda_package - Packages function along with any npm dependencies in a zip format suitable for lambda.

* lambda_deploy - Uploads the zip package to lambda.

lambda_invoke and lambda_package can be used independently, lambda_deploy will invoke lambda_package before uploading

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

                // Task-specific options go here.

Specify the AWS region your functions will be uploaded to. Note that if an ARN is supplied this option is not required.

Depending on your Lambda function, you might need to increase the timeout value. The default timeout assigned by AWS is currently 3 seconds.

 If you wish to increase this timeout set the value here.

 Sets the memory assigned to the function. If null then the current setting for the function will be used. Value is in

In this example, the default options are used therefore if we have the following in our `Gruntfile.js`:

            arn: 'arn:aws:lambda:us-east-1:123456781234:function:my-function'

And now if you run `grunt lambda_deploy` your package should be created and uploaded to the specified function.

##### Increasing the Timeout Options to 10 seconds

In this example, the timeout value is increased to 10 seconds and set memory to 256mb.

            arn: 'arn:aws:lambda:us-east-1:123456781234:function:my-function',

You can combine the lambda_package and lambda_deploy into a single deploy task by adding the following to your

grunt.registerTask('deploy', ['lambda_package', 'lambda_deploy']);

You can then run `grunt deploy` to perform both these functions in one step.

The AWS SDK is configured to look for credentials in the environment, that is it will look in `~/.aws/credentials`.

aws_secret_access_key = <YOUR_SECRET_ACCESS_KEY>

For more information [read this documentation](http://docs.aws.amazon.com/AWSJavaScriptSDK/guide/node-configuring.html).

To run the deploy command the AWS credentials require permissions to access lambda including `lambda:UploadFunction` and

 `iam:PassRole` for the role which is assigned to the function.

It is recommended that the following two policies be applied to the user:

* Parsing region automatically from ARN - [pull request by jvwing](https://github.com/Tim-B/grunt-aws-lambda/pull/25)

 * https://github.com/Tim-B/grunt-aws-lambda

    var arnParser = require('../utils/arn_parser');

    // Please see the Grunt documentation for more information regarding task

    // creation: http://gruntjs.com/creating-tasks

    grunt.registerMultiTask('lambda_deploy', 'Uploads a package to lambda', function () {

        grunt.config.requires('lambda_deploy.' + this.target + '.package');

            var credentials = new AWS.SharedIniFileCredentials({profile: options.profile});

            AWS.config.credentials = credentials;

        var deploy_function = grunt.config.get('lambda_deploy.' + this.target + '.function');

        var deploy_arn = grunt.config.get('lambda_deploy.' + this.target + '.arn');

        var deploy_package = grunt.config.get('lambda_deploy.' + this.target + '.package');

        if(deploy_arn === null && deploy_function === null) {

            grunt.fail.warn('You must specify either an arn or a function name.');

            deploy_function = deploy_arn;

            var functionInfo = arnParser.parse(deploy_arn);

            if (functionInfo && functionInfo.region) {

                options.region = functionInfo.region;

        AWS.config.update({region: options.region});

        lambda.getFunction({FunctionName: deploy_function}, function (err, data) {

                if(err.statusCode === 404) {

                    grunt.fail.warn('Unable to find lambda function ' + deploy_function + ', verify the lambda function name and AWS region are correct.');

                    grunt.fail.warn('AWS API request failed, check your AWS credentials, region and permissions are correct.');

            var current = data.Configuration;

            if (options.timeout !== null) {

                configParams.Timeout = options.timeout;

            if (options.memory !== null) {

                configParams.MemorySize = options.memory;

            var updateConfig = function(func_name, func_options, callback) {

                if(Object.keys(func_options).length > 0) {

                    func_options.FunctionName = func_name;

                    lambda.updateFunctionConfiguration(func_options, function(err, data) {

                            grunt.fail.warn('Could not update config, check that values and permissions are valid');

                        grunt.log.writeln('Config updated.');

                    grunt.log.writeln('No config updates to make.');

            grunt.log.writeln('Uploading...');

            fs.readFile(deploy_package, function (err, data) {

                    grunt.fail.warn('Could not read package file ('+deploy_package+'), verify the lambda package '+

                        'location is correct, and that you have already created the package using lambda_package.');

                    FunctionName: deploy_function,

                lambda.updateFunctionCode(codeParams, function (err, data) {

                        grunt.fail.warn('Package upload failed, check you have lambda:UpdateFunctionCode permissions.');

                    grunt.log.writeln('Package deployed.');

                    updateConfig(deploy_function, configParams, function(data){

		{
		"name": "grunt-aws-lambda",
		"description": "A grunt plugin to help develop AWS Lambda functions.",
		"version": "0.8.0",
		"version": "0.9.0",
		"homepage": "https://github.com/Tim-B/grunt-aws-lambda",
		@@ -6,0 +6,0 @@ "author": {

		@@ -350,2 +350,8 @@ # grunt-aws-lambda

		##### options.region
		Type: `String`
		Default value: `us-east-1`

		Specify the AWS region your functions will be uploaded to. Note that if an ARN is supplied this option is not required.

		##### options.timeout
		@@ -501,2 +507,5 @@ Type: `Integer`

		### 0.9.0
		* Parsing region automatically from ARN - [pull request by jvwing](https://github.com/Tim-B/grunt-aws-lambda/pull/25)

		@@ -16,4 +16,4 @@ /*
		var AWS = require('aws-sdk');
		var arnParser = require('../utils/arn_parser');


		// Please see the Grunt documentation for more information regarding task
		@@ -48,2 +48,6 @@ // creation: http://gruntjs.com/creating-tasks
		deploy_function = deploy_arn;
		var functionInfo = arnParser.parse(deploy_arn);
		if (functionInfo && functionInfo.region) {
		options.region = functionInfo.region;
		}
		}
		@@ -95,3 +99,3 @@
		}
		}
		};

		@@ -108,3 +112,3 @@ grunt.log.writeln('Uploading...');
		ZipFile: data
		}
		};

		@@ -111,0 +115,0 @@ lambda.updateFunctionCode(codeParams, function (err, data) {

Improved metrics