# 使用 Homebrew, MacPorts 安装 amazon-ecs-cli

查看 amazon-ecs-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:amazon-ecs-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install amazon-ecs-cli
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install ecs-cli
```

  证据: MacPorts ports tree: devel/ecs-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:amazon-ecs-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/amazon-ecs-cli>
- **版本:** 1.21.0
- **来源摘要:** CLI for Amazon ECS to manage clusters and tasks for development
- **主页:** <https://aws.amazon.com/ecs/>
- **仓库:** <https://github.com/aws/amazon-ecs-cli>
- **上游文档:** <https://aws.amazon.com/ecs/>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/aws/amazon-ecs-cli/archive/refs/tags/v1.21.0.tar.gz>
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- ecs-cli (cli)
- ecs-cli (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 1.21.0
- 本地数据: OK
- 上游仓库: https://github.com/aws/amazon-ecs-cli
- 检测到的最新版本: v1.21.0 (当前)
- 信息: No package-manager update timestamp was available.
## 项目历史与用法

Amazon ECS CLI was AWS's higher-level command-line tool for Amazon Elastic Container Service workflows, especially local development patterns that used Docker Compose-style definitions to create, update, and inspect ECS clusters, services, and tasks.

### 项目历史

The aws/amazon-ecs-cli repository was created in September 2015. Its README describes a CLI for Amazon ECS that provides high-level commands for creating, updating, and monitoring clusters and tasks from a local development environment, as an alternative to using the AWS Management Console or lower-level AWS CLI commands.

The project tracked major ECS platform features through its changelog: named profiles and Windows support in 1.0.0, Fargate support in 1.1.0, service discovery, private registry credentials, Docker Compose v3 support, local commands, FireLens, EFS, and AWS Graviton2 support by the final 1.21.0 release line.

### 采用历史

The ECS CLI fit a specific packaging niche: developers wanted a small binary that translated familiar Docker Compose workflows into ECS resources before broader opinionated deployment CLIs existed. Homebrew packaging made it especially convenient for macOS and Linux developers working against ECS and Fargate.

AWS later placed AWS Copilot at the top of the ECS CLI README, describing Copilot as a generally available CLI for building, releasing, and operating container apps on ECS and Fargate. The GitHub repository metadata now marks amazon-ecs-cli as archived, which makes it a historical package for older ECS workflows rather than the forward-looking AWS container CLI.

### 使用方式

Users configured AWS credentials, region, cluster name, ECS profiles, and cluster configurations, then used commands such as ecs-cli configure, ecs-cli up, ecs-cli compose service up, ecs-cli ps, and ecs-cli logs. The README documents configuration storage in ~/.ecs on macOS/Linux and C:\Users\<username>\AppData\local\ecs on Windows, with optional use of ~/.aws/credentials through --aws-profile or AWS_PROFILE.

The tool mattered most when a project already had docker-compose.yml and ecs-params.yml files and wanted an incremental path to ECS tasks and services. For new AWS workflows, the README's Copilot banner is the key adoption signal: AWS redirected the developer-experience story to Copilot while leaving ECS CLI for compatibility.

### 为什么软件包爱好者会关心

Amazon ECS CLI is a classic cloud CLI lifecycle package: very useful during a platform transition, then effectively superseded while still present in package indexes for users with old automation.

It is also a reminder that package-manager descriptions can outlive a tool's strategic status. The binary still documents install links and configuration behavior, but the upstream repository being archived changes how maintainers should frame it.

### 时间线

- 2015-09-30: aws/amazon-ecs-cli repository is created.
- 2017: v1.0.0 adds named ECS profiles, cluster configurations, and Windows support.
- 2017: v1.1.0 adds AWS Fargate support.
- 2020-07-07: v1.20.0 adds EFS support in compose up workflows.
- 2020-12-21: v1.21.0 adds container dependencies and Graviton2 instance support.
- 2025: GitHub metadata shows the repository archived.

### Related projects

- AWS CLI provides the lower-level ECS API command surface.
- AWS Copilot CLI is the AWS-recommended successor-style developer CLI for container applications on ECS and Fargate.
- Docker Compose and ecs-params.yml are central adjacent formats for ECS CLI workflows.

### 来源

- <https://api.github.com/repos/aws/amazon-ecs-cli>
- <https://api.github.com/repos/aws/amazon-ecs-cli/releases?per_page=5>
- <https://raw.githubusercontent.com/aws/amazon-ecs-cli/master/CHANGELOG.md>
- <https://raw.githubusercontent.com/aws/amazon-ecs-cli/master/README.md>


## 安全说明

infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.ecs
- Windows: C:\Users\<username>\AppData\local\ecs

## Credential files

- Unix: ~/.aws/credentials, ~/.ecs
- Windows: C:\Users\<username>\AppData\local\ecs
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** amazon-ecs-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 其他软件包管理器记录

- MacPorts - ecs-cli: installed executable or alias match | MacPorts ports tree: devel/ecs-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 相关链接

- [Cloud CLI packages](https://pkg.so/zh-hans/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Secret-risk packages](https://pkg.so/zh-hans/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [e1s](https://pkg.so/zh-hans/brew/e1s/) - Shares pkgdb curated category or tags: aws, cli, cloud-infrastructure, ecs, fargate.
- [ecs-deploy](https://pkg.so/zh-hans/brew/ecs-deploy/) - Shares pkgdb curated category or tags: aws, cli, cloud-infrastructure, containers, ecs.
- [container-compose](https://pkg.so/zh-hans/brew/container-compose/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, containers, docker-compose.
- [colima](https://pkg.so/zh-hans/brew/colima/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, containers.
- [oras](https://pkg.so/zh-hans/brew/oras/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, containers.
- [skopeo](https://pkg.so/zh-hans/brew/skopeo/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, containers.
- [aws-iam-authenticator](https://pkg.so/zh-hans/brew/aws-iam-authenticator/) - Shares pkgdb curated category or tags: aws, cli, cloud-infrastructure.
- [eksctl](https://pkg.so/zh-hans/brew/eksctl/) - Shares pkgdb curated category or tags: aws, cli, cloud-infrastructure.
- [awscli](https://pkg.so/zh-hans/brew/awscli/) - Local package facts share a topical domain. Shared terms: amazon, aws, cli, cloud, cloud-infrastructure.

## Combined YAML source

View the package source record on GitHub. [combined/amazon-ecs-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/amazon-ecs-cli.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
