codedeploy-scripts

CodeDeploy Scripts

AWS CodeDeploy lifecycle scripts using ES6 to deploy a node app to EC2.

Usage

npm install codedeploy-scripts

In the app folder, you only need two simple files to handle the deployment.

###appspec.yml

This tells CodeDeploy to copy everything to /apps/appname and run deployment.js for all lifecycle events. ApplicationStop is omitted, but you can use it if you are extremely confident in the quality of your code, or just enjoy manually fixing broken servers.

version: 0.0
os: linux
files:
    + source: /
      destination: /apps/appname
hooks:
#  ApplicationStop:
#    - location: deployment.js
#      timeout: 180
  BeforeInstall:
    + location: deployment.js
      timeout: 180
  AfterInstall:
    + location: deployment.js
      timeout: 180
  ApplicationStart:
    + location: deployment.js
      timeout: 180
  ValidateService:
    + location: deployment.js
      timeout: 180

deployment.js

Extends the deployment class with any custom actions needed on CodeDeploy lifecycle events. Deployment.run() will call the appropriate method based on the LIFECYCLE_EVENT variable set by CodeDeploy.

The below code will run /apps/deploytest/server.js on port 5000, with nginx as a reverse proxy and serving static files on deploytest.example.com:80

#!/usr/local/bin/node
var SimpleDeployment = require("codedeploy-scripts").SimpleDeployment;
var deployment = new SimpleDeployment({
    appName: "deploytest",
    nodePort: "5000",
    serverScript: "server.js",
    domains: "deploytest.example.com",
    buildFolder: "build",
    staticFolder: "static"
});
deployment.run();

For more complex scenarios, just create a custom subclass based on the implementation of SimpleDeployment.

Assumptions

To keep things simple, the code makes a few assumptions.

• The target is a standard Amazon Linux instance
• io.js is installed as /usr/local/bin/node
• The app will be installed to /apps/appname
• static files are in /apps/appname/static and /apps/appname/build