# ecs-lens

> A Node.js CLI to view ECS deployment history

Latest version **0.1.0** (published 2022-03-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install ecs-lens
pnpm add ecs-lens
yarn add ecs-lens
bun add ecs-lens
```

Provides the command `ecs-lens`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.0 |
| Published | 2022-03-11 |
| First published | 2022-03-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 11.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Kalvin Vasconcellos |
| Maintainers | 0xkalvin |

## Links

- npm: https://www.npmjs.com/package/ecs-lens
- Repository: https://github.com/0xkalvin/ecs-lens
- Homepage: https://github.com/0xkalvin/ecs-lens#readme
- Issues: https://github.com/0xkalvin/ecs-lens/issues
- npm.io page: https://npm.io/package/ecs-lens

## Dependencies (4)

- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [yargs](https://npm.io/package/yargs.md) ^17.3.1
- [cli-table3](https://npm.io/package/cli-table3.md) ^0.6.1
- [@aws-sdk/client-ecs](https://npm.io/package/@aws-sdk/client-ecs.md) ^3.53.0

## Recent versions

- 0.1.0 (latest) — 2022-03-11
- 0.0.2 — 2022-03-07
- 0.0.1 — 2022-03-06

## README

# ecs-lens

A command-line interface to view ECS deployment history. Searching for recent deployments across multiple services can be quite inconvenient, specially when you need that information fast. This tool helps you to quickly get an ordered list of deployments that went out for a particular ECS cluster and when they exactly happened.

## Install

```
npm i -g ecs-lens
```

## Usage

All deployments
```bash
ecs-lens --region us-east-1 --cluster my-microservices
```

Filter by period
```bash
# Deployments from last 2 days
ecs-lens --region us-east-1 --cluster my-microservices -p d2

# Deployments from last 12 hours
ecs-lens --region us-east-1 --cluster my-microservices -p h12

# Deployments from last 40 minutes
ecs-lens --region us-east-1 --cluster my-microservices -p m40
```

Options
```
Usage: ecs-lens [options]

Options:
  -r, --region   AWS region                                           [required]
  -c, --cluster  ECS cluster name                                     [required]
  -p, --period   (Optional) The period from now in which deployments should be searched
                 for. It supports filtering by last X days/hours/minutes. The
                 format must be the unit followed by the value. For instance: d2
                 (last 2 days), h30 (last 30 hours), m15 (last 15 minutes).
  -h, --help     Show help                                             [boolean]
  -v, --version  Show version number                                   [boolean]

Examples:
  ecs-lens --region us-east-1 --cluster mycluster
  ecs-lens -r us-east-1 -c mycluster -p d2

Missing required arguments: r, c
```

---
_Source: https://npm.io/package/ecs-lens · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._