79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
|
# Psenv
|
||
|
|
|
||
|
|
**Work in progress**
|
||
|
|
|
||
|
|
Shim to load environment variables from [AWS Systems Manager Parameter Store](https://aws.amazon.com/systems-manager/features/#Parameter_Store) into ENV.
|
||
|
|
|
||
|
|
Psenv currently heavily borrows from [Dotenv](https://github.com/bkeepers/dotenv), mainly because I use it in roughly every project so it made since for the APIs to match.
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
### Rails
|
||
|
|
|
||
|
|
Add this line to your application's Gemfile:
|
||
|
|
|
||
|
|
```ruby
|
||
|
|
gem 'psenv-rails'
|
||
|
|
```
|
||
|
|
|
||
|
|
And then execute:
|
||
|
|
|
||
|
|
$ bundle
|
||
|
|
|
||
|
|
Set the `PARAMETER_STORE_PATH` environment variable with the AWS Parameter
|
||
|
|
Store path that you wish to load.
|
||
|
|
|
||
|
|
### Plain Ruby
|
||
|
|
|
||
|
|
Add this line to your application's Gemfile:
|
||
|
|
|
||
|
|
```ruby
|
||
|
|
gem 'psenv'
|
||
|
|
```
|
||
|
|
|
||
|
|
And then execute:
|
||
|
|
|
||
|
|
$ bundle
|
||
|
|
|
||
|
|
Set the `PARAMETER_STORE_PATH` environment variable with the AWS Parameter
|
||
|
|
Store path that you wish to load.
|
||
|
|
|
||
|
|
Finally, trigger the loading:
|
||
|
|
|
||
|
|
```ruby
|
||
|
|
require 'psenv'
|
||
|
|
Psenv.load
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
* Create a variable in parameter store using the AWS console or the CLI
|
||
|
|
|
||
|
|
```
|
||
|
|
aws ssm put-parameter \
|
||
|
|
--name /psenv/test/API_KEY \
|
||
|
|
--value "api_key_value" \
|
||
|
|
--type String
|
||
|
|
```
|
||
|
|
|
||
|
|
* Ensure your application has at least the following IAM permissions
|
||
|
|
* `ssm:GetParametersByPath` on resource `arn:aws:ssm:::parameter/psenv/test/*`
|
||
|
|
* Set the `PARAMETER_STORE_PATH` environment variable to `/psenv/test/`
|
||
|
|
|
||
|
|
This example will set the `API_KEY` to `api_key_value` and make it available to
|
||
|
|
your application.
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
||
|
|
|
||
|
|
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
||
|
|
|
||
|
|
## Contributing
|
||
|
|
|
||
|
|
Bug reports and pull requests are welcome on GitHub at https://github.com/atomaka/psenv.
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
|