通过 Visual Studio Team Explorer 使用 AWS CodeCommit - AWS Toolkit for Visual Studio
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

通过 Visual Studio Team Explorer 使用 AWS CodeCommit

您可以使用 AWS Identity and Access Management (IAM) 用户账户创建 Git 凭证,并使用它们在 Team Explorer 中创建和克隆存储库。

的凭证类型AWS CodeCommit

大多数 AWS Toolkit for Visual Studio 用户了解如何设置包含自己的访问密钥和私有密钥的 AWS 凭证配置文件。这些凭据配置文件用于 Toolkit for Visual Studio 如何启用服务API的呼叫,例如 Amazon S3 桶 AWS Explorer 或者启动 Amazon EC2 实例。集成 AWS CodeCommit 通过TeamExplorer,还使用这些凭据资料。但是,要使用 Git 本身,您需要额外的凭证,特别是用于 HTTPS 连接的 Git 凭证。您可以在 使用GIT凭据的HTTPS用户设置AWSCodecommit用户指南.

您可以创建GIT凭据 AWS CodeCommit 仅适用于 IAM 用户帐户。您不能为根账户创建这些凭证。您最多可以为服务创建两组这样的凭证,虽然您可以将一组凭证标记为不活动,但仍会计入您的两组凭证的限制中。请注意,您可以随时删除和重新创建凭证。当您在 Visual Studio 中使用 AWS CodeCommit 时,您的传统 AWS 凭证用于处理服务本身,例如,在您创建和列出存储库时。使用托管在 AWS CodeCommit 中的实际 Git 存储库时,您使用 Git 凭证。

作为支持 AWS CodeCommit、 Toolkit for Visual Studio 自动创建并管理这些GIT凭据,并将其与AWS凭据配置文件相关联。您无需担心手头必须有一组合适的凭证在 Team Explorer 中执行 Git 操作。一旦您使用 AWS 凭证配置文件连接到 Team Explorer,关联的 Git 凭证将在您使用 Git remote 时自动使用。

连接到 AWS CodeCommit

当您在 Visual Studio 2015 或更高版本中打开 Team Explorer 窗口时,您将在“Manage Connections”的“Hosted Service Providers”中看到 AWS CodeCommit 条目。


            “管理连接”中的 AWS CodeCommit 条目

选择 注册 在浏览器窗口中打开AWS主页。选择时会发生什么 连接 取决于 Toolkit for Visual Studio 可以找到具有AWS访问权限和密钥的凭据配置文件,以便代表您向AWS打电话。在 Toolkit for Visual Studio 找不到任何本地存储的凭证时,您可使用在 IDE 中显示的新“Getting Started”页面设置凭证配置文件。或者您可能已经使用 Toolkit for Visual Studio、 适用于 Windows PowerShell 的 AWS 工具,或 AWS CLI 并且已经拥有AWS凭据配置文件 Toolkit for Visual Studio 使用。

当您选择 连接、 Toolkit for Visual Studio 启动流程以找到要在连接中使用的凭据配置文件。如果 Toolkit for Visual Studio 找不到凭证配置文件,将打开一个对话框,邀请您输入您的 AWS 账户的访问密钥和私有密钥。强烈建议您使用 IAM 用户账户而非使用您的根凭证。此外,如前文所述,只能为 IAM 用户创建您最终需要的 Git 凭证。提供访问密钥和私有密钥并创建凭证配置文件之后,Team Explorer 和 AWS CodeCommit 之间的连接已可供使用。

如果 Toolkit for Visual Studio 找到多个 AWS 凭证配置文件,系统将提示您选择要在 Team Explorer 中使用的账户。


            选择 AWS 凭证配置文件

如果您只有一个凭证配置文件,Toolkit for Visual Studio 将绕过配置文件选择对话框,您将立即连接:

在 Team Explorer 与 AWS CodeCommit 之间通过凭证配置文件建立连接时,将关闭邀请对话框并显示连接面板。


            AWS CodeCommit 连接面板

由于您没有本地克隆的存储库,面板仅显示您可执行的操作: 克隆创建,和 注销. 与其他提供程序一样,Team Explorer 中的 AWS CodeCommit 在任意时间只能绑定到一个 AWS 凭证配置文件。要切换帐户,您使用 注销 要删除连接,您可以使用不同的帐户启动新连接。

既然已经建立了一个连接,您可以通过单击 创建 链接。

创建存储库

当您单击 创建 链接, 创建新的AWSCodecommit存储库 对话框打开。


            创建一个新的 AWS CodeCommit 存储库

AWS CodeCommit 资料库按地区组织,所以 地区 您可以选择要托管存储库的区域。列表中有 AWS CodeCommit 支持的所有区域。您为新存储库提供名称 (必需) 和说明 (可选)。

对话框的默认行为是使用存储库名称 (您输入的名称,同时更新文件夹位置) 作为新存储库文件夹位置的后缀。要使用不同的文件夹名称,请编辑 克隆到 完成存储库名称后的文件夹路径。

您还可以选择自动为存储库创建初始 .gitignore 文件。TheThethe AWS Toolkit for Visual Studio 为VisualStudio文件类型提供内置默认设置。您还可以选择没有文件,或者使用您希望在各个存储库中重用的自定义现有文件。只需选择 使用自定义 在列表中并导航至要使用的自定义文件。

一旦您拥有存储库名称和位置,即可点击 并开始创建存储库。TheThethe Toolkit for Visual Studio 要求服务创建存储库,然后在本地克隆新的存储库,如果您使用的是一个.gitignore文件,则添加初始承诺。此时您开始使用 Git remote,因此 Toolkit for Visual Studio 现在需要访问之前所述的 Git 凭证。

