从 AWS Cloud9 迁移到 Amazon CodeCatalyst - AWS Cloud9
第 1 步 注册 Amazon CodeCatalyst 并创建一个空间第 2 步 在空间中创建项目第 3 步 在项目中创建一个源存储库第 4 步 将 AWS Cloud9 代码资源复制到 CodeCatalyst 中的源存储库第 5 步：使用 AWS Cloud9 在 CodeCatalyst 中创建一个开发环境

AWS Cloud9 现已不再向新客户提供。AWS Cloud9 的现有客户可以继续正常使用该服务。了解更多

从 AWS Cloud9 迁移到 Amazon CodeCatalyst

CodeCatalyst 中的 AWS Cloud9 为与 AWS Cloud9 的交互提供了完全托管式体验。您可以在 Amazon CodeCatalyst 中手动复制您当前的 AWS Cloud9 代码资源。该操作过程将在以下各节详细介绍。要移动您的代码资源并对其进行复制，请在 CodeCatalyst 中创建一个空间。空间代表的是您的公司、部门或团体。您需要创建空间来添加您在 CodeCatalyst 中创建的项目、成员和关联的云资源。当用户接受项目邀请时，CodeCatalyst 会自动将其添加到空间中。具有空间管理员角色的用户可以管理空间。

在此空间中，您可以创建项目并添加源存储库。项目是 CodeCatalyst 中的协作空间，用于为开发团队和任务提供支持。创建项目后，您可以添加、更新或删除资源。您还可以自定义项目控制面板，并监控团队的工作进度。一个空间内可以有多个项目。源存储库的可添加数量取决于您已在 AWS Cloud9 环境中使用的存储库数量。创建此项目并添加了适用的源存储库后，您可能需要返回到您的 AWS Cloud9 环境并将环境数据复制到 CodeCatalyst 中的这些新存储库中。您需要进行的操作取决于您在 AWS Cloud9 中所拥有的源存储库类型。

创建空间、项目和源存储库后，您可以使用 AWS Cloud9 和开发环境在 CodeCatalyst 中启动您的环境。开发环境是云端开发环境。您可以在 CodeCatalyst 中使用开发环境来处理存储在项目源存储库中的代码。您还可以在 CodeCatalyst 中创建开发环境，以便在具有支持的集成式开发环境 (IDE) 的特定项目开发环境中处理代码。

您也可以使用复制工具将当前的 AWS Cloud9 代码资源复制到 CodeCatalyst。复制工具是您下载并在 AWS Cloud9 环境中运行的工具。如果您已经注册了 CodeCatalyst 并创建了空间，则该工具会自动在此空间内创建一个项目，并将您的代码资源复制到 CodeCatalyst 中的新存储库。这一过程与手动复制过程类似。这取决于您在 AWS Cloud9 中所拥有的源存储库类型。例如，如果您拥有 GitHub 存储库，则仍需要在 CodeCatalyst 控制台中使用 GitHub 扩展复制这些存储库。

第 1 步 注册 Amazon CodeCatalyst 并创建一个空间

您可以注册 Amazon CodeCatalyst，而无需接受加入现有空间或项目的邀请。注册后便会自动创建一个空间和项目。您可以输入用于 AWS Cloud9 的现有 AWS 账户 ID。这个 AWS 账户可以用于计费。有关如何查找您的 AWS 账户 ID 的信息，请参阅您的 AWS 账户 ID 及其别名。按照以下步骤注册您的 Amazon CodeCatalyst 个人资料、创建一个空间，并为您的空间添加一个账户。

