AWS CodeCommit 不再向新客户提供。的现有客户 AWS CodeCommit 可以继续照常使用该服务。了解更多”
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将本地或非版本控制内容迁移到 AWS CodeCommit
本主题中的过程演示如何将计算机上的现有项目或本地内容迁移到 CodeCommit 存储库。在该过程中,您将:
-
完成 CodeCommit 所需的初始设置。
-
创建 CodeCommit 存储库。
-
使某个本地文件夹置于 Git 版本控制之下,并将该文件夹的内容推送到 CodeCommit 存储库。
-
查看 CodeCommit 存储库中的文件。
-
与您的团队共享 CodeCommit 存储库。
![将本地项目迁移到 CodeCommit](images/codecommit-migrate-local.png)
主题
步骤 0:访问 CodeCommit 所需的设置
在将本地内容迁移到 CodeCommit 之前,您必须为 CodeCommit 创建和配置 IAM 用户,并配置您的本地计算机以进行访问。您还应安装 AWS CLI 来管理 CodeCommit。虽然您可以在没有 AWS CLI 的情况下执行大多数 CodeCommit 任务,但它为使用 Git 提供了灵活性。
如果您已完成 CodeCommit 所需的设置,请跳到步骤 1:创建 CodeCommit 存储库。
创建和配置用于访问 CodeCommit 的 IAM 用户
前往 http://aws.amazon.com
,并选择注册,创建一个 Amazon Web Services 账户。 创建 IAM 用户或使用您的 Amazon Web Services 账户中的现有用户。确保您具有与该 IAM 用户关联的访问密钥 ID 和秘密访问密钥。有关更多信息,请参阅在 Amazon Web Services 账户中创建 IAM 用户。
注意
CodeCommit 需要 AWS Key Management Service。如果使用现有的 IAM 用户,请确保未向该用户附加明确拒绝 CodeCommit 所需的 AWS KMS 操作的策略。有关更多信息,请参阅 AWS KMS 和加密。
登录 AWS Management Console,然后通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/
。 -
在 IAM 控制台的导航窗格中,选择用户,然后选择要配置进行 CodeCommit 访问的 IAM 用户。
在 Permissions 选项卡上,选择 Add Permissions。
-
在 Grant permissions (授予权限) 中,选择 Attach existing policies directly (直接附加现有策略)。
从策略列表中选择 AWSCodeCommitPowerUser 或用于 CodeCommit 访问的其他托管策略。有关更多信息,请参阅AWS 的托管策略 CodeCommit。
选择要附加的策略后,选择下一步:审核以审核要附加到 IAM 用户的策略列表。如果列表正确,选择 Add permissions。
有关 CodeCommit 托管策略以及与其他组和用户共享访问存储库的更多信息,请参阅共享存储库和 AWS CodeCommit的身份验证和访问控制。
安装和配置 AWS CLI
-
在本地计算机上,下载并安装 AWS CLI。这是从命令行与 CodeCommit 进行交互的先决条件。我们建议您安装 AWS CLI 版本 2。它是 AWS CLI 的最新主版本,支持所有最新功能。它是唯一支持使用根账户、联合访问权限或临时证书与 git-remote-codecommit 的 AWS CLI 版本。
有关更多信息,请参阅使用 AWS 命令行界面进行设置。
注意
CodeCommit 仅适用于 AWS CLI 1.7.38 及更高版本。作为最佳做法,请安装 AWS CLI 或将其升级到可用的最新版本。要确定您安装的 AWS CLI 的版本,请运行 aws --version 命令。
要将旧版本的 AWS CLI 升级到最新版本,请参阅安装 AWS Command Line Interface。
-
运行此命令以验证 AWS CLI 中的 CodeCommit 命令是否已安装:
aws codecommit help
该命令返回 CodeCommit 命令的列表。
-
使用 configure 命令通过配置文件来配置 AWS CLI,如下所示:
aws configure
出现提示时,指定要用于 CodeCommit 的 IAM 用户的 AWS 访问密钥和 AWS 秘密访问密钥。此外,请务必指定存储库所在的 AWS 区域,例如
us-east-2
。系统提示指定默认输出格式时,指定json
。例如,如果您正在为 IAM 用户配置相关配置文件:AWS Access Key ID [None]:
Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]:Type your IAM user AWS 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
jsonhere, and then press Enter
有关创建和配置相关配置文件以与 AWS CLI 配合使用的详细信息,请参阅以下内容:
要连接到另一个 AWS 区域中的存储库或资源,您必须使用默认区域名称重新配置 AWS 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 和 AWS 区域的更多信息,请参阅区域和 Git 连接端点。有关 IAM、访问密钥和秘密密钥的更多信息,请参阅如何获取凭证?和管理 IAM 用户的访问密钥。有关 AWS CLI 和配置文件的更多信息,请参阅命名配置文件。
-
接下来,您必须安装 Git。
-
对于 Linux、macOS 或 Unix:
要使用 CodeCommit 存储库中的文件、提交和其他信息,您必须在本地计算机上安装 Git。CodeCommit 支持 Git 1.7.9 及更高版本。Git 版本 2.28 支持为初始提交配置分支名称。我们建议使用最新版本的 Git。
要安装 Git,建议您访问 Git 下载
等网站。 注意
Git 是一个不断发展的平台,会定期进行更新。有时,功能上的更改可能会影响到它与 CodeCommit 协作的方式。如果在使用特定版本的 Git 和 CodeCommit 时遇到问题,请参阅故障排除中的信息。
-
对于 Windows:
要使用 CodeCommit 存储库中的文件、提交和其他信息,您必须在本地计算机上安装 Git。CodeCommit 支持 Git 1.7.9 及更高版本。Git 版本 2.28 支持为初始提交配置分支名称。我们建议使用最新版本的 Git。
要安装 Git,建议访问 Git for Windows
等网站。如果您使用此链接安装 Git,则可以接受除以下设置之外的所有安装默认设置: 在调整 PATH 环境步骤中出现提示时,从命令行中选择使用 Git 的选项。
(可选)如果您打算将 HTTPS 与 AWS CLI 中包含的凭证助手一起使用,而不是为 CodeCommit 配置 Git 凭证,请在配置额外选项页面上,确保清除启用 Git Credential Manager 选项。仅当 IAM 用户配置 Git 凭证时,Git Credential Manager 才与 CodeCommit 兼容。有关更多信息,请参阅 适用于使用 Git 凭证的 HTTPS 用户 和 Windows 版 Git:我安装了 Windows 版 Git,但在访问我的存储库时被系统拒绝 (403):
注意
Git 是一个不断发展的平台,会定期进行更新。有时,功能上的更改可能会影响到它与 CodeCommit 协作的方式。如果在使用特定版本的 Git 和 CodeCommit 时遇到问题,请参阅故障排除中的信息。
CodeCommit 支持 HTTPS 和 SSH 身份验证。要完成设置,您必须配置用于 CodeCommit 的 Git 凭证(建议大多数用户使用 HTTPS)、访问 CodeCommit 时使用的 SSH 密钥对 (SSH)、git-remote-codecommit(建议使用联合身份访问的用户采用)或 AWS CLI 中包含的凭证助手。
-
有关在所有支持的操作系统上设置 Git 凭证的信息,请参阅步骤 3:创建 Git 凭据,以便通过 HTTPS 连接到 CodeCommit。
-
有关在 Linux、macOS 或 Unix 上设置 SSH 的信息,请参阅SSH 和 Linux、macOS 或 Unix:为 Git 和 CodeCommit 设置公有密钥和私有密钥。
-
有关在 Windows 上设置 SSH 的信息,请参阅步骤 3:为 Git 和 CodeCommit 设置公有密钥和私有密钥。
-
对于 git-remote-codecommit,请参阅使用 git-remote-codecommit 建立到 AWS CodeCommit 的 HTTPS 连接的设置步骤。
-
有关 Linux、macOS 或 Unix 上的凭证助手,请参阅设置凭证助手(Linux、macOS 或 Unix)。
-
有关在 Windows 上设置凭证辅助程序的信息,请参阅设置凭证辅助程序 (Windows)。
步骤 1:创建 CodeCommit 存储库
在本部分中,您将使用 CodeCommit 控制台创建在本教程的其余部分中使用的 CodeCommit 存储库。要使用 AWS CLI 创建存储库,请参阅创建存储库 (AWS CLI)。
打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home
。 -
在区域选择器中,选择要在其中创建存储库的 AWS 区域。有关更多信息,请参阅 区域和 Git 连接端点。
-
在存储库页面上,选择创建存储库。
-
在创建存储库页面上的存储库名称中,为存储库输入名称。
注意
存储库名称区分大小写。名称在 AWS 区域中对于 Amazon Web Services 账户必须唯一。
-
(可选)在描述中,输入存储库的描述。这可以帮助您及其他用户了解存储库的用途。
注意
“描述”字段在控制台中显示“Markdown”,并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用
GetRepository
或BatchGetRepositories
API 的应用程序开发人员,并且打算在 Web 浏览器中显示“存储库描述”字段,请参阅 CodeCommit API 参考。 -
(可选)选择添加标签,向您的存储库添加一个或多个存储库标签(自定义属性标签,可帮助您组织和管理您的 AWS 资源)。有关更多信息,请参阅在中标记存储库 AWS CodeCommit。
-
(可选)展开其他配置,以指定是使用默认 AWS 托管式密钥还是您自己的客户托管密钥来加密和解密此存储库中的数据。如果您选择使用自己的客户托管密钥,则必须确保该密钥在您创建存储库的 AWS 区域可用,并且该密钥处于活跃状态。有关更多信息,请参阅AWS Key Management Service 和 AWS CodeCommit 存储库加密。
-
(可选)如果此存储库包含 Java 或 Python 代码,并且您希望 CodeGuru Reviewer 对其进行分析,请选择启用适用于 Java 和 Python 的 Amazon CodeGuru Reviewer。CodeGuru Reviewer 使用多个机器学习模型来查找代码缺陷,并对拉取请求提供改进和修复建议。有关更多信息,请参阅Amazon CodeGuru Reviewer 用户指南。
-
选择创建。
创建后,存储库将显示在存储库列表中。在 URL 列中,选择复制图标,然后选择用于连接到 CodeCommit 的协议(HTTPS 或 SSH)。复制 URL。
例如,如果将存储库命名为 MyFirstRepo
并且使用 HTTPS,则 URL 将如下所示:
https://git-codecommit.us-east-2.amazonaws.com/v1/repos/
MyFirstRepo
稍后在步骤 2:将本地内容迁移到 CodeCommit 存储库中您将需要该 URL。
步骤 2:将本地内容迁移到 CodeCommit 存储库
现在您有了一个 CodeCommit 存储库,可以在本地计算机上选择一个目录,将其转换为本地 Git 存储库。可以使用 git init 命令将现有的非版本控制内容转化为 Git 存储库,或在尚无任何文件或内容的情况下初始化一个新的空存储库。
-
在本地计算机上的终端或命令行中,进入要用作存储库源的目录。
-
运行以下命令将 Git 配置为使用名为
main
的默认分支:git config --local init.defaultBranch main
您也可以运行以下命令,将所有新创建的存储库的默认分支名称设置为
main
:git config --global init.defaultBranch main
-
运行 git init 命令在该目录中初始化 Git 版本控制。这会在启用版本控制跟踪的目录的根目录中创建一个 .git 子目录。.git 文件夹还包含存储库的所有必需元数据。
git init
-
运行以下命令,检查初始化目录的状态:
git status
添加要置于版本控制之下的文件。在本教程中,将运行带
.
说明符的git add
命令来添加该目录中的所有文件。有关其他选项的信息,请参阅 Git 文档。git add .
-
为添加的文件创建一个带有提交消息的提交。
git commit -m "Initial commit"
-
运行 git push 命令,指定目标 CodeCommit 存储库的 URL 和名称以及
--all
选项。(这是您在步骤 1:创建 CodeCommit 存储库中复制的 URL。)例如,如果将存储库命名为
MyFirstRepo
并设置为使用 HTTPS,则将运行以下命令:git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/
MyFirstRepo
--all
步骤 3:查看 CodeCommit 中的文件
推送完目录内容后,可以使用 CodeCommit 控制台快速查看存储库中的所有文件。
-
打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home
。 -
在存储库中,从列表中选择存储库的名称(例如,
MyFirstRepository
)。 -
查看存储库中的文件,以了解分支、克隆 URL、设置等信息。
步骤 1:共享 CodeCommit 存储库
在 CodeCommit 中创建存储库时,会生成两个端点:一个用于 HTTPS 连接,一个用于 SSH 连接。两者都能提供安全的网络连接。您的用户可以使用这两种协议中的任何一种。不管您向用户推荐哪种协议,这两种终端节点都保持有效。在与他人共享您的存储库之前,您必须创建允许其他用户访问该存储库的 IAM policy。向您的用户提供下述访问说明。
为存储库创建客户托管策略
登录 AWS Management Console,然后通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/
。 -
在 Dashboard 导航区域中选择 Policies,然后选择 Create Policy。
-
在创建策略页面上,选择导入管理型策略。
-
在导入管理型策略页面的筛选策略中,输入
AWSCodeCommitPowerUser
。选择策略名称旁的按钮,然后选择导入。 -
在创建策略页面上,选择 JSON。将 CodeCommit 操作的
Resource
行的“*”部分替换为 CodeCommit 存储库的 Amazon 资源名称 (ARN),如下所示:"Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" ]
提示
要查找 CodeCommit 存储库的 ARN,请转到 CodeCommit 控制台,从列表中选择存储库名称,然后选择设置。有关更多信息,请参阅查看存储库详细信息。
若要将该策略应用到多个存储库,请通过指定其 ARN 将各个存储库添加为资源。在每个资源语句之间加上逗号,如下所示:
"Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" ]
完成编辑后,选择查看策略。
-
在查看策略页面上的名称中,输入策略的新名称(例如
AWSCodeCommitPowerUser-MyDemoRepo
)。(可选)提供此策略的描述。 -
选择创建策略。
要管理对您的存储库的访问,请为其用户创建一个 IAM 组、向该组添加 IAM 用户,然后附加在上一步中创建的客户管理型策略。附加访问所需的任何其他策略,例如 IAMSelfManageServiceSpecificCredentials
或 IAMUserSSHKeys
。
登录AWS Management Console,然后通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/
。 -
在 Dashboard 导航区域中选择 Groups,然后选择 Create New Group。
-
在设置组名页面上的组名中,为组输入名称(例如
MyDemoRepoGroup
),然后选择下一步。请考虑在组名称中包含存储库名称。注意
该名称必须在 Amazon Web Services 账户间保持唯一。
-
选中您在前一部分中创建的客户管理型策略旁边的复选框(例如 AWSCodeCommitPowerUser-MyDemoRepo)。
-
在 Review 页面上,选择 Create Group。IAM 将使用已附加的指定策略创建此组。此组会显示在与您的 Amazon Web Services 账户关联的组列表中。
-
从列表中选择您的组。
-
在组摘要页面上,选择用户 选项卡,然后选择向组添加多个用户。在显示与您的 Amazon Web Services 账户关联的所有用户的列表中,选中要允许其访问 CodeCommit 存储库的用户旁边的复选框,然后选择添加用户。
提示
您可以使用搜索框快速地按名称查找用户。
-
添加用户后,关闭 IAM 控制台。
在创建 IAM 用户以使用您配置的策略组和策略访问 CodeCommit 后,向该用户发送连接到存储库所需的信息。
-
打开 CodeCommit 控制台:https://console.aws.amazon.com/codesuite/codecommit/home
。 -
在区域选择器中,选择创建存储库的 AWS 区域。存储库特定于 AWS 区域。有关更多信息,请参阅区域和 Git 连接端点。
-
在 Repositories (存储库) 页面上,选择要共享的存储库。
-
在克隆 URL 中,选择您希望用户使用的协议。这会复制连接协议的克隆 URL。
-
向您的用户发送克隆 URL 以及任何其他说明,如安装 AWS CLI、对配置文件进行配置或安装 Git 的说明。请确保包含连接协议(例如 HTTPS)的配置信息。