https://github.com/devopsartfactory/setup
Assume role management tool for multi AWS accounts
https://github.com/devopsartfactory/setup
assume-role aws cli
Last synced: 9 months ago
JSON representation
Assume role management tool for multi AWS accounts
- Host: GitHub
- URL: https://github.com/devopsartfactory/setup
- Owner: DevopsArtFactory
- License: apache-2.0
- Created: 2020-08-03T11:50:35.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2020-08-08T08:24:48.000Z (almost 6 years ago)
- Last Synced: 2025-04-01T18:16:21.148Z (about 1 year ago)
- Topics: assume-role, aws, cli
- Language: Go
- Homepage:
- Size: 36.1 KB
- Stars: 17
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# setup
Setup is a command line tool for assuming role. You can easily manage assume role and change role anytime you want.
I recommend this tool if you are managing multiple AWS account. Easily get assume credentials and paste it to your terminal.
## Install
* If you want to use setup command, then you need to set up..
- aws configure
```bash
$ brew tap devopsartfactory/devopsart
$ brew install setup
$ setup version
```
## How to use
### First init setup.
* Session name should be your original IAM user name in the account from which you log in through console.
```bash
$ setup init
? Your session name:
```
### Add new key
```bash
$ setup add
? Key: dev
? Role ARN: arn:aws:iam::1234567891011:role/XXXX
```
### Check assume roles
```bash
$ setup list
[current role list]
dev
```
### Use Assume role
- You can choose one key from the list or just specify the key next to command
```bash
$ setup
? Choose account: dev
Assume Credentials copied to clipboard, please paste it.
$ setup dev
Assume Credentials copied to clipboard, please paste it.
```
### Edit role ARN
```bash
$ setup edit
? Choose account to edit: dev
? New role ARN:
```
### Delete role
```bash
$ setup delete
? Choose account to delete: dev
dev is deleted
$ setup ls
[current role list]
```