Module for loading parameter-store values from AWS SSM into environment variables
This fork has been updated to depend on aws-param-store-sdkv3, in order to support the AWS SDK v3 (and now depends only on the client-ssm module of the sdk).
- 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
- AWS Lambda Node.js 10.x compatible
Install via npm.
npm install aws-param-env-sdkv3 --save
const awsParamEnv = require( 'aws-param-env-sdkv3' );
awsParamEnv.load( '/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 awsParamEnv = require( 'aws-param-env-sdkv3' );
awsParamEnv.load( '/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-sdkv3' );
// environment variables are automatically loaded from the SSM parameter store