本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ecs-cli configure profile
在指定的 Amazon ECS 配置文件(存储在 ~/.ecs/credentials
文件中)中配置您的 AWS 凭证。如果创建多个配置文件,则可使用 ecs-cli configure profile
default 命令更改默认情况下使用的配置文件。有关更多信息,请参阅ecs-cli configure profile default。
所介绍的某些功能仅可用于最新版本的 ECS CLI。要获取最新版本,请参阅安装 Amazon ECS CLI。
您可以通过多种方式配置 AWS 凭证:
-
您可以设置
AWS_ACCESS_KEY_ID
、AWS_SECRET_ACCESS_KEY
和AWS_SESSION_TOKEN
环境变量。当您运行 ecs-cli configure profile 时,这些变量的值将存储在 Amazon ECS CLI 配置文件中。 -
您可以使用
--access-key
、--secret-key
和--session-token
选项直接在命令行上传递凭证。 -
您可以使用
--profile-name
标记提供新的配置文件名称。如果未提供配置文件名称,则配置文件名为default
。 -
配置的第一个配置文件将设置为默认配置文件。除非使用
--ecs-profile
标记,否则 Amazon ECS CLI 将使用此配置文件中指定的凭证。
使用多个配置文件
使用多个配置文件时应注意以下事项:
-
可以配置多个配置文件,但始终有一个配置文件为默认配置文件。在运行需要凭证的 Amazon ECS CLI 命令时使用此配置文件。
-
创建的第一个配置文件将设置为默认配置文件。
-
要更改默认配置文件,请使用
ecs-cli configure profile default
命令。有关更多信息,请参阅ecs-cli configure profile default。 -
可使用
--ecs-profile
标记在命令中引用非默认配置文件。
语法
ecs-cli configure profile --profile-name
profile_name
--access-key
aws_access_key_id
--secret-key
aws_secret_access_key
[--session-token
token
] [--help]
选项
名称 |
描述 |
---|---|
|
指定此 ECS 配置文件的名称。这是可使用 类型:字符串 必需:是 |
|
指定要使用的 AWS 访问密钥。如果在运行 ecs-cli configure profile 时设置 类型:字符串 必需:是 |
|
指定要使用的 AWS 私有密钥。如果在运行 ecs-cli configure profile 时设置 类型:字符串 必需:是 |
|
指定要使用的 AWS 会话令牌。如果在运行 ecs-cli configure profile 时设置 类型:字符串 必需:否 |
|
显示指定命令的帮助文本。 必需:否 |
示例
示例 1
此示例将 Amazon ECS CLI 配置为创建和使用名为 default
的配置文件与一组访问密钥。
ecs-cli configure profile --profile-name
default
--access-key$AWS_ACCESS_KEY_ID
--secret-key$AWS_SECRET_ACCESS_KEY
输出:
INFO[0000] Saved ECS CLI profile configuration default.
示例 2
此示例将 Amazon ECS CLI 配置为创建和使用名为 default
的配置文件以及一组访问密钥和一个 AWS 会话令牌。
ecs-cli configure profile --profile-name
default
--access-key$AWS_ACCESS_KEY_ID
--secret-key$AWS_SECRET_ACCESS_KEY
--session-token$AWS_SESSION_TOKEN
输出:
INFO[0000] Saved ECS CLI profile configuration default.