Getting Started

• 1. Install Lamb-duh source locally
  • Lamb-duh is now available via NPM
  • Lamb-duh can be cloned from source
• 2. Configure the AWS environment for Lamb-duh
  • Manual Process
  • Automated Process
• 3. Add a JSON configuration file to an application to be deployed
• 4. Create a compressed archive of the deployment application

1. Install Lamb-duh source locally

Lamb-duh is now available via NPM

This installs the CLI utility.

npm install lamb-duh-serverless-deployment -g

TIP

As part of installation, the function code for Lamb-duh's AWS Lambda function will be compressed to (./Lambda Deployment Package.zip)

Lamb-duh can be cloned from source

• Clone the repo from GitHub
• Switch to the ./src directory
  • Run npm install in the ./src directory
  • Run node buildForLambda.js in the ./src directory
• Follow all manual configuration steps in this documentation

2. Configure the AWS environment for Lamb-duh

There are two options for configuration: manual, or automated via the CLI utility.

Manual Process

The manual process will require you to:

1. Create a new role, and add all necessary permissions to it
2. Create a new function in AWS Lambda
   • Upload the ./Lambda Deployment Package.zip as the code for it
3. Create an S3 bucket to upload your code archives into
4. Add triggers to the bucket for the Lamb-duh process

See the manual configuration steps here

Automated Process

1. Run lamb-duh aws-install, answer a few questions, and let Lamb-duh's CLI utility take care of the setup for you

Read more about the automated process

3. Add a JSON configuration file to an application to be deployed

Application configurations define what is being deployed via 3 basic tasks:

• S3 tasks - copy source to S3 bucket-key destinations, and set CORS/ETag values accordingly
• Lambda tasks - Create/Update Lambda functions with new code and/or settings
• API Gateway tasks - Create/Update API endpoints, create stages, and version Lambda functions to those stages, and create new deployments

See Lamb-duh Configuration for details and the complete set of options.

4. Create a compressed archive of the deployment application

This can be done as part of your build process, or manually if you prefer. Both .zip and .tar.gz archives are supported. Copy the archive file to your S3 bucket configured as part of the AWS setup, and watch your application deploy.