execs

README

execs

Introduction

execs is a program that helps you to access the ECS task interactively by using the ssm session-manager-plugin. It uses the ECS execute command API with the command /bin/sh. It also highly refer the similar and pre-existing program ecsgo but uses the AWS SDK for GO v2. Since the motivation for developing the program is personal purpose to study about Golang, the program could be unstable.

Installation

From the release, you can download the package directly.

MacOS

You can use brew to install the package.

brew tap daeho-ro/repo
brew install execs

Windows

You can use chocolatey to install the package.

choco install execs

You also can use scoop to install the custom application as follows.

scoop install https://raw.githubusercontent.com/daeho-ro/execs-chocolatey-package/main/execs.json

AWS Profile

In order to use execs, you need to pass the AWS credentials. As far as I know, the best way to do it is using aws-vault.

aws-vault exec <profile> -- execs

Please check the aws-vault page.

Required permissions

This program use the AWS IAM permissions as follows:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "execs-iam-permissions",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeRegions",
                "ecs:DescribeTasks",
                "ecs:ExecuteCommand",
                "ecs:ListClusters",
                "ecs:ListTasks"
            ],
            "Resource": "*"
        }
    ]
}