gitlabbin / param_api

AWS ssm parameter store as keystore service

AWS Parameter Store API

A helpful Golang-application that provides a HTTP endpoint to retrieve parameters from AWS Parameter Store.

STOP WORRING ABOUT HAVING TO REVISION CONTROL ENV VARIABLES, STOP HAVING TO UPLOAD SECRETS TO S3!

Design

For AWS paramater store, the entry should be in the format:

landscape.environment.application_name.KEY_NAME

To revision the same entry, edit it, bump the version number in the description, and change the value.

NOTE:

AWS Param Store keeps the history of changed values. If you want to use an old version, you simply have to search for the key name with a description of the version you want to access.

Installation

Clone the repo

git clone [email protected]:Sjeanpierre/param_api.git

Build the binary

make build

Build the Docker image

AWS_REGION={SOME_REGION} TAG={SOME_DOCKER_IMAGE_TAG} docker-compose -f docker/docker-compose.yml build

Push the Docker image

You can upload this to ECR, Dockerhub, or any other prefered docker image revision control.

Implementation Options

Type	Description
Standalone	You can set this application up by building the Docker image for it and running it on a single server. You will need to allow http requests to that server on port 8080
Multi-Container	You can setup this application through a multi-container approach through AWS Elastic Beanstalk, AWS ECS, or on any server using docker-compose with multiple container definitions.

The param-store-api will return JSON data with the environment variables( key/value ). It's up to you if you want to perform the HTTP request via command line and then export the values, or if you want your application make the HTTP request and interpret the variabls.

Usage

Run the image

AWS_REGION={SOME_REGION} TAG={SOME_DOCKER_IMAGE_TAG} docker-compose -f docker/docker-compose.yml up

Retrieve App config as a single JSON document from AWS SSM parameter store