aws.el

Emacs major modes wrapping the AWS CLI.

aws.el is a magit style interface to the AWS command line client. It makes heavy use of of thetransientpackage andtabulated-list-modeto make the AWS command line interface as discoverable, easy and fast to navigate as possible.

Install

This is a free time projects of mine, which is still in the very beginning and I currently add functionality as I see use cases for it in my day to day life. Therefore I don't want to add it to a package repository like melpayet, because I see it as pre- Alpha software at the moment.

However you could either use straight.elor directly clone it from Github and load it viause-package like I do:

(use-packageaws-mode
:bind;;some functions which make sense to bind to something
("C-c a a".aws)
("C-c a l".aws-login)
("C-c a n".aws-organizations-get-account-name)
("C-c a i".aws-organizations-get-account-id)
:load-path"~/.emacs.d/packages/awscli"
:custom
(aws-vaultt);;when t use aws-vault cmd to get into aws session
(aws-output"json");;optional: yaml, json, text (default: yaml)
(aws-organizations-account"root"));;profile of organizations account. organizations commands are automatically executed against this account, when specified

(use-packageaws-evil
:after(aws-mode evil)
:load-path"~/.emacs.d/packages/awscli")

Design

The general design is to have atabulated list view for every AWS CLI supported service, which lists up the existing resources of that service.

You should be able to interact with each element of the list via different key presses. Flags and additional arguments should be easily activated in transient views (See screenshot).

You should also always be able to press?in every tabulated list view to get a help menu (See screenshot), which shows all the possible actions and the respective shortcut.

This general Emacs Mode design should make it possible to learn the package just by navigating around and typing?.As you get familiar with shortcuts you should be able to navigate and do actions a lot faster then typing out the commands in the AWS CLI itself.

Features

• Switch between your configured profiles
• Login to the AWS UI viaaws-vault login
• Works with the--profileflag as well as aws-vault sessions
• CloudFormation
  • List Stacks
  • Delete Stack
• CloudWatch
  • List CloudWatch Alarms in Account
    • Enable/Disable ActionsEnabled field
• Lambda
  • List Lambda Functions in Account
  • Describe Lambda Function
  • Invoke Lambda Function and see last invocation result
  • Get latest logs
  • Get all Log Groups
  • List Event Source Mappings
    • Describe Event Source Mapping
    • Update Event Source Mapping
• Logs
  • List Log Groups in Account
  • Get Log Streams of a Log Group
    • Describe Log Stream
    • Get Log Events
• S3
  • List S3 Buckets
  • Create Bucket

Features Showcases

Main View with Switch Profile Auto Completion open

Help Menu Lambda

Transient View Lambda Function Invoke

Update Inline Policy of a Group

update-inline-policy-of-group.mp4

Configuration

Activate aws-vault for profiles

Set(aws-vault t)to use aws-vault to login to a profile. (aws-vault nil)or omitting the setting uses the--profileflag of the AWS CLI itself.

Current Limitations

AWS-Vault MFA Shell Prompts don't work in aws.el

For now set theAWS_VAULT_PROMPTenvironment variable to a UI utility like osascript.

Inspirations

This project is inspired by other great Emacs packages like:

• magit
• kubel