YaDU (Yet another Deployment Utility)

Introduction

THIS IS STILL A WORK IN PROGRESS

This tool is used to deploy, upgrade and package AWS lambdas. It also manage our MySQL Schema Changes / Online Schema Changes using Liquibase CLI.

It is developed using NodeJS and ShellJS when it is not simple to use Javascript.

We planned to create a complete and intuitive tool to work alongside with SAM (from AWS)

Installation

npm install -g @halfserious/yadu

Using root account or if you have a permission error:

npm install --unsafe-perm -g @halfserious/yadu

To skip the Liquibase Installation:

export SKIP_POST=1
npm install -g @halfserious/yadu

Usage

For specific documentation:

• Lambda
• MySQL/Migrations/Liquibase

Get CLI help

yadu --help

Use an AWS profile

yadu --profile='profile_name'

alternatives:

• export AWS_PROFILE=""
• export PROFILE=""
• By default, it uses 'default'

Specify a region

yadu --region='us-east-1'

alternatives:

• export AWS_REGION=""
• export REGION=""
• By default, it uses 'us-east-1'

Configuration

It uses the environment variables, AWS Secret Manager, Local .env and arguments

| Priority | Description | Command | |:----------------:|-----------------------------------------------------------|---------------------------------------------| | 4 (Loaded First) | Load data from your local environment variables | export FOO=BAR or SetX FOO BAR | | 3 | Load data from AWS secret manager into your process.env | --secret=<String,String,...> | | 2 | Load data from local .env.environment file | NODE_ENV="<String>" or --env="<String>" | | 1 (Loaded Last) | Override using the arguments (Check the CLI commands) | --help |

Support

MacOs & Linux

Linux (Docker) : npm install -g --unsafe-perm @halfserious/yadu

On MacOS : npm install -g @halfserious/yadu

Windows

Tested on windows 10 using

• Git bash
• Powershell

npm install -g @halfserious/yadu

Contribution

All contributions are welcome ! We use the issues to track Feature requests, bugs and others.

We are still working on the core of this utility, so it is possible that breaking changes will be published.