以新用户身份注册

  1. 打开 CodeCatalyst 控制台。

  2. 在欢迎页中，选择注册。

    此时将显示创建您的 AWS Builder ID 页面。AWS Builder ID 是您创建用于登录的身份。此 ID 与 AWS 账户 ID 不同。要了解有关 AWS Builder ID 的更多信息，请参阅《AWS 登录用户指南》中的 AWS Builder ID 和其他 AWS 凭证。

  3. 在您的电子邮件地址中，输入您要使用的电子邮件地址。然后选择下一步。

  4. 在您的姓名中，输入您希望在使用 AWS Builder ID 的应用程序中显示的名字和姓氏。

    这个姓名是您的 AWS Builder ID 资料名称。您之后可以在需要时更改这个名称。

    选择下一步。此时将显示电子邮件验证页面。验证码将发送到您指定的电子邮件中。

  5. 在验证码中，输入您收到的验证码，然后选择验证。

    如果您在 5 分钟后仍未收到验证码，也没能在垃圾邮件文件夹中找到该验证码，请选择重新发送验证码。

  6. 验证完成后，输入密码并选择确认密码。

    选中复选框，确认您已阅读并同意 AWS 客户协议和 AWS 服务条款，然后选择创建我的资料。

  7. 在创建您的别名页面上，输入要用于 CodeCatalyst 的别名。其他 CodeCatalyst 用户会使用此别名在评论和拉取请求中 @mention 提及您。您的 CodeCatalyst 资料将包含您的 AWS Builder ID 中的全名和您的 CodeCatalyst 别名。您无法更改 CodeCatalyst 别名。

    您的全名和别名将显示在 CodeCatalyst 的不同区域。例如，您的资料名称会出现在您的活动源中，但项目成员会使用您的别名来 @mention 提及您。

    选择创建别名。页面将更新，并显示创建您的空间部分。

  8. 在空间名称中，输入空间名称，然后选择下一步。

    您无法更改空间名称。

  9. 在 AWS 账户 ID中，关联您要连接到空间的账户的十二位 ID。

    在 AWS 账户 验证令牌中，复制生成的令牌 ID。令牌会自动复制。但是，建议您在批准 AWS 连接请求时将其存储。

  10. 选择在 AWS 中验证。

  11. 验证 Amazon CodeCatalyst 空间页面将在 AWS Management Console 中打开。

    这是 Amazon CodeCatalyst 空间页面。您可能需要登录才能访问该页面。

    要访问该页面，请在 AWS Management Console中登录 Amazon CodeCatalyst 空间。

    AWS Management Console 中的验证令牌字段会自动填充 CodeCatalyst 中生成的令牌。

  12. 选择验证空间。

    系统将显示账户验证成功消息，表示该账户已添加到空间。

    默认情况下，您将使用 CodeCatalyst 免费套餐。如果要更改，请选择要启用标准套餐或为此空间添加 IAM 角色，请查看空间详细信息。

    有关 CodeCatalyst 定价套餐的更多信息，请参阅 Amazon CodeCatalyst - Pricing。

    CodeCatalyst 空间详细信息页面将在 AWS Management Console 中打开。这是 Amazon CodeCatalyst 空间页面。您可能需要登录才能访问该页面。

  13. 选择前往 Amazon CodeCatalyst。

  14. 在 CodeCatalyst 的创建页面上，选择创建空间。

    创建空间时会显示一条状态消息。创建空间后，CodeCatalyst 会打开您的空间页面。该视图默认为项目选项卡。

    注意

    如果显示权限错误或横幅，请刷新页面并尝试再次查看该页面。

注册 CodeCatalyst 并创建空间后，复制过程的下一步是在该空间中创建一个项目。

第 2 步 在空间中创建项目

以下步骤概括了如何在上一步中创建的空间中创建一个空项目。通过此项目，您可以在以后手动添加所需的资源。在创建项目之前，您必须拥有空间管理员 角色，并且必须加入要创建项目的空间。创建空间时，CodeCatalyst 会自动为您分配空间管理员 角色。空间管理员 角色是 CodeCatalyst 中权限最大的角色。有关此角色及其权限的更多信息，请参阅 Space administrator role。

