https://github.com/mocyuto/ec2-search
ec2-search can search EC2 service easily. named "ec2s"
https://github.com/mocyuto/ec2-search
aws cargo cli ec2 ec2-search ec2s rust
Last synced: 6 months ago
JSON representation
ec2-search can search EC2 service easily. named "ec2s"
- Host: GitHub
- URL: https://github.com/mocyuto/ec2-search
- Owner: mocyuto
- License: apache-2.0
- Created: 2020-09-02T09:34:48.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-31T19:57:25.000Z (about 3 years ago)
- Last Synced: 2025-11-29T08:25:11.563Z (7 months ago)
- Topics: aws, cargo, cli, ec2, ec2-search, ec2s, rust
- Language: Rust
- Homepage:
- Size: 215 KB
- Stars: 15
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ec2-search
Search EC2 instance easily
## Installation
### Cargo Install
With Rust's package manager cargo, you can install via:
```shell script
$ cargo install ec2-search
```
If you install the latest master branch commit
```shell script
$ cargo install --git https://github.com/mocyuto/ec2-search --branch master
```
### Homebrew
macOS or Linux
```shell script
$ brew tap mocyuto/tap
$ brew install ec2-search
```
### Setup Completion
If you install by `brew` command, it is set **automatically**.
Otherwise, you run below.
```zsh
# zsh
$ ec2s completion zsh > /usr/local/share/zsh/site-functions/_ec2s
# bash
$ ec2s completion bash > /usr/local/etc/bash_completion.d/ec2s
```
## Usage
```shell script
$ ec2s help
```
### AWS credentials
ec2-search needs aws credentials, so you need to set credentials.
You can use Environment value or `"~/.aws/credentials"`.
#### profile
if set and not empty the value of the environment variable `AWS_PROFILE` otherwise `default`
### Instance
Search instance info.
```shell script
$ ec2s instance help
# or alias. see help
$ ec2s i help
```
#### info
display basic info
```shell script
$ ec2s i info -q api
ID Name Status Type
i-012345678 test-api1 running t2.micro
counts: 1
# display wide when set -o option
$ ec2s i info -q api -o wide
ID Name Status Type PrivateDNS PrivateIP AZ LifeCycle
i-012345678 test-api1 running t2.micro ip-10-10-10-10.ap-northeast-1.compute.internal 10.0.0.1 ap-northeast-1 spot
# display tag column when set -T option
$ ec2s i info -q api -T Name,env
ID Name Status Type Name env
i-012345678 test-api1 running t2.micro test-api1 staging
# display all tag columns when set --show-all-tags option
$ ec2s i info -q api --show-all-tags
ID Name Status Type Name env
i-012345678 test-api1 running t2.micro test-api1 staging
```
#### instance ids
display instance ids
```shell script
## like search
$ ec2s instance ids -q "api"
ID Name
i-012345678 test-api1
i-023456789 test-api2
counts: 2
```
#### instance ips
Display instance public and private IPs.
```shell script
$ ec2s instance ips -q "api"
Private IP Public IP Name
10.0.0.1 test-api1
10.0.0.2 test-api2
counts: 2
```
#### instance DNS name
Display instance public and private DNS name
```shell script
$ ec2s i dns -q api
Private DNS Public DNS Name
ip-10-10-10-10.ap-northeast-1.compute.internal test-api1
ip-10-10-10-11.ap-northeast-1.compute.internal test-api2
counts: 2
```
### Target Group
```shell script
$ ec2s target-group help
# or alias
$ ec2s tg help
```
#### Info
Display Target Group info
```shell script
$ ec2s tg info -q api
Name TargetType LB
aaaaa-api ip ["aaaaa-bbbb-apialb"]
bbbbb-api ip ["bbbbb-cccc-apiinteralb"]
api-web instance ["prd-api-web"]
counts: 5
```
#### Target Health
Display Target Health
```shell script
$ ec2s tg health -q api-web
ID Port Status
i-01002020202000101 80 healthy
counts: 1
```
### Auto Scaling Group
```shell script
$ ec2s auto-scaling-group help
# or alias
$ ec2s asg help
```
#### Info
Display Auto Scaling Group info
```shell script
$ ec2s asg info -q eks
Name Instances Desired Min Max
prd-eks-autoscale 7 7 1 40
prd-eks-stateful 6 6 4 20
stg-eks-autoscale 1 1 1 20
stg-eks-stateful 2 2 1 10
counts: 4
```
#### Instances
Display Auto Scaling Group Instances.
```shell script
$ ec2s asg inst -q stg-eks-api-autoscale
ID LifeCycle InstanceType AZ Status
i-01010101010101011 InService t3.medium ap-northeast-1c Healthy
counts: 1
```