e1s

README

E1S - Easily Manage AWS ECS Resources in Terminal 🐱✨

e1s is a terminal application to easily browsing and manage AWS ECS resources, with a focus on Fargate. Inspired by k9s.

AWS credentials and configuration

e1s uses the default aws-cli configuration. It does not store or send your access and secret key anywhere. The access and secret key are used only to securely connect to AWS API via AWS SDK. Both profile and region are overridable via the AWS_PROFILE and AWS_REGION.

Installation

e1s is available on Linux, macOS and Windows platforms.

• Binaries for Linux, Windows and Mac are available in the release page.
• Via Homebrew for maxOS or Linux

brew install keidarcy/tap/e1s

Features

Basic

• Read only mode
• Describe clusters
• Describe services
• Describe tasks
• Describe containers
• Describe task definitions
• Describe service autoscaling
• Show Metrics
  • CPUUtilization
  • MemoryUtilization
• Show autoscaling target and policy
• Show log events(Only support awslogs logDriver)
• Open selected resource in browser(Support new UI(v2))
• SSH into container
• Edit service
  • Desired count
  • Force new deployment
  • Task definition family
  • Task definition revision
• Register new task definition

SSH into container (ECS Exec)

ssh demo

If you experience any issue with ssh, please check documents and aws-ecs-exec-checker.

Use ctrl + d to end ssh session.

tips: check task role policy

Edit service(Docs)

edit service demo

• Force new deployment
• Desired tasks
• Task definition family
• Task definition revision

Register task definition(Docs)

Register task definition

Usage

Run e1s

Make sure you have the AWS CLI installed and properly configured with the necessary permissions to access your ECS resources.

Using default profile

$ e1s

Using my-profile profile

$ AWS_PROFILE=my-profile e1s

read only mode

$ AWS_PROFILE=my-profile e1s -readonly

current e1s version

$ e1s -version

Key Bindings

Key	Description
j, ↓	Select next item
k, ↑	Select previous item
→, Enter	Enter current resource/SSH
←, Esc	Go to previous view
d	Describe selected resource(show json)
t	Describe task definition
w	Describe service events
a	Show service auto scaling
m	Show service metrics(CPUUtilization/MemoryUtilization)
r	Reload resources
l	Show log events(Only support awslogs logDriver)
v	List task definition revisions
f	Toggle full screen
e	Edit resource
b	Open selected resource in AWS web console
ctrl + c	Quit
ctrl + d	Exit from container

Logs

tail -f /tmp/e1s_debug.log

Feature Requests & Bug Reports

If you have any feature requests or bug reports, please submit them through GitHub Issues.

Publish new version

• Bump version
• make tag

Thanks

• tview
• k9s
• ecsview

License

MIT