2.1.0 • Published 4 years ago

aws-param-env v2.1.0

Weekly downloads
2,703
License
BSD-3-Clause
Repository
github
Last release
4 years ago

Build Status npm version

aws-param-env

Module for loading parameter-store values from AWS SSM into environment variables

Features

  • Loads parameters by path
  • Runs synchronously to that environment variables can be set before your code loads
  • Recursively loads and decodes parameters by default
  • Can run inside AWS Lambda environment
  • Node.js 12.x compatible

Installation

Install via npm.

npm install aws-param-env --save

Note: aws-param-env does not contain a dependency on aws-sdk and it should be installed within your application.

Getting Started

const { envFromSSM } = require( 'aws-param-env' );

envFromSSM( '/my-service-path-in-ssm/env' );

If your AWS region is not set in your environment variables, then it can be set programmatically by supplying options when calling load():

const { envFromSSM } = require( 'aws-param-env' );

envFromSSM( '/my-service-path-in-ssm/env', { region: 'us-east-1' } );

To load the environment variables automatically from a path, set the AWS_SSM_ENV_PATH to the SSM path and the AWS_REGION to the correct AWS region.

// AWS_SSM_ENV_PATH = '/my-services/service1/env'
// AWS_REGION='us-east-1'

require( 'aws-param-env' );

// environment variables are automatically loaded from the SSM parameter store

Feedback

We'd love to get feedback on how to make this tool better. Feel free to contact us at feedback@vandium.io

License

BSD-3-Clause