/env-to-ecs

Converts dotenv files to ECS consumable JSON blobs.

Primary LanguageGoMIT LicenseMIT

ENV to ECS Tool

This simple go script will ingest an environment definitions file and convert it into a JSON blob that ECS can consume in a task definition.

Basic Usage

./env-to-ecs -i <INFILE_TO_PARSE> -o <OUTFILE_TO_WRITE_TO>

Where an input looks like:

A=B

An the output will look like:

[{"name":"A","value":"B"}]

Features

  • -i | --infile: pass an infile in dotenv format that will be parsed
    • NOTE: the tool will raise an error and exit if you do not set this arg
  • -o | --outfile: pass an outfile in JSON format that will be written to
    • NOTE: If you do not set this arg, the output will be written to stdout.
    • NOTE: if you pass an outfile that does not exist, the outfile will be created for you
  • -v | --variable: pass in extra key=value pairs one at a time.
    • NOTE: Must be in dotenv format ie. A=B
    • NOTE: The arg can be passed multiple times
  • Supports comments in the infile ie. # this is a comment. These will be parsed out.

Why does this tool exist?

We wanted a way to configure our environments in one place, and know that those configuration would be propagated elsewhere automagically. For us, an environment definitions file is that single source of truth, and all other configuration files should be dependant on that. This will hopefully lead to less configuration drift and questions down the road.

Developing

Simplest way to get started is to clone the repo and run the ./ci/scripts/ensure_deps.sh. We use glide for dependencies, so make sure you have that installed. Once you have that running the scripts in that directory should help. They're hopefully named in an intuitive way.