创建空项目

  1. 导航到要在其中创建项目的空间。

  2. 在空间控制面板上，选择创建项目。

  3. 选择从头开始。

  4. 在为项目命名下，输入要分配给项目的名称。该名称在空间内必须是唯一的。

  5. 选择创建项目。

创建项目后，复制过程的下一步是创建一个或多个源存储库。

第 3 步 在项目中创建一个源存储库

在您刚刚创建的项目中，您需要创建一个源存储库。此存储库包含一个文件，即 README.md 文件，您可以随时编辑或删除该文件。根据您在创建源存储库时所做的选择，它可能还包含一个 .gitignore 文件。

创建源存储库

  1. 打开 CodeCatalyst 控制台。

  2. 导航到您的项目。

  3. 在导航窗格中，选择代码，然后选择源存储库。

  4. 选择添加存储库，然后选择创建存储库。

  5. 在存储库名称中，输入存储库的名称。

    一个项目中的存储库名称必须唯一。有关存储库名称要求的更多信息，请参阅 Quotas for source repositories in CodeCatalyst。

  6. （可选）在描述中，添加对存储库的描述，这有助于项目中的其他用户了解存储库的用途。

  7. （可选）为您计划推送的代码类型添加一个 .gitignore 文件。

  8. 选择创建。

    注意

    创建存储库时，CodeCatalyst 会将一个 README.md 文件添加到存储库中。CodeCatalyst还在名为 main 的默认分支中为存储库创建一个初始提交。您可以编辑或删除 README.md 文件，但无法更改或删除默认分支。

  9. 要获取源存储库克隆 URL 和 PAT，请选择克隆存储库。

  10. 要复制每个 HTTPS 克隆 URL 和 PAT，请选择复制。然后，将克隆 URL 和 PAT 存储在您可以检索到的位置。

    克隆 URL 和 PAT 将在第 4 步中使用，并被引用为 CODECATALYST_SOURCE_REPO_CLONE_URL 和 CODECATALYST_PAT。

在项目中创建源存储库后，将您的 AWS Cloud9 数据复制到该源存储库。

第 4 步 将 AWS Cloud9 代码资源复制到 CodeCatalyst 中的源存储库

AWS Cloud9 环境中的源存储库类型决定了将代码资源存入您创建的 CodeCatalyst 源存储库时所遵循的复制方法。这些方法如下所示：

在 CodeCatalyst 使用 GitHub 存储库

通过 GitHub 存储库扩展，您可以在 Amazon CodeCatalyst 项目中使用源自 AWS Cloud9 的已关联 GitHub 存储库。以下步骤概括了如何从 CodeCatalyst 目录中安装 GitHub 扩展。这些步骤还展示了如何将你的现有 GitHub 账户连接到 CodeCatalyst 空间，以及如何将你的 GitHub 存储库与 CodeCatalyst 项目相关联。

此方法的第一步是从 CodeCatalyst 目录中安装 GitHub 存储库扩展。要安装该扩展，请执行以下步骤。

重要

作为安装和配置 Github 存储库扩展的一部分，您必须在您的 GitHub 账户中安装扩展。为此，您必须是 GitHub 账户管理员和 CodeCatalyst 空间管理员。

第 1 步。从 CodeCatalyst 目录中安装扩展

  1. 打开 CodeCatalyst 控制台。

  2. 导航到您的空间。

    提示

    如果您属于多个空间，则可以在顶部导航栏中选择要查看的空间。

  3. 在搜索栏旁边的顶部菜单栏中选择目录图标，导航到 CodeCatalyst 目录。您可以搜索 GitHub 存储库或根据类别筛选扩展。

  4. （可选）要查看有关扩展的更多详细信息，例如与之关联的权限，请选择 GitHub 存储库扩展名。

  5. 选择安装。查看扩展所需的权限，如果要继续，请再次选择安装。

安装 GitHub 存储库扩展后，您将进入 GitHub 存储库扩展详细信息页面，您可以在其中查看和管理连接的 GitHub 账户和关联的 GitHub 存储库。

