aws-simple-ec2-cli:一个CLI工具，可简化启动，连接和终止EC2实例的过程

<h1>AWS Simple EC2 CLI</h1> <h4>A CLI tool that simplifies the process of launching, connecting and terminating an EC2 instance.</h4> <p> <a href="https://golang.org/doc/go1.15"> <img src="https://img.shields.io/github/go-mod/go-version/aws/amazon-ec2-metadata-mock?color=blueviolet" alt="go-version"> </a> <a href="https://opensource.org/licenses/Apache-2.0"> <img src="https://img.shields.io/badge/License-Apache%202.0-ff69b4.svg?color=orange" alt="license"> </a> <a href="https://goreportcard.com/report/github.com/awslabs/aws-simple-ec2-cli"> <img src="https://goreportcard.com/badge/github.com/awslabs/aws-simple-ec2-cli" alt="go-report-card"> </a> </p> <div> <hr> </div> ## Summary In order to launch a new EC2 instance, customers need to specify a lot of options, and it can be a slow and overwhelming task. It requires users to have an initial network stack (VPC-Id/Subnet-Id/Security-Groups), remote login, and many more. Often times, we require EC2 instance for adhoc testing for a short period of time without requiring complex networking infrastructure in place. AWS Simple EC2 CLI aims to solve this issue and make it easier for users to launch, connect and terminate EC2 instances with a single command ## Major Features - Launch an instance using single command - Connect to an instance using single command - Terminate an instance using single command - Interactive mode that help users to decide parameters to use - Config file for more convenient launch ## Installation and Configuration ### Install AWS CLI To execute the CLI, you will need AWS credentials configured. Take a look at the [AWS CLI configuration documentation](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#config-settings-and-precedence) for details on the various ways to configure credentials. Alternatively, you can try out the AWS Simple EC2 CLI by populating following environment variables: ``` export AWS_ACCESS_KEY_ID="..." export AWS_SECRET_ACCESS_KEY="..." # Set default Region (optional) export AWS_REGION="us-east-1" ``` ### Install w/ Homebrew ``` brew tap aws/tap brew install aws-simple-ec2-cli ``` ### Install w/ Curl #### MacOS/Linux ``` curl -Lo simple-ec2 https://github.com/awslabs/aws-simple-ec2-cli/releases/download/v0.7.0/simple-ec2-`uname | tr '[:upper:]' '[:lower:]'`-amd64 chmod +x simple-ec2 ``` #### ARM Linux ``` curl -Lo simple-ec2 https://github.com/awslabs/aws-simple-ec2-cli/releases/download/v0.7.0/simple-ec2-linux-arm ``` ``` curl -Lo simple-ec2 https://github.com/awslabs/aws-simple-ec2-cli/releases/download/v0.7.0/simple-ec2-linux-arm64 ``` #### Windows ``` curl -Lo simple-ec2 https://github.com/awslabs/aws-simple-ec2-cli/releases/download/v0.7.0/simple-ec2-windows-amd64.exe ``` ## Examples ### Launch **All CLI Options** ``` $ simple-ec2 launch -h Launch an Amazon EC2 instance with the default configurations. All configurations can be overridden by configurations provided by configuration files or user input. Usage: simple-ec2 launch [flags] Flags: -a, --auto-termination-timer int The auto-termination timer for the instance in minutes -b, --boot-script string The absolute filepath to a bash script passed to the instance and executed after the instance starts (user data) -h, --help help for launch -p, --iam-instance-profile string The profile containing an IAM role to attach to the instance -m, --image-id string The image id of the AMI used to launch the instance -t, --instance-type string The instance type of the instance -i, --interactive Interactive mode -k, --keep-ebs Keep EBS volumes after instance termination -l, --launch-template-id string The launch template id with which the instance will be launched -v, --launch-template-version string The launch template version with which the instance will be launched -r, --region string The region where the instance will be launched -c, --save-config Save config as a JSON config file -g, --security-group-ids strings The security groups with which the instance will be launched -s, --subnet-id string The subnet id in which the instance will be launched --tags stringToString The tags applied to instances and volumes at launch (Example: tag1=val1,tag2=val2) (default []) ``` **Single Command Launch** ``` $ simple-ec2 launch +--------------------------------------+--------------------------+ | Region | us-east-1 | +--------------------------------------+--------------------------+ | VPC | vpc-example | +--------------------------------------+--------------------------+ | Subnet | subnet-example | +--------------------------------------+--------------------------+ | Instance Type | t1.micro | +--------------------------------------+--------------------------+ | Image | ami-047a51fa27710816e | +--------------------------------------+--------------------------+ | Security Group | sg-example | +--------------------------------------+--------------------------+ | Keep EBS Volume(s) After Termination | false | +--------------------------------------+--------------------------+ | Auto Termination Timer in Minutes | None | +--------------------------------------+--------------------------+ | EBS Volumes | /dev/xvda(gp2): 8 GiB | +--------------------------------------+--------------------------+ [ yes / no ] Please confirm if you would like to launch instance with following options: yes Options confirmed! Launching instance... Launch Instance Success! Instance ID: i-123example ``` **Single Command Launch With Flags** ``` $ simple-ec2 launch -r us-east-2 -m ami-123example -t t2.micro -s subnet-123example -g sg-123example +--------------------------------------+--------------------------+ | Region | us-east-2 | +--------------------------------------+--------------------------+ | VPC | vpc-example | +--------------------------------------+--------------------------+ | Subnet | subnet-123example | +--------------------------------------+--------------------------+ | Instance Type | t1.micro | +--------------------------------------+--------------------------+ | Image | ami-123example | +--------------------------------------+--------------------------+ | Security Group | sg-123example | +--------------------------------------+--------------------------+ | Keep EBS Volume(s) After Termination | false | +--------------------------------------+--------------------------+ | Auto Termination Timer in Minutes | None | +--------------------------------------+--------------------------+ | EBS Volumes | /dev/xvda(gp2): 8 GiB | +--------------------------------------+--------------------------+ [ yes / no ] Please confirm if you would like to launch instance with following options: yes Options confirmed! Launching instance... Launch Instance Success! Instance ID: i-123example ``` **Interactive Mode Launch** ``` $ simple-ec2 launch -i +--------+----------------+---------------------------+ | OPTION | REGION | DESCRIPTION | +--------+----------------+---------------------------+ | 1. | ap-northeast-1 | Asia Pacific (Tokyo) | +--------+----------------+---------------------------+ | 2. | ap-northeast-2 | Asia