compwright / aws-env
Load environment variables securely from AWS SSM
Installs: 3 647
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: ^8.2
- composer-runtime-api: ^2.2
- aws/aws-sdk-php: ^3.295
- symfony/console: ^7.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.46
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^10.5
README
Command-line script to obtain service configuration environment and secrets securely from AWS SSM.
Configuration
Configuration can be provided via command line options or environment variables:
This script can find AWS credentials in the usual ways, including:
- If running on EC2, by assuming an IAM role (recommended)
- By reading the
~/.aws/config
and~/.aws/credentials
files, with the optionalAWS_PROFILE
environment variable - Explicitly with the
AWS_REGION
,AWS_ACCESS_KEY_ID
andAWS_SECRET_ACCESS_KEY
environment variables
Usage
Usage:
aws-env [options]
Options:
-p, --path=PATH Parameter key path [default: "/"]
-f, --format=FORMAT Output format: dotenv, env, export [default: "env"]
-h, --help Display help for the given command. When no command is given display help for the bin/aws-env command
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi|--no-ansi Force (or disable --no-ansi) ANSI output
-n, --no-interaction Do not ask any interactive question
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
For example, to start a shell with a new environment consisting only of the items pulled from AWS SSM + $PATH:
env -i -S"$(bin/aws-env -p /my_app/development) PATH=$PATH" && /bin/bash
License
MIT License