安装 GitHub 存储库扩展后，将您的 GitHub 账户连接到 CodeCatalyst 空间。要连接您的 GitHub 账户，请执行以下步骤。

第 2 步。将您的 GitHub 账户连接到 CodeCatalyst

  1. 在已连接的 Github 账户选项卡中，选择连接 GitHub 账户以转到外部的 GitHub 站点。

  2. 使用您的 GitHub 凭证登录 GitHub 账户，然后选择要在其中安装 Amazon CodeCatalyst 的账户。

  3. 选择是否要允许 CodeCatalyst 访问所有当前和未来的存储库。或者，也可以选择要在 CodeCatalyst 中使用的特定 GitHub 存储库。默认选项是 GitHub 空间中的所有 GitHub 存储库。

  4. 查看授予 CodeCatalyst 的权限，然后选择安装。

将您的 GitHub 账户连接到 CodeCatalyst 后，您可以在 GitHub 存储库扩展详细信息页面的 GitHub 账户选项卡中查看已连接的账户。

要实现在 CodeCatalyst 中使用 GitHub 存储库的最后一步，是将存储库关联到你要使用它的 CodeCatalyst 项目。要将您的 GitHub 存储库关联到 CodeCatalyst 项目，请执行整个过程的第 3 步中概述的以下步骤：

第 3 步。从 GitHub 存储库扩展详细信息页面将 GitHub 存储库关联到 CodeCatalyst 项目

  1. 在已关联的 GitHub 存储库选项卡中，选择关联 GitHub 存储库。

  2. 在 GitHub 账户中，选择包含要关联的存储库的 GitHub 账户。

  3. 在 GitHub 存储库中，选择要关联到 CodeCatalyst 项目的存储库。

  4. 在 CodeCatalyst 项目中，选择要与 GitHub 存储库关联的 CodeCatalyst 项目。

  5. 选择关联。

您的 CodeCatalyst 存储库现在应该包含您刚才推送的更新文件和提交。现在，您可以从该分支创建开发环境并使用 AWS Cloud9 将其打开。有关开发环境的详细信息，请参阅 Dev Environments in CodeCatalyst。

现在，您可以从该分支创建开发环境并使用 AWS Cloud9 将其打开。第 5 步：在 CodeCatalyst 中使用 AWS Cloud9 创建开发环境中概述了执行此操作的步骤

在 CodeCatalyst 使用非 GitHub 存储库

在使用非 GitHub 存储库从 AWS Cloud9 中复制环境之前，您需要先在 Amazon CodeCatalyst 中创建个人访问令牌 (PAT)。下一节概述了如何创建此令牌。

在 Amazon CodeCatalyst 中创建个人访问令牌

您可以在本地计算机上使用 Git 客户端或在集成式开发环境 (IDE) 中访问您在项目中创建的源存储库。要执行此操作，您必须输入应用程序特定的密码。您可以创建用于此目的的个人访问令牌 (PAT)。您创建的个人访问令牌 (PAT) 与 CodeCatalyst 中所有空间和项目的用户身份相关联。您可以查看已创建的 PAT 的名称和到期日期，也可以删除不再需要的 PAT。您只能在创建 PAT 密钥时对其进行复制。

创建个人访问令牌 (PAT)

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 在顶部菜单栏中，选择您的个人资料徽章，然后选择我的设置。

    提示

    您还可以找到您的用户个人资料。要执行此操作，请在项目或空间的成员页面上，从成员列表中选择您的姓名。

  3. 在个人访问令牌下，选择创建。

  4. 在 PAT 名称中，为您的个人访问令牌 (PAT) 输入一个描述性名称。

  5. 在到期日期中，保留默认日期，或者选择日历图标以自定义日期。到期日期默认为自当前日期起之后的 1 年时间。

  6. 选择创建。

    提示

    当为源存储库选择克隆存储库时，也可以创建此令牌。

  7. 要复制 PAT 密钥，请选择复制。将 PAT 密钥储存到您可以检索到的位置。

    重要

    PAT 密钥仅显示一次。关闭窗口后将无法再查看。如果您未将 PAT 密钥保存在安全位置，则可以创建新的密钥。

