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

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

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

从亚马逊迁移 AWS Cloud9 到亚马逊 CodeCatalyst

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

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

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

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

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

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

以新用户身份注册

  1. 打开控制CodeCatalyst台。

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

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

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

  4. 在 “您的姓名” 中，输入要在使用 AWS 建筑商 ID 的应用程序中显示的名字和姓氏。

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

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

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

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

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

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

  7. 在创建您的别名页面上，输入要使用的别名 CodeCatalyst。其他 CodeCatalyst 用户将在评论和拉取请求中使用这个别名给 @mention you。您的 CodeCatalyst 个人资料将包含您在 AWS 建造者 ID 中的全名和您的 CodeCatalyst 别名。您无法更改您的 CodeCatalyst 别名。

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

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

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

    您无法更改空间名称。

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

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

  10. 选择 “验证” AWS。

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

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

    要访问该页面，请登录中的 Amazon CodeCatalyst Spaces AWS Management Console。

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

  12. 选择验证空间。

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

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

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

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

  13. 选择 “前往亚马逊” 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. 在存储库名称中，输入存储库的名称。

    一个项目中的存储库名称必须唯一。有关存储库名称要求的更多信息，请参阅中的源存储库配额 CodeCatalyst。

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

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

  8. 选择创建。

    注意

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

  9. 要克隆源存储库 URLPAT，请选择 “克隆存储库”。

  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 源存储库所遵循的复制方法。这些方法如下所示：

使用 GitHub 中的存储库 CodeCatalyst

使用 GitHub 存储库扩展，你可以使用链接 GitHub 来自 Amazon CodeCatalyst 项目 AWS Cloud9 中的存储库。以下步骤概述了如何安装 GitHub CodeCatalyst 目录中的扩展。这些步骤还显示了如何连接现有的 GitHub 账号到你的 CodeCatalyst 空间并关联你的 GitHub 存储库到您的 CodeCatalyst 项目。

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

重要

作为安装和配置的一部分 Github 存储库扩展，你必须将扩展安装到你的 GitHub account。要做到这一点，你必须是一个 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 “帐户” 选项卡，选择 Connect GitHub 要访问外部网站的账户 GitHub.

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

  3. 选择是否允许 CodeCatalyst 访问所有当前和将来的存储库。或者，也可以选择具体的 GitHub 您要在中使用的存储库 CodeCatalyst。默认选项为 “全部” GitHub 中的存储库 GitHub 空间。

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

连接完你的 GitHub 账户到 CodeCatalyst，你可以在中查看关联的账户 GitHub 的 “帐户” 选项卡 GitHub 存储库扩展详情页面。

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

第 3 步。要链接 GitHub 从存储库到 CodeCatalyst项目 GitHub 存储库扩展详情页面

  1. 在链接中 GitHub “存储库” 选项卡，选择 “链接” GitHub 存储库。 。

  2. 对于 GitHub 账户，选择 GitHub 包含您要链接的存储库的帐户。

  3. 对于 GitHub 存储库，选择要链接到 CodeCatalyst 项目的存储库。

  4. 对于CodeCatalyst CodeCatalyst 项目，请选择要链接的项目 GitHub 存储库到。

  5. 选择关联。

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

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

使用非-GitHub 中的存储库 CodeCatalyst

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

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

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

创建个人访问令牌 (PAT)

  1. 打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

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

    提示

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

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

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

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

  6. 选择创建。

    提示

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

  7. 要复制PAT密钥，请选择 “复制”。将PAT密钥存储在可以检索的地方。

    重要

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

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

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

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

在中添加一个远程存储库，该存储库指向您在中复制过程的步骤 3 中创建的源存储库 CodeCatalyst。 AWS Cloud9 IDE将命令CODECATALYST_SOURCE_REPO_CLONE_URL中的内容替换为URL在步骤 3 的步骤 10 中保存的克隆。（第 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将其打开。有关开发环境的更多信息，请参阅中的开发环境 CodeCatalyst。

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

在中使用空存储库 AWS Cloud9

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

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

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

创建个人访问令牌 (PAT)

  1. 打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

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

    提示

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

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

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

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

  6. 选择创建。

    提示

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

  7. 要复制PAT密钥，请选择 “复制”。将PAT密钥存储在可以检索的地方。

    重要

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

PAT为源存储库创建后， CodeCatalyst 通过在 AWS Cloud9 环境中启动一个空存储库并指向您在中创建的源存储库，将数据从您的 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. 从中克隆URL源存储库 CodeCatalyst。导航到您在 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

以下过程概述了如何在using中 CodeCatalyst 创建开发环境 AWS Cloud9 以及您刚刚复制的数据。

使用创建开发环境 AWS Cloud9

  1. 打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

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

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

  4. 选择创建开发环境。

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

  6. 选择克隆存储库。

    注意

    目前， CodeCatalyst 不支持克隆第三方存储库，但您可以创建开发环境并从您选择的第三方存储库克隆到该环境中IDE。

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

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

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

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

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

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