:warning: 即将停止支持 :warning:

AWS Copilot CLI 将于 2026 年 6 月 12 日停止支持。在此之后，该工具将不再接收更新、安全补丁或技术支持。我们建议您尽快迁移到其他解决方案，以确保持续的支持和对最新功能的访问。 如需更多信息，请参阅我们的 博客文章。

AWS Copilot CLI

在 AWS 上构建、发布和运行容器化应用。

• 文档: https://aws.github.io/copilot-cli/

AWS Copilot CLI 是一款面向开发者的工具，用于在 AWS App Runner 或 Amazon ECS on AWS Fargate 上构建、发布和运行生产就绪的容器化应用。

使用 Copilot 可以：

• 通过一条命令，从 Dockerfile 部署可在 AWS 上运行的生产级可扩展服务。
• 为您的服务添加数据库或将密钥注入服务中。
• 从单个微服务扩展到应用程序中的多个相关微服务集合。
• 跨区域和账户设置测试和生产环境。
• 设置 CI/CD 流水线，将您的服务发布到相应环境。
• 从终端监控和调试您的服务。

安装

使用 Homebrew 安装：

$ brew install aws/tap/copilot-cli

若要手动安装，我们会在 GitHub 发布页面上提供二进制文件：

针对您所在平台的 Copilot 安装说明

平台	安装命令
macOS	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux x86 (64 位)	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux (ARM)	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Windows	Invoke-WebRequest -OutFile 'C:\Program Files\copilot.exe' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe

开始使用

请确保已安装 AWS 命令行工具，并在开始之前运行过 aws configure。

要通过一条命令快速启动并运行一个示例应用，请执行以下操作：

$ git clone git@github.com:aws-samples/aws-copilot-sample-service.git demo-app
$ cd demo-app
$ copilot init --app demo                \
  --name api                             \
  --type '负载均衡 Web 服务'     \
  --dockerfile './Dockerfile'            \
  --deploy

这将创建一个 VPC、Application Load Balancer 以及在 AWS Fargate 上运行示例应用的 Amazon ECS 服务。整个过程大约需要 8 分钟完成，完成后您将获得示例应用的 URL！🚀

学习更多

想了解更多相关信息吗？请查看我们的文档 https://aws.github.io/copilot-cli/，其中包含入门指南、Copilot 概念介绍以及命令详解。

反馈

您有任何反馈吗？🙏 请在 GitHub 上提交问题，或加入我们的 Gitter 社区。

我们非常乐意听取您的反馈或解答疑问，随时欢迎您与我们联系！

安全披露

如果您认为发现了潜在的安全漏洞，请不要在 Issues 中公开。请按照 此处 的说明操作，或直接发送邮件至 AWS 安全团队：aws-security@amazon.com。

许可证

本库采用 Apache 2.0 许可证授权。

AWS Copilot CLI 快速上手指南

⚠️ 重要提示：即将停止支持 AWS Copilot CLI 将于 2026 年 6 月 12 日 停止支持。此后该工具将不再接收更新、安全补丁或技术支持。建议开发者尽快规划迁移至其他解决方案，以确保持续获得支持和最新功能。详见 官方公告。

AWS Copilot CLI 是一款专为开发者设计的工具，用于在 AWS App Runner 或 Amazon ECS (Fargate) 上构建、发布和运维生产级别的容器化应用。

环境准备

在开始之前，请确保满足以下前置条件：

1. AWS 账号：拥有有效的 AWS 账号及访问权限。
2. AWS CLI：已安装 AWS 命令行工具并完成配置。
   • 执行 aws configure 设置 Access Key、Secret Key、默认区域和输出格式。
3. Docker：本地已安装 Docker 并处于运行状态（用于构建镜像）。
4. 操作系统：支持 macOS、Linux (x86/ARM) 或 Windows。

安装步骤

方法一：使用 Homebrew (推荐 macOS 用户)

brew install aws/tap/copilot-cli

方法二：手动安装 (适用于 Linux/Windows/macOS)

根据你的操作系统平台，在终端中执行以下命令：

平台	安装命令
macOS	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux x86 (64-bit)	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux (ARM)	curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Windows	Invoke-WebRequest -OutFile 'C:\Program Files\copilot.exe' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe

注意：国内用户若下载速度较慢，可尝试配置网络代理或使用国内镜像加速服务下载二进制文件。

基本使用

以下示例将演示如何通过一条命令部署一个示例微服务。该命令会自动创建 VPC、负载均衡器 (ALB) 以及在 Fargate 上运行的 ECS 服务。

1. 克隆示例项目

   git clone git@github.com:aws-samples/aws-copilot-sample-service.git demo-app
   cd demo-app
   

2. 初始化并部署应用 执行以下命令启动初始化和部署流程：

   copilot init --app demo                \
     --name api                             \
     --type 'Load Balanced Web Service'     \
     --dockerfile './Dockerfile'            \
     --deploy
   

   参数说明：

   • --app demo: 创建名为 "demo" 的应用程序组。
   • --name api: 服务名称为 "api"。
   • --type: 指定服务类型为“负载均衡 Web 服务”。
   • --dockerfile: 指定当前目录下的 Dockerfile。
   • --deploy: 初始化完成后立即部署。

3. 等待部署完成 整个过程大约需要 8 分钟。完成后，终端将输出服务的访问 URL。直接在浏览器中打开该 URL 即可看到运行中的示例应用。 🚀

---

更多详细概念解析和命令参考，请访问 官方文档。