1- # rds-iam-dsn
1+ # rds-iam-to- dsn
22
33A CLI that resolves a ` postgres+rds-iam://... ` URL into a usable tokenized PostgreSQL DSN and prints it to stdout.
44
@@ -7,13 +7,13 @@ Use this when you want to script `psql`, `pg_dump`, or other Postgres tools with
77## Installation
88
99``` bash
10- go install github.com/corbaltcode/go-libraries/cmd/rds-iam-dsn@latest
10+ go install github.com/corbaltcode/go-libraries/cmd/rds-iam-to- dsn@latest
1111```
1212
1313Or build from source:
1414
1515``` bash
16- cd ./cmd/rds-iam-dsn
16+ cd ./cmd/rds-iam-to- dsn
1717go build
1818```
1919
@@ -27,7 +27,7 @@ go build
2727## Usage
2828
2929``` bash
30- rds-iam-dsn ' <postgres+rds-iam-url>'
30+ rds-iam-to- dsn ' <postgres+rds-iam-url>'
3131```
3232
3333- Database path is optional. If omitted, ` pgutils ` defaults DB name to the username.
@@ -38,33 +38,33 @@ rds-iam-dsn '<postgres+rds-iam-url>'
3838Resolve DSN only:
3939
4040``` bash
41- rds-iam-dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp'
41+ rds-iam-to- dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp'
4242```
4343
4444Use with ` psql ` in a script:
4545
4646``` bash
47- DSN=" $( rds-iam-dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
47+ DSN=" $( rds-iam-to- dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
4848psql " $DSN "
4949```
5050
5151Or directly:
5252
5353``` bash
54- psql " $( rds-iam-dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
54+ psql " $( rds-iam-to- dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
5555```
5656
5757Use with ` pg_dump ` :
5858
5959``` bash
60- DSN=" $( rds-iam-dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
60+ DSN=" $( rds-iam-to- dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp' ) "
6161pg_dump " $DSN " > myapp.sql
6262```
6363
6464Cross-account role assumption:
6565
6666``` bash
67- rds-iam-dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp?assume_role_arn=arn:aws:iam::123456789012:role/db-connect&assume_role_session_name=rds-iam-dsn '
67+ rds-iam-to- dsn ' postgres+rds-iam://app_user@mydb.abc123.us-east-1.rds.amazonaws.com:5432/myapp?assume_role_arn=arn:aws:iam::123456789012:role/db-connect&assume_role_session_name=foo '
6868```
6969
7070## Troubleshooting
0 commit comments