AWS Cloud9 不再向新客户提供。 AWS Cloud9 的现有客户可以继续正常使用这项服务。[了解详情](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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

# 使用复制工具
<a name="c9-replication-cc-tool"></a>

AWS Cloud9 in CodeCatalyst 为与之交互提供了完全托管的体验 AWS Cloud9。为了让客户能够尝试 AWS Cloud9 在中使用 CodeCatalyst，我们创建了一个复制工具。在您的 AWS Cloud9 环境中复制并运行脚本后，请按照提示运行该脚本并将您的代码资源从复制 AWS Cloud9 到 CodeCatalyst。有关复制工具和过程的更多信息，请参阅下面概述的 [FAQ's on the replication process](https://docs.aws.amazon.com/cloud9/latest/user-guide/faqs-replication-tool)。

**注意**  
此复制过程不会对您现有的 AWS Cloud9 环境产生任何影响。复制过程完成后，您可以删除开发环境、源存储库、项目和空间，这不会对您的 AWS Cloud9 环境产生任何影响。此工具只会将您的代码资源复制到 AWS Cloud9 中 CodeCatalyst，不会删除或配置您的现有 AWS Cloud9 环境。此复制工具已发布给初始选定的 AWS 账户组。因此，它可能不会出现在某些 AWS 账户中。

**注意**  
建议您在下载该工具之前先注册 Amazon CodeCatalyst 并创建空间。有关注册的信息 CodeCatalyst，请参阅[注册 Amazon CodeCatalyst 并创建空间](c9-replication-cc.md#c9-replication-cc-space-creation)。

## 在亚马逊 AWS Cloud9 上使用的好处 CodeCatalyst
<a name="cloud9-codecatalyst-benefits"></a>

以下部分概述了在 AWS Cloud9 上使用时将体验到的一些性能优势和增强功能 CodeCatalyst：
+ CodeCatalyst 提供集成体验，使您能够使用完全托管的开发环境从一个位置管理整个软件开发生命周期。
+ 改进了发布时的 Amazon EBS 卷大小选项。
+ 支持临时环境，并能够按需扩展开发环境的计算。
+ 自定义 AMI 支持，可通过自定义映像的规范获得。
+ Devfile 支持，让您能够将配置描述为代码。

## CodeCatalyst 使用复制工具在中复制您的 AWS Cloud9 代码资源
<a name="c9-replication-cc-tool-steps"></a>

以下过程详细介绍了如何复制和运行复制工具，完成复制过程。

1. 复制下面的脚本并确保在 AWS Cloud9 环境中运行它：

   ```
   curl https://dx5z5embsyrja.cloudfront.net -o /tmp/replicate-tool.tar.gz && tar --no-same-owner --no-same-permissions -xvf /tmp/replicate-tool.tar.gz -C /tmp && node /tmp/cloud9-replication-tools
   ```

1. *[可选]* 复制工具使用您的 AWS 账户 ID 进行遥测。该操作的目的是帮助我们更好地识别您在使用该工具时可能遇到的任何问题。我们会发出 `tool starts`、`tool fails`、`tool is cancelled by user`、`tool completes successfully` 和 `tool creates a Dev Environment for the user` 遥测事件。如果要禁用复制工具遥测，请参阅下面的[禁用复制工具的遥测](#disable-telemetry)。

1. 在您的 AWS Cloud9 环境中复制并运行复制工具后，您需要在浏览器中导航到访问网址，然后在 10 分钟内单击 “*允许*”，从而将您的 AWS 账户 与 AWS 构建器 ID 关联起来。请确保您只打开该链接一次，如果您多次打开该链接，则会导致错误，并且需要重新开始。有关 AWS 生成器 ID 的更多信息，请参阅《[登录用户指南》中的 “使用 AWS 生成器 ID AWS](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html) *登录”*。这将授予复制工具访问您的代码资源的权限，以便在中 CodeCatalyst进行复制。

1. 选择要使用的空间。如果您只有一个空间，则会选择该空间。有关空间的更多信息，请参阅 *Amazon CodeCatalyst 用户指南 CodeCatalyst*[中的空间](https://docs.aws.amazon.com/codecatalyst/latest/userguide/spaces.html)。

1. 选择是要在中复制代码， CodeCatalyst 还是要在新的开发环境中试一试。我们建议直接在中 CodeCatalyst复制您的代码。有关开发环境的更多信息，请参阅 *Amazon CodeCatalyst 用户指南 CodeCatalyst*[中的开发环境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)。

1. 输入项目的名称或按 Enter 键使用提供的默认名称。

1. 出现提示时，选择要如何将文件复制到中的新源存储库 CodeCatalyst。您可以选择将根文件夹推送到单个 CodeCatalyst 存储库，也可以选择将子文件夹推送到不同的 CodeCatalyst 存储库。

1. 工具完成后，通过终端消息中提供的 URL 在 CodeCatalyst控制台中导航到该项目，以访问您的代码资源 CodeCatalyst。

完成此过程后，您的 CodeCatalyst 存储库将包含您刚刚推送的更新文件和提交。现在，您可以从该分支创建开发环境并使用 AWS Cloud9将其打开。

## 禁用复制工具的遥测
<a name="disable-telemetry"></a>

以下步骤概述了如何设置环境变量来禁用复制工具的遥测。

1. 在您的 AWS Cloud9 环境中打开终端

1. 运行以下命令之一：

   ```
   export CLOUD9_REPLICATION_TOOL_TELEMETRY=off
   ```

   或者

   ```
   export CLOUD9_REPLICATION_TOOL_TELEMETRY=0
   ```

1. 运行上述命令之一后，将设置环境变量并禁用复制工具的遥测。禁用遥测后，必须复制并重新运行复制工具脚本才能开始该过程。

## 复制工具反馈
<a name="troubleshooting-migration-tool"></a>

如果您遇到任何问题，或者想就使用复制工具的体验提供反馈，请创建支持案例并提交。有关创建支持案例的更多信息，请参阅 [Creating support cases and case management](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)。

## AWS Cloud9 和 Amazon 之间的区别 CodeCatalyst
<a name="cc-differences-c9"></a>

下表概述了两者 AWS Cloud9 之间 AWS Cloud9 的一些区别 CodeCatalyst。


| AWS Cloud9 | AWS Cloud9 在亚马逊上 CodeCatalyst | 
| --- | --- | 
| 私有 VPC 非常适合使用 AWS Cloud9。 | 上目前不支持使用私有 VP AWS Cloud9 C CodeCatalyst。 | 
| AWS Cloud9 支持预配置的 AWS 托管凭证。 | 需要为开手动配置凭证 CodeCatalyst。 AWS Cloud9  | 
| 间隔可以在 30 分钟到 7 天之间，也可以使用 AWS Cloud9禁用关机。 | 开启间隔可能为 15 分钟到 20 小时， CodeCatalyst 并且您无法禁用关机。 AWS Cloud9  | 
| AWS Cloud9 支持 Ubuntu 和 AL2 操作系统平台。 | AWS Cloud9 on CodeCatalyst 支持 MDE 通用镜像和自定义镜像，其中可以包含 Ubuntu 和。 AL2有关这方面的更多信息，请参阅 *Amazon CodeCatalyst 用户指南*中的[通用开发文件镜像](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-universal-image.html)。 | 
| 中支持上传和下载 AWS Cloud9 | on 目前不支持上传和 AWS Cloud9 下载 CodeCatalyst。用户需要使用 Amazon S3 存储桶进行上传和下载。 | 
| 协作可用于 AWS Cloud9 | 协作功能目前不可用 AWS Cloud9 CodeCatalyst。 |