Amazon CodeCommit 命令行参考

安装和配置 Amazon CLI

1. 在本地计算机上，下载并安装 Amazon CLI。这是从命令行与 CodeCommit 进行交互的先决条件。我们建议您安装 Amazon CLI 版本 2。它是 Amazon CLI 的最新主版本，支持所有最新功能。它是唯一支持使用根账户、联合访问权限或临时证书与 git-remote-codecommit 的 Amazon CLI 版本。

   有关更多信息，请参阅使用 Amazon 命令行界面进行设置。

   注意

   CodeCommit 仅适用于 Amazon CLI 1.7.38 及更高版本。作为最佳做法，请安装 Amazon CLI 或将其升级到可用的最新版本。要确定您安装的 Amazon CLI 的版本，请运行 aws --version 命令。

   要将旧版本的 Amazon CLI 升级到最新版本，请参阅安装 Amazon Command Line Interface。

2. 运行此命令以验证 Amazon CLI 中的 CodeCommit 命令是否已安装：

   aws codecommit help

   该命令返回 CodeCommit 命令的列表。

3. 使用 configure 命令通过配置文件来配置 Amazon CLI，如下所示：

   aws configure

   出现提示时，指定要用于 CodeCommit 的 IAM 用户的 Amazon 访问密钥和 Amazon 秘密访问密钥。此外，请务必指定存储库所在的 Amazon Web Services 区域，例如 us-east-2。系统提示指定默认输出格式时，指定 json。例如，如果您正在为 IAM 用户配置相关配置文件：

   AWS Access Key ID [None]: Type your IAM user Amazon access key ID here, and then press Enter
   AWS Secret Access Key [None]: Type your IAM user Amazon secret access key here, and then press Enter
   Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
   Default output format [None]: Type json here, and then press Enter

   有关创建和配置相关配置文件以与 Amazon CLI 配合使用的详细信息，请参阅以下内容：

   • 命名配置文件

   • 在 Amazon CLI 中使用 IAM 角色

   • 设置命令

   • 使用轮换凭证连接到 Amazon CodeCommit 存储库

   要连接到另一个 Amazon Web Services 区域中的存储库或资源，您必须使用默认区域名称重新配置 Amazon CLI。CodeCommit 支持的默认区域名称包括：

   • us-east-2

   • us-east-1

   • eu-west-1

   • us-west-2

   • ap-northeast-1

   • ap-southeast-1

   • ap-southeast-2

   • ap-southeast-3

   • me-central-1

   • eu-central-1

   • ap-northeast-2

   • sa-east-1

   • us-west-1

   • eu-west-2

   • ap-south-1

   • ap-south-1

   • ca-central-1

   • us-gov-west-1

   • us-gov-east-1

   • eu-north-1

   • ap-east-1

   • me-south-1

   • cn-north-1

   • cn-northwest-1

   • eu-south-1

   • ap-northeast-3

   • af-south-1

   • il-central-1

   有关 CodeCommit 和 Amazon Web Services 区域的更多信息，请参阅区域和 Git 连接端点。有关 IAM、访问密钥和秘密密钥的更多信息，请参阅‭如何获取凭证？和管理 IAM 用户的访问密钥。有关 Amazon CLI 和配置文件的更多信息，请参阅命名配置文件。