arc env

Read and write environment variables. Sensitive configuration data, such as API keys, needs to happen outside of the codebase in revision control and you can use this tool to ensure an entire team and the deployment targets are in sync.

Example Usage

  • arc env displays environment variables for the current .arc
  • arc env staging FOOBAZ somevalue writes env variable FOOBAZ=somevalue to staging Lambdas
  • arc env remove testing FOOBAZ removes a testing env var
  • arc env verify display a report of Lambdas and their env variables

Things to note

  • NODE_ENV, ARC_APP_NAME and SESSION_TABLE_NAME are reserved

Currently .arc uses AWS Systems Manager Parameter Store as a centralized backing storage mechanism for app environment variables. Read more about AWS Systems Manager Parameter Store.

The .arc-env File

This file should not be committed into your project git repository.

  • Generated by adding or removing env vars using arc env
  • Automatically read by arc sandbox and populates process.env
  • Lists env vars for testing or staging for local dev

This is an example file:

# example .arc-env
@testing 
GLOBAL asdfasdf

@staging
GLOBAL_KEY val