为源存储库创建 PAT 后，通过在您的 AWS Cloud9 环境中添加一个远程存储库并将数据推送到该存储库，将您的数据从 AWS Cloud9 环境复制到 CodeCatalyst，如以下部分所述。

在您的 AWS Cloud9 环境中添加一个远程存储库

假设你运行的存储库不是 GitHub 存储库。您可以在您的 AWS Cloud9 环境中添加一个远程存储库，并将数据推送到 CodeCatalyst 中的源存储库。要完成此过程，请运行以下命令。

在 AWS Cloud9 IDE 中，添加一个远程存储库，该存储库指向您在 CodeCatalyst 中复制过程的第 3 步中创建的源存储库。将命令中的 CODECATALYST_SOURCE_REPO_CLONE_URL 替换为您在 第 3 步 的第 10 步中保存的克隆 URL （第 3 步 在项目中创建一个源存储库）。

 git remote add codecatalyst CODECATALYST_SOURCE_REPO_CLONE_URL

使用以下命令将新分支推送到源存储库。当系统提示您输入密码时，请使用您在第 3 步的第 10 步中保存的 CODECATALYST_PAT （第 3 步 在项目中创建一个源存储库）：

git checkout -b replication && git push codecatalyst replication

以下是预期的命令运行输出的示例：

Switched to a new branch 'replication'
Password for 'https://[aws-account-id]@[aws-region].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository':
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (4/4), 982 bytes | 122.00 KiB/s, done.
Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Validating objects: 100%
To https://[aws-account-id].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository
* [new branch] replication → replication

此分支可在您在 CodeCatalyst 中创建的源存储库中找到。您可以从该分支创建开发环境并使用 AWS Cloud9 将其打开。有关开发环境的更多信息，请参阅 Dev Environments in CodeCatalyst。

现在，您可以从该分支创建开发环境并使用 AWS Cloud9 将其打开。第 5 步：在 CodeCatalyst 中使用 AWS Cloud9 创建开发环境中概述了执行此操作的步骤

在 AWS Cloud9 中使用空存储库。

首先在 Amazon CodeCatalyst 中创建个人访问令牌 (PAT)，然后才能使用空存储库从 AWS Cloud9 复制您的环境。下一节概述了如何创建此令牌。

在 Amazon CodeCatalyst 中创建个人访问令牌

您可以在本地计算机上使用 Git 客户端或在集成式开发环境 (IDE) 中访问您在项目中创建的源存储库。要执行此操作，您必须输入应用程序特定的密码。您可以创建用于此目的的个人访问令牌 (PAT)。您创建的个人访问令牌 (PAT) 与 CodeCatalyst 中所有空间和项目的用户身份相关联。您可以查看已创建的 PAT 的名称和到期日期，也可以删除不再需要的 PAT。您只能在创建 PAT 密钥时对其进行复制。

创建个人访问令牌 (PAT)

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 在顶部菜单栏中，选择您的个人资料徽章，然后选择我的设置。

    提示

    您还可以找到您的用户个人资料。要执行此操作，请在项目或空间的成员页面上，从成员列表中选择您的姓名。

  3. 在个人访问令牌下，选择创建。

  4. 在 PAT 名称中，为您的个人访问令牌 (PAT) 输入一个描述性名称。

  5. 在到期日期中，保留默认日期，或者选择日历图标以自定义日期。到期日期默认为自当前日期起之后的 1 年时间。

  6. 选择创建。

    提示

    当为源存储库选择克隆存储库时，也可以创建此令牌。

  7. 要复制 PAT 密钥，请选择复制。将 PAT 密钥储存到您可以检索到的位置。

    重要

    PAT 密钥仅显示一次。关闭窗口后将无法再查看。如果您未将 PAT 密钥保存在安全位置，则可以创建新的密钥。

