本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为... 进行设置 AWS CodeCommit
您可以登录 AWS 管理控制台 并直接从 AWS CodeCommit 控制台向存储库上传、添加或编辑文件。这是一种执行更改的快速方法。但是,如果您希望处理多个文件、处理跨分支文件等,请考虑设置您的本地计算机来使用存储库。最简单的设置方法 CodeCommit 是为配置 HTTPS Git 凭证 AWS CodeCommit。该 HTTPS 身份验证方法:
使用静态用户名和密码。
适用于支持的所有操作系统 CodeCommit。
兼容支持 Git 凭证的集成开发环境 (IDE) 及其他开发工具。
如果出于操作原因您不想或不能使用 Git 凭证,也可以使用其他方法。例如,如果您使用联合访问权限、临时证书或 Web 身份提供商访问 CodeCommit 存储库,则不能使用 Git 证书。我们建议您使用 git-remote-codecommit 命令设置本地计算机。请仔细查看这些选项,以确定最适合您的替代方法。
有关使用 CodeCommit 和亚马逊虚拟私有云的信息,请参阅使用 AWS CodeCommit 使用接口 VPC 端点。
查看和管理您的凭证
您可以通过 “我的安全 CodeCommit 证书” 从 AWS 控制台查看和管理您的证书。
注意
此选项不适用于使用联合访问权限、临时证书或 Web 身份提供商的用户。
登录 AWS 管理控制台 并打开 IAM 控制台,网址为https://console.aws.amazon.com/iam/
。 -
在右上角的导航栏中,选择您的用户名,然后选择 Security Credentials。
-
选择 AWS CodeCommit 凭证选项卡。
使用 Git 凭证进行设置
利用 HTTPS 连接和 Git 凭证,您可以在 IAM 中生成静态用户名和密码。然后,您可以在 Git 和支持 Git 用户名及密码身份验证的任何第三方工具中使用这些凭证。大多数 IDE 和开发工具都支持这种方法。这是最简单、最容易使用的连接方法 CodeCommit。
-
适用于使用 Git 凭证的 HTTPS 用户:按照以下说明使用 Git 凭据在本地计算机和 CodeCommit 存储库之间建立连接。
-
从开发工具进行的连接:遵循以下准则,使用 Git 凭据在 IDE 或其他开发工具和 CodeCommit 存储库之间建立连接。支持 Git 凭证的 IDE 包括(但不限于)Visual Studio、Xcode 和 IntelliJ。
使用其他方法进行设置
您可以使用 SSH 协议而不是 HTTPS 来连接到您的 CodeCommit 存储库。通过 SSH 连接,您可以在本地计算机上创建公钥和私钥文件,用于 Git 并 CodeCommit 用于 SSH 身份验证。您将公有密钥关联到 IAM 用户,并将私有密钥存储在本地计算机上。SSH 需要手动创建和管理公有密钥及私有密钥文件,因此,您可能会发现配合 Git 凭证来使用 CodeCommit 会更简单、更容易。
与 Git 凭证不同,SSH 连接设置因本地计算机上的操作系统而异。
-
对于未使用的 SSH 用户 AWS CLI:如果您已有公有-私有密钥对并且很熟悉您本地计算机上的 SSH 连接,请按照这些简要说明操作。
-
适用于 Linux、macOS 或 Unix 上的 SSH 连接:请按照这些分步演练说明在 Linux、macOS 或 Unix 操作系统上创建公有密钥/私有密钥对并设置连接。
-
适用于 Windows 上的 SSH 连接:请按照这些分步演练说明在 Windows 操作系统上创建公有密钥/私有密钥对并设置连接。
如果您正在连接 CodeCommit 并 AWS 使用联合访问、身份提供商或临时证书,或者如果您不想为 IAM 用户配置 IAM 用户或 Git 证书,则可以通过以下两种方式之一设置与 CodeCommit 存储库的连接:
-
安装和使用 git-remote-codecommit(推荐)。
-
安装并使用 AWS CLI中包含的凭证辅助程序。
两种方法都支持在不需要 IAM 用户的情况下访问 CodeCommit 存储库,这意味着您可以使用联合访问和临时证书连接到存储库。git-remote-codecommit 实用程序是推荐采用的方法。它扩展 Git,并与各种 Git 版本和凭证辅助程序兼容。但是,并非所有 IDE 都支持 git-remote-codecommit 使用的克隆 URL 格式。您可能需要手动将存储库克隆到本地计算机,然后才能在 IDE 中使用它们。
-
按照使用 git-remote-codecommit 将 HTTPS 连接到 AWS CodeCommit 存储库的设置步骤中的说明git-remote-codecommit在 Windows、Linux、macOS 或 Unix 上进行安装和设置。
中包含的凭证帮助程序 AWS CLI 允许 Git 在 Git 需要进行身份验证以与存储库交互时使用 HTTPS 和您的 IAM 用户证书或 Amazon EC2 实例角色的加密签名版本。 AWS CodeCommit 某些操作系统和 Git 版本有自己的凭证辅助程序,它们会与 AWS CLI中包含的凭证辅助程序发生冲突。它们可能会导致连接问题 CodeCommit。
-
对于 Linux、macOS 或 Unix 上使用 AWS CLI 凭据帮助器的 HTTPS 连接:按照这些分步演练说明在 Linux、macOS 或 Unix 系统上安装和设置凭证助手。
-
在 Windows 上使用 AWS CLI 凭据助手进行 HTTPS 连接:按照这些分步演练说明在 Windows 系统上安装和设置凭证辅助程序。
如果您要连接到托管在另一个 Amazon Web Services 账户中的 CodeCommit 存储库,则可以使用中包含的角色、策略和凭证帮助程序配置访问权限和设置连接。 AWS CLI
-
配置对的跨账户访问权限 AWS CodeCommit 使用角色的存储库:按照以下说明完成分步演练,来配置在一个 Amazon Web Services 账户中对另一个 Amazon Web Services 账户的 IAM 组中的用户执行跨账户访问。
Git 和其他组件的兼容性 CodeCommit
当你使用时 CodeCommit,你使用 Git。您也可以使用其他程序。下表提供了有关版本兼容性的最新指南。作为最佳做法,我们建议您使用最新版本的 Git 和其他软件。
| 组件 | 版本 |
|---|---|
| Git | CodeCommit 支持 Git 版本 1.7.9 及更高版本。Git 版本 2.28 支持为初始提交配置分支名称。我们建议使用最新版本的 Git。 |
| Curl | CodeCommit 需要 curl 7.33 及更高版本。但 HTTPS 和 curl 更新 7.41.0 存在一个已知问题。有关更多信息,请参阅 故障排除。 |
| Python(仅限 git-remote-codecommit) | git-remote-codecommit 需要版本 3 及更高版本。 |
| Pip(仅限 git-remote-codecommit) | git-remote-codecommit 需要 9.0.3 及更高版本。 |
| AWS CLI (git-remote-codecommit仅) | 我们向所有 CodeCommit 用户推荐最新 AWS CLI 版本的版本 2。git-remote-codecommit需要 AWS CLI 版本 2 来支持 AWS SSO 和需要临时证书的连接,例如联合用户。 |