https://github.com/sestrella/iecs
An interactive CLI for ECS
https://github.com/sestrella/iecs
aws ecs
Last synced: 6 months ago
JSON representation
An interactive CLI for ECS
- Host: GitHub
- URL: https://github.com/sestrella/iecs
- Owner: sestrella
- License: mit
- Created: 2024-08-17T05:47:15.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-26T18:02:30.000Z (11 months ago)
- Last Synced: 2025-07-26T22:13:42.851Z (11 months ago)
- Topics: aws, ecs
- Language: Go
- Homepage:
- Size: 18.6 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iecs
[](https://github.com/sestrella/iecs/actions/workflows/build.yml)
[](https://github.com/sestrella/iecs/actions/workflows/release.yml)
An interactive CLI for ECS to help with troubleshooting tasks like:
- Run remote commands on a container.
- Check the logs of a running container.
Compared to the AWS CLI, if no parameters are provided to the available
commands, the user would be requested to choose the desired resource from a
list of all tasks running on ECS.
## Installation
Nix users
The [templates](templates) directory contains a complete version of the code
snippets presented in this section. For a better user experience, setup
[sestrella](https://app.cachix.org/cache/sestrella) binary cache to download
pre-built binaries.
### devenv
Add the project input into the `devenv.yaml` file:
```yml
inputs:
iecs:
url: github:sestrella/iecs
overlays:
- default
```
To install the binary, add it to the `packages` section in the `devenv.nix`
file:
```nix
packages = [ pkgs.iecs ];
```
### flake
Add the project input into the `flake.nix` file:
```nix
inputs.iecs.url = "github:sestrella/iecs/nix_templates";
```
#### Using it as an overlay
Add the project overlay to `nixpkgs`:
```nix
pkgs = import nixpkgs {
inherit system;
overlays = [ iecs.overlays.default ];
};
```
Use the binary as derivation input for creating packages or shells:
```nix
buildInputs = [ pkgs.iecs ];
```
#### Using it as a package
Use the binary as derivation input for creating packages or shells:
```nix
buildInputs = [ iecs.packages.${system}.default ];
```
Non-Nix users
Clone the repository:
```
git clone https://github.com/sestrella/iecs.git
```
Download and [install](https://go.dev/dl/) the appropriate Go version. Check
the version constraint on the [go.mod](go.mod) to determine which version to
use.
Compile and generate the binary:
```
go build
```
Copy the binary to a directory in the `PATH`, like `~/.local/bin`:
```
cp iecs ~/.local/bin/iecs
```
> [!NOTE]
> Check that the path where the binary is copied exists in the `PATH`
> environment variable.
## Global Flags
The following global flags are available for all commands:
- `--cluster `: Filters the cluster list using the specified regex pattern.
- `--service `: Filters the service list using the specified regex pattern.
## References
- https://aws.github.io/aws-sdk-go-v2/docs/getting-started/
- https://github.com/golang-standards/project-layout