使用 Amazon ECS 命令行界面

Amazon ECS 发布了 AWS Copilot，这是一种命令行界面（CLI）工具，可简化在本地开发环境中在Amazon ECS上构建、发布和操作生产就绪的容器化应用程序。有关更多信息，请参阅使用 AWS Copilot 命令行界面。

Amazon Elastic Container Service（Amazon ECS）命令行界面（CLI）提供高级命令，以简化本地开发环境中集群和任务的创建、更新和监控。Amazon ECS CLI 支持 Docker Compose 文件，Docker Compose 是一个流行的开源规范，用于定义和运行多容器应用程序。在每日开发和测试过程中使用 ECS CLI，取代 AWS Management Console。

目前，最新版本的 Amazon ECS CLI 仅支持主要版本的 Docker Compose 文件语法版本 1、2 和 3。Compose 文件中指定的版本必须为字符串 "1"、"1.0"、"2"、"2.0"、"3" 或 "3.0"。Docker Compose 次要版本不受支持。

GitHub 上提供了 Amazon ECS CLI 的源代码。该工具不再主动开发。有关发行说明，请参阅更改日志。

安装 Amazon ECS CLI

以下步骤说明如何在 macOS、Linux 或 Windows 系统上安装 Amazon ECS CLI。

安装 Amazon ECS CLI

下载 Amazon ECS CLI 二进制文件。

使用 PGP 签名验证 Amazon ECS CLI。Amazon ECS CLI 可执行文件是使用 PGP 签名进行加密签名的。PGP 签名可用于验证 Amazon ECS CLI 可执行文件的有效性。通过以下步骤使用 GnuPG 工具验证签名。

下载并安装 GnuPG。有关更多信息，请参阅 GnuPG 网站。
macOS
我们建议使用 Homebrew。按照其网站中的说明安装 Homebrew。有关更多信息，请参阅 Homebrew。安装 Homebrew 后，从您的 macOS 终端使用以下命令：
```
brew install gnupg
```
Linux

使用您的 Linux 风格的程序包管理器安装 gpg。

Windows

从 GnuPG 网站下载 Windows 简单安装程序，并以管理员身份安装。安装 GnuPG 后，关闭并重新打开管理员 PowerShell。

有关更多信息，请参阅 GnuPG 下载。
验证 GnuPG 路径是否已添加到您的环境路径中。
macOS
```
echo $PATH
```
如果在输出中没有看到 GnuPG 路径，请运行以下命令将其添加到路径中。
```
PATH=$PATH:<path to GnuPG executable files>
```
Linux
```
echo $PATH
```
如果在输出中没有看到 GnuPG 路径，请运行以下命令将其添加到路径中。
```
export PATH=$PATH:<path to GnuPG executable files>
```
Windows
```
Write-Output $Env:PATH
```
如果在输出中没有看到 GnuPG 路径，请运行以下命令将其添加到路径中。
```
e $Env:PATH += ";<path to GnuPG executable files>"
```
创建本地纯文本文件。
macOS
在终端上，输入：
```
touch <public_key_filename.txt>
```
使用 TextEdit 器打开文件。
Linux

在文本编辑器（如 gedit）中创建文本文件。另存为 public_key_filename.txt

Windows

在文本编辑器（如 Notepad）中创建文本文件。另存为 public_key_filename.txt

添加 Amazon ECS PGP 公有密码的以下内容，保存此文件。

便于参考的 Amazon ECS PGP 公钥的详细信息：

Key ID: BCE9D9A42D51784F
Type: RSA
Size: 4096/4096
Expires: Never
User ID: Amazon ECS
Key fingerprint: F34C 3DDA E729 26B0 79BE AEC6 BCE9 D9A4 2D51 784F

您可以关闭文本编辑器。

在终端中使用以下命令导入带有 Amazon ECS PGP 公有密钥的文件。
```
gpg --import <public_key_filename.txt>
```

下载 Amazon ECS CLI 签名。签名是存储在扩展名为 .asc 的文件中的 ASCII 分离 PGP 签名。此签名文件的名称与其对应可执行文件的名称相同，追加了 .asc。

验证签名。

预期输出：

gpg: Signature made Tue Apr  3 13:29:30 2018 PDT
gpg:                using RSA key DE3CBD61ADAF8B8E
gpg: Good signature from "Amazon ECS <ecs-security@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: F34C 3DDA E729 26B0 79BE  AEC6 BCE9 D9A4 2D51 784F
     Subkey fingerprint: EB3D F841 E2C9 212A 2BD4  2232 DE3C BD61 ADAF 8B8E

