keboola/aws-parameter-filler

This package is abandoned and no longer maintained. No replacement package was suggested.

Fills parameters from AWS SSM into an .env file

0.3.0 2020-06-01 12:31 UTC

Requires

• php: >=7.1
• aws/aws-sdk-php: ^3.138
• keboola/php-component: ^4.1|^5.0|^6.0|^7.0|^8.0
• symfony/dotenv: ^4.1|^5.0

Requires (Dev)

• keboola/coding-standard: ^9.0
• keboola/php-temp: ^1.0
• php-parallel-lint/php-parallel-lint: ^1.0
• phpstan/phpstan: ^0.12
• phpunit/phpunit: ^9.1
• symfony/process: ^4.0|^5.0

MIT

README

Fetches parameters from AWS SSM from a given parameter namespace (prefix) and region. Stores the parameters as an .env file.

Usage

The executable takes thee parmeters:

• destination file
• parameter namespace (starts and ends with slash)
• AWS region

Example:

aws-parameter-filler .env /company/my-application/ us-east-1

AWS credentials with GetParametersByPath and GetParameter permissons must be available in any of the standard ways.

Development

Clone this repository and init the workspace with following command:

git clone https://github.com/keboola/aws-parameter-filler
cd aws-parameter-filler
docker-compose build

Use test-cf-stack.json to create a testing stack. Create an access key for the generated user. Also manually create SecureString parameter, which cannot be created with cloudformation template:

Name: /keboola/$STACKNAME/aws-parameter-filler/six
Value: SuperSecretValue
Type: SecureString
Description: Parameter filler test - Encrypted parameter

Set the following environment variables (or use .env.template):

• AWS_ACCESS_KEY_ID - From the created access key.
• AWS_SECRET_ACCESS_KEY - From the created acces key.
• TEST_NAMESPACE - The value of the Namespace stack output.
• TEST_REGION - The value of the Region stack output.

Run the test suite using this command:

docker-compose run

Composer Integration

The utility is usable with composer. Add the library to your project by running:

composer require keboola/aws-parameter-filler

Then add the following to your composer.json:

"scripts": {
	"get-parameters": "aws-parameter-filler .env /my-stack/ us-east-1"
}

Running composer get-parameters will then download parameters with the specified namespace and store them in .env file of the application root. Environment variables may also be used:

"scripts": {
	"get-parameters": "aws-parameter-filler .env /keboola/$KEBOOLA_STACK/runner-sync-api/ $KEBOOLA_STACK_REGION"
}

License

MIT licensed, see LICENSE file.