aws-parameter-syncer

Keep file contents in sync with matching parameters in AWS Parameter Store

Variables

• VERBOSE - enable more logging if set to 1
• FREQUENCY - How often to check for changes (in seconds). Default is 300 seconds (5 minutes).
• AWS_ACCESS_KEY_ID - The AWS Access Key Id value
• AWS_SECRET_ACCESS_KEY - The AWS Secret Access Key value
• AWS_REGION - AWS Region to search (defaults to us-east-1)
• PARAM_PREFIX - The prefix for the parameters to keep in sync
  • resulting filenames will be the parameter name minus the PARAM_PREFIX
  • eg. Following parameters in parameter store: TESTING_param1.txt, TESTING_param2.conf export PARAM_PREFIX=TESTING_ TESTING_param1.txt will be compared against param1.txt TESTING_param2.conf will be compared against param2.conf
• CRED_FOLDER_PATH - path to where files are stored (defaults to /credentials)
  • in order to access the files outside of the container, make sure to mount this path into the container

Example Docker runs

This example checks AWS Parameter Store in the default us-east-1 region every 600 seconds (10 minutes) for parameters containing 'TESTING_'. The credentials in AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are used to access the AWS Parameter Store. The parameter values will be checked against files in the local folder 'credentials-dir' which is mounted into the container at '/credentials'.

docker run -d -e "FREQUENCY=600" \
        -e "VERBOSE=1" \
        -e "AWS_ACCESS_KEY_ID=MY_ACCESS_KEY_ID \
        -e "AWS_SECRET_ACCESS_KEY=MY_SECRET_KEY \
        -e "PARAM_PREFIX=TESTING_" \
        -v credentials-dir:/credentials \
        signiant/aws-parameter-syncer

This example checks AWS Parameter Store in the us-west-2 region every 120 seconds (2 minutes) for parameters containing 'TESTING_'. The credentials in AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are used to access the AWS Parameter Store. The parameter values will be checked against files in the local folder '/my/local/credentials/path' which is mounted into the container at '/some/other/path'.

docker run -d -e "FREQUENCY=120" \
        -e "AWS_ACCESS_KEY_ID=MY_ACCESS_KEY_ID \
        -e "AWS_SECRET_ACCESS_KEY=MY_SECRET_KEY \
        -e "AWS_REGION=us-west-2"
        -e "PARAM_PREFIX=TESTING_" \
        -e "CRED_FOLDER_PATH=/some/other/path"
        -v /my/local/credentials/path:/some/other/path \
        signiant/aws-parameter-syncer