重要

输出中的警告是预料中的，没有问题。它出现是因为您的个人 PGP 密钥（如果您有）和 Amazon ECS PGP 密钥之间没有信任链。有关更多信息，请参阅信任 Web。

将执行权限应用于二进制文件。
macOS and Linux
```
sudo chmod +x /usr/local/bin/ecs-cli
```
Windows
编辑环境变量并将 C:\Program Files\Amazon\ECSCLI 添加到 PATH 变量字段中，使用分号与现有条目分隔开来。例如：
```
setx path "%path%;C:\Program Files\Amazon\ECSCLI"
```
重新启动 PowerShell，以便更改生效。

注意
设置 PATH 变量后，可以从 Windows PowerShell 或命令提示符使用 Amazon ECS CLI。
验证 CLI 是否正常运行。
```
ecs-cli --version
```
继续执行配置 Amazon ECS CLI。

重要
您必须使用 AWS 凭证、AWS 区域和 Amazon ECS 集群名称配置 Amazon ECS CLI，然后才能使用它。有关更多信息，请参阅配置 Amazon ECS CLI。

配置 Amazon ECS CLI

Amazon ECS CLI 需要一些基本配置信息（例如，您的 AWS 凭证、要在其中创建集群的 AWS 区域以及要使用的 Amazon ECS 集群的名称），然后才能使用它。在 macOS 和 Linux 系统中，配置信息存储在 ~/.ecs 目录中；在 Windows 系统中，则存储在 C:\Users\<username>\AppData\local\ecs 中。

配置 Amazon ECS CLI

使用以下命令设置 CLI 配置文件，将 profile_name 替换为所需要的配置文件名称，将 $AWS_ACCESS_KEY_ID 和 $AWS_SECRET_ACCESS_KEY 环境变量替换为您的 AWS 凭证。
```
ecs-cli configure profile --profile-name profile_name --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY
```
使用以下命令完成配置，将 launch_type 替换为预设情况下要使用的任务启动类型、region_name 替换为所需的 AWS 区域、cluster_name 替换为要使用的现有 Amazon ECS 集群或新集群的名称，并将 configuration_name 替换为您希望提供此配置的名称。
```
ecs-cli configure --cluster cluster_name --default-launch-type launch_type --region region_name --config-name configuration_name
```

使用配置文件

Amazon ECS CLI 支持使用 ecs-cli configure profile 命令将多组 AWS 凭据配置为命名配置文件。使用 ecs-cli configure profile default 命令可以设置默认配置文件。使用 --ecs-profile 标志运行需要凭证的 Amazon ECS CLI 命令时，可以引用这些配置文件，否则将使用默认配置文件。

使用集群配置

集群配置是用于描述 Amazon ECS 集群的一组字段，包括集群名称和区域。使用 ecs-cli configure default 命令可以设置默认集群配置。Amazon ECS CLI 支持使用 --config-name 选项配置多个命名群集配置。

了解优先顺序

在 Amazon ECS CLI 命令中传递凭证和区域有多种方法。以下是每项的优先顺序。

凭证的优先顺序是：

Amazon ECS CLI 配置文件标志:
1. Amazon ECS 配置文件 (--ecs-profile)
2. AWS 配置文件 (--aws-profile)
环境变量:
1. ECS_PROFILE
2. AWS_PROFILE
3. AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_SESSION_TOKEN
ECS config ‐ 尝试从默认 ECS 配置文件中获取凭据.
原定设置 AWS 配置文件-尝试使用 AWS 配置文件名称中的凭据 (aws_access_key_id, aws_secret_access_key) 或 assume_role (role_arn, source_profile)。
1. AWS_DEFAULT_PROFILE 环境变量 (默认为 default).
EC2 实例角色

区域的优先顺序是：

Amazon ECS CLI 标志：
1. 区域标志 (--region)
2. 集群配置标志 (--cluster-config)
ECS config ‐ 尝试从默认 ECS 配置文件中获取区域。
Environment variables ‐ 尝试从以下环境变量中获取区域：
1. AWS_REGION
2. AWS_DEFAULT_REGION
AWS 配置文件‐ 尝试从 AWS 配置文件名称中使用区域：
1. AWS_PROFILE 环境变量
2. AWS_DEFAULT_PROFILE 环境变量 (默认为 default)

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

使用 AWS Copilot CLI

AWS Fargate