为源存储库创建 PAT 后，通过在 AWS Cloud9 环境中启动一个空存储库并指向在 CodeCatalyst 中创建的源存储库，将数据从 AWS Cloud9 环境复制到 CodeCatalyst，如下节所述。

在 AWS Cloud9 中启动一个空存储库。

如果在 AWS Cloud9 中没有设置任何源存储库，那么在 AWS Cloud9 中启动一个空存储库。同时，将空存储库指向您在 CodeCatalyst 中创建的源存储库，并通过 Git 添加和推送您想要复制的文件。执行以下步骤并运行以下命令，将您的 AWS Cloud9 文件复制到 CodeCatalyst。

  1. 在您的 AWS Cloud9 环境中，通过运行以下命令启动一个空存储库：

    git init -b main

    然后，您会看到如下所示的类似的输出：

    
Initialized empty Git repository in /home/ec2-user/environment/.git/

  2. 从 CodeCatalyst 中克隆源存储库 URL。导航到您在 CodeCatalyst 控制台中创建的 CodeCatalyst 项目，在导航窗格中选择代码，然后选择源存储库。

  3. 从源存储库列表中选择所需的存储库，然后选择克隆存储库，复制克隆 URL。

  4. 使用您克隆的 URL 添加 CodeCatalyst 存储库，然后将空存储库中的内容推送到 CodeCatalyst 中：

    git remote add origin [...]
git push origin --force

  5. 添加您想要复制的文件。如果要复制环境目录中的所有文件，请运行 git add -A：

    git add -A .
git commit -m "replicate"

  6. 合并两个不相关的历史记录。如果合并发生冲突，请解决问题：

    git merge origin/main --allow-unrelated-histories

  7. 运行以下命令，将更改推送回 CodeCatalyst 中的源存储库。当系统提示您输入密码时，输入您在第 3 步的第 10 步中生成的个人访问令牌 (CODECATALYST_PAT) （第 3 步 在项目中创建一个源存储库）：

    Admin:~/environment (main) $ git push origin main
Password for 'https://222581768915@git.us-west-2.codecatalyst.aws/v1/MySpace222581768915/Replication/Replication':

完成此过程后，您的 CodeCatalyst 存储库将包含您刚刚推送的更新文件和提交。现在，您可以从该分支创建开发环境并使用 AWS Cloud9 将其打开。下一节中概述了执行此操作的步骤。

第 5 步：使用 AWS Cloud9 在 CodeCatalyst 中创建一个开发环境

以下过程概述了如何在 CodeCatalyst 中使用 AWS Cloud9 和刚才复制的数据创建开发环境。

使用 AWS Cloud9 创建开发环境

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 导航到要在其中创建开发环境的项目。

  3. 在导航窗格中，选择概览，然后导航到我的开发环境部分。

  4. 选择创建开发环境。

  5. 从下拉菜单中选择 AWS Cloud9。

  6. 选择克隆存储库。

    注意

    目前，CodeCatalyst 不支持克隆第三方存储库，但您可以创建一个开发环境，并从所选的集成式开发环境中将第三方存储库克隆到该环境中。

  7. 请执行以下操作之一：

    1. 选择要克隆的存储库，选择在现有分支中工作，然后从现有分支下拉菜单中选择一个分支。

    2. 选择要克隆的存储库，选择在新分支中工作，在分支名称字段中输入分支名称，然后从创建分支自下拉菜单中选择要从中创建新分支的分支。

  8. 可选操作，为开发环境添加别名。

  9. 可选操作，选择开发环境配置编辑按钮，编辑开发环境的计算、存储或超时配置。

  10. 选择创建。在创建开发环境时，开发环境状态列将显示正在启动，开发环境创建完成后，状态列将显示正在运行。