Skip to content

A lightweight utility to dump AWS Fargate's ECS containers environment variables locally

License

Notifications You must be signed in to change notification settings

dineshgowda24/ecsnv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ecsnv

GitHub go.mod Go version of a Go module

A lightweight utility to dump AWS Fargate's ECS containers environment variables locally

Motivation

More often than not, during the development cycle. I keep looking at my AWS ECS cluster and services to check what all environment variables have been set. Some ENVs were not readily available in the project repository since they were configured as secrets in SSM's parameter store.

While setting up an application or debugging some issue, I kept looking for env values for a set in different environments by logging in to the AWS console, which is painstakingly slow and hampers productivity.

Hence the tool.

Installation

Homebrew

brew tap dineshgowda24/dineshgowda
brew install ecsnv

Go

go install github.com/dineshgowda24/ecsnv@latest

Usage

  1. Fetching ENVs for a specific cluster and service

    1. Prints locally in the shell
    ecsnv --cluster <cluster_name> --service <service_name>
    1. Writes to a file
    ecsnv --cluster <cluster_name> --service <service_name> --file <file_name>
  2. Fetching ENVs for a specific cluster and service from a particular profile

    If a profile is not passed, then the default profile is used.

    1. Prints locally in the shell
    ecsnv --cluster <cluster_name> --service <service_name> --profile <aws_profile_name>
    1. Writes to a file
    ecsnv --cluster <cluster_name> --service <service_name> --file <file_name> --profile <aws_profile_name>
  3. You can ignore the cluster or service name. The application will list all the clusters and services in the profile with an easy-to-use interactive shell.

    1. Prints locally in the shell
    ecsnv
    1. Writes to a file
    ecsnv  --file <file_name>

Demo

Printing ENVs in terminal

Writing ENVs to file