设置 Git 凭证

到目前为止,您已使用 AWS 访问密钥和私有密钥请求服务创建您的存储库。现在,您需要使用 Git 本身执行实际克隆操作,并且 Git 不了解 AWS 访问密钥和私有密钥。因此您需要向 Git 提供用户名和密码凭证以在 HTTPS 连接上使用 remote。

如中所述 设置GIT凭据,您要使用的GIT凭据必须与iam用户关联。您不能为根凭证生成它们。您应始终设置您的 AWS 凭证配置文件包含 IAM 用户访问密钥和私有密钥,并且不包含根密钥。TheThethe Toolkit for Visual Studio 可以尝试设置GIT凭据 AWS CodeCommit 对于您而言,并将其与您在早期在TeamExplorer中连接的AWS凭据配置文件相关联。

当您选择 创建新的AWSCodecommit存储库 对话框并成功创建存储库, Toolkit for Visual Studio 检查团队资源管理器中已连接的AWS凭据配置文件,以确定GIT凭据 AWS CodeCommit 存在并与配置文件相关联。如果是这样的话,Toolkit for Visual Studio 指示 Team Explorer 开始在新存储库上的克隆操作。如果 Git 凭证在本地不可用,Toolkit for Visual Studio 会检查在 Team Explorer 的连接中使用的账户凭证的类型。如果该凭证用于 IAM 用户 (就像我们建议的那样),则将显示以下消息。


            创建 Git 凭证

如果凭证是根凭证,将会改为显示以下消息。


            使用 AWS CodeCommit 凭证创建 IAM 用户

在这两种情况下,Toolkit for Visual Studio 方案尝试完成操作来为您创建必需的 Git 凭证。在第一种情况下,所有需要创建的是 IAM 用户的一组 Git 凭证。当根账户正在使用中时,Toolkit for Visual Studio 首先尝试创建一个 IAM 用户,然后继续为该新用户创建 Git 凭证。如果 Toolkit for Visual Studio 必须创建新用户,则必须将 AWS CodeCommit 高级用户托管策略应用到该新用户账户。此策略仅允许访问 AWS CodeCommit 并使所有操作都能使用 AWS CodeCommit 除了删除存储库外。

在您创建凭证时,您只能查看一次凭证。因此, Toolkit for Visual Studio 提示您将新创建的凭据保存为 .csv 继续之前的文件。


            保存 AWS CodeCommit 凭证

这是我们强烈建议的操作,并确保将它们保存到安全位置!

在有些情况下 Toolkit for Visual Studio 可能会无法自动创建凭证。例如,您可能已经创建了最大数量的GIT凭据 AWS CodeCommit (二),或者您可能没有足够的程序性权利 Toolkit for Visual Studio 为您做工作(如果您以iam用户身份登录)。在这些情况下,您可以登录 AWS 管理控制台管理凭证或从管理员获取这些凭证。然后您可以在 AWSCodecommit的GIT凭据 对话框, Toolkit for Visual Studio 显示。


            AWS CodeCommit 的 Git 凭证

现在 Git 的凭证已可用,新存储库的克隆操作将继续 (请查看 Team Explorer 中操作的进度指示)。如果您选择应用默认 .gitignore 文件,则会使用注释“Initial Commit”将其提交到存储库。

这是在 Team Explorer 中设置凭证和创建存储库所需的全部操作。一旦要求的凭据到位,您将来所看到的全部新存储库都是 创建新的AWSCodecommit存储库 对话框本身。

克隆存储库

要克隆现有存储库,请返回到 Team Explorer 中 AWS CodeCommit 的连接面板。单击 克隆 链接打开 克隆AWSCodecommit存储库 对话框,然后选择要克隆的存储库,以及要将其放置在磁盘上的位置。


            克隆 AWS CodeCommit 存储库

在您选择区域之后,Toolkit for Visual Studio 将查询服务以发现该区域中可用的存储库,并将其显示在对话框的中央列表部分中。还将显示每个存储库的名称和可选说明。您可以重新排序列表,将其按存储库名称或上次修改日期,以升序或降序排序。

在您选择存储库之后,您可以选择要克隆到的位置。这会默认为在 Team Explorer 中其他插件使用的相同存储库位置,不过您可以浏览或输入任何其他位置。默认情况下,存储库名称作为后缀添加到选定的路径。但是,如果您希望使用特定路径,只需在选择文件夹之后编辑文本框。单击时无论文本在框中 将是您找到克隆资料库的文件夹。

选择了存储库和文件夹位置,然后单击 要继续克隆操作。就像创建存储库一样,您可以在 Team Explorer 中查看报告的克隆操作进度。

使用 存储库

当您克隆或创建存储库时,请注意在 Team Explorer 中连接面板的操作链接下列出的本地存储库的连接。这些条目为您提供了一种简便的方法访问存储库以浏览内容。只需右键单击存储库并选择 在控制台中浏览.


            在控制台中浏览

您也可以使用 更新GIT凭据 更新与凭据配置文件关联的已存储的GIT凭据。如果您已轮换凭证,这非常有用。命令打开 AWSCodecommit的GIT凭据 对话框,您可以在其中输入或导入新凭据。

存储库上的 Git 操作均按您的预期工作。您可以发出本地提交,并在准备好共享时,使用 Team Explorer 中的“Sync”选项。由于 Git 凭证已存储在本地并与我们的已连接 AWS 凭证配置文件关联,系统不会提示我们再次为 AWS CodeCommit remote 的操作提交凭证。