Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

迁移配置文件

在最新版本 (v1.0.0) 中,配置 Amazon ECS CLI 的过程发生了显著变化,以便添加新的功能。推出了迁移命令,可将较旧的 (v0.6.6 及更低版本) 配置文件转换为当前格式。旧配置文件已弃用,我们建议将您的配置转换为最新格式,以便利用新的功能。在 v1.0.0 中,新的 YAML 格式配置文件中推出的配置相关更改和新功能包括:

  • 将凭据和群集相关的配置信息拆分为两个单独的文件。凭据信息存储在 ~/.ecs/credentials 中,群集配置信息存储在 ~/.ecs/config 中。

  • 配置文件为 YAML 格式。

  • 支持存储多个命名配置。

  • 弃用字段 compose-service-name-prefix (此名称用于创建服务 <compose_service_name_prefix> + <project_name>)。此字段仍然可以配置。但是,如果未配置,则不再分配默认值。对于 ECS CLI v0.6.6 和之前的版本,默认值为 ecscompose-service-

  • 删除字段 compose-project-name-prefix (此名称用于创建任务定义 <compose_project_name_prefix> + <project_name>)。Amazon ECS CLI v1.0.0 及更高版本仍然可以读取旧配置文件;因此,如果显示此字段,则仍然会读取和使用此字段。但是,v1.0.0 以上的版本不支持使用 ecs-cli configure 命令配置此字段,如果将此字段手动添加到 v1.0.0 以上版本的配置文件,将导致 Amazon ECS CLI 引发错误。

  • 字段 cfn-stack-name-prefix (此名称用于创建 CFN 堆栈 <cfn_stack_name_prefix> + <cluster_name>) 已更改为 cfn-stack-name。除了指定前缀,可以配置 CloudFormation 模板的确切名称。

  • Amazon ECS CLI v0.6.6 及之前的版本允许使用系统上的 ~/.aws/credentials 文件中的命名 AWS 配置文件配置凭据。此功能已删除。但增加了一个新的标志 --aws-profile,它允许在需要凭据的所有命令中引用 AWS 配置文件内联。

注意

--project-name 标志可用于设置项目名称。

将较旧的配置文件迁移到 v1.0.0+ 格式

虽然 Amazon ECS CLI 的所有版本都支持读取较旧的配置文件格式,但要利用某些新功能,例如使用多个命名群集配置文件,则需要升级到新格式。使用 ecs-cli configure migrate 命令可以轻松地将旧配置文件迁移到新格式。该命令可以将 ~/.ecs/config 中存储的旧格式配置信息转换为一对新格式文件,并在此过程中覆盖您的旧配置文件。

运行 ecs-cli configure migrate 命令时,将会出现旧配置文件的警告消息,以及新配置文件的预览。用户在迁移前需要进行确认。如果使用 --force 标志,则不会显示警告消息,且迁移前无需进行确认。如果旧文件中使用 cfn-stack-name-prefix,则 cfn-stack-name 将在新文件中存储为 <cfn_stack_name_prefix> + <cluster_name>

有关更多信息,请参阅 ecs-cli configure migrate