https://github.com/adhocteam/ssm
AWS SSM Paramater Store CLI
https://github.com/adhocteam/ssm
aws aws-ssm golang ssm
Last synced: 5 months ago
JSON representation
AWS SSM Paramater Store CLI
- Host: GitHub
- URL: https://github.com/adhocteam/ssm
- Owner: adhocteam
- License: mit
- Created: 2019-06-26T05:06:45.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-07-01T18:01:19.000Z (almost 2 years ago)
- Last Synced: 2025-08-14T19:33:36.913Z (11 months ago)
- Topics: aws, aws-ssm, golang, ssm
- Language: Go
- Homepage:
- Size: 57.6 KB
- Stars: 11
- Watchers: 149
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## SSM
### About
This is a command line interface to the [AWS SSM Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html).
It's designed to be simple and easy to remember. A more featureful alternative is [Chamber](https://github.com/segmentio/chamber).
### Install
[Binaries](https://github.com/adhocteam/ssm/releases) are available for Linux and MacOS.
To install from source, install a [Go](https://golang.org/dl/) compiler and:
```
go install github.com/adhocteam/ssm@latest
```
### Usage
#### List params
All parameters:
```
ssm ls
```
Params containing `/my-app`
```
ssm ls /my-app
```
Params containing `/my-app` with secrets printed in plaintext
```
ssm ls --secrets /my-app
```
#### Get the value of a param
```
ssm get /myapp/staging/key
```
You can use the value of a parameter in a bash script like
```
PGPASSWORD=$(ssm get /myapp/prod/pgpass)
```
#### Set param key value
```
ssm set /myapp/staging/version 27
```
#### Delete param
```
ssm rm /myapp/staging/version
```
### Specifying the AWS Profile
The app will either rely on the `AWS_PROFILE` environment variable,
or you can set one with the `-p` and `--profile` flag. For each example above,
add that flag, i.e. `ssm -p myprofile ls myapp` to override the `AWS_PROFILE`.