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

# 在开发环境中使用 Toolkit
<a name="codecatalyst-devenvironment"></a>

开发环境是 Amazon 的虚拟计算环境 CodeCatalyst。以下各节介绍了如何通过 AWS Toolkit for Visual Studio Code创建、启动和使用开发环境。

有关开发环境的详细信息，请参阅 *Amazon CodeCatalyst* 用户指南中的[开发环境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)主题。

## 使用 devfile 配置您的开发环境
<a name="codecatalyst-devenvironment-devfile"></a>

`devfile` 规范是 YAML 的开放标准格式，可用于定义开发环境的配置。每个开发环境都有一个 devfile。如果您创建的开发环境没有存储库，或者存储库中未包含 devfile，则系统会自动将默认设置应用于源。可以从 CodeCatalyst 或您的 IDE 更新开发文件。在 VS Code 的本地或远程实例中更新 devfile 的流程完全相同，但是如果您在本地更新 devfile，这些更新只有在推送到源存储库之后才会生效。

有关使用开发文件配置开发环境的详细信息，请参阅 *Amazon CodeCatalyst* 用户指南中的[配置开发环境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-devfile.html)主题。

以下过程介绍当 devfile 在开发环境中运行时，如何通过 Toolkit 的远程实例对其进行编辑。

**重要**  
如果您通过 VS Code 编辑 `Devfile`，请注意以下事项：  
更改 devfile 的名称或 devfile 组件名称会替换根目录的内容。之前的所有内容均已丢失且不可恢复。
如果您创建的开发环境根文件夹中没有 devfile，或者创建的开发环境未与源存储库相关联，则在创建开发环境时，系统会为其生成一个具有默认配置设置的 devfile。
有关如何定义和配置 `Devfile` 的说明，请参阅 [devfile.io](https://devfile.io/) 网站上的[添加命令](https://devfile.io/docs/2.1.0/adding-commands)文档。

1. 在 Toolkit for VS Code 中，展开**开发人员工具**资源管理器。

1. 展开**CodeCatalyst**并选择 “**打开 Devfile**”，`devfile.yaml`在当前开发环境中的新编辑器窗口中打开。

1. 在 VS Code 编辑器中，更新您的 devfile，然后保存您所做的更改。

1. 下次启动开发环境时，配置会更新以匹配您在 `Devfile` 中定义的规范。

## 通过您的开发环境进行身份验证和连接 AWS
<a name="codecatalyst-devenvironment-credentials"></a>

要从开发环境访问所有 AWS 资源，您必须进行身份验证并将工具包的远程实例与您的 AWS 账户连接起来。当开发环境启动时，Toolkit 的远程实例会自动使用从您的 Toolkit 本地实例继承的凭证进行身份验证。

更新 Toolkit 远程实例凭证的过程与您的 Toolkit 本地实例中的身份验证体验完全相同。有关如何通过 Toolkit 更新凭证、进行身份验证和连接到 AWS 的详细说明，请参阅本用户指南的“开始使用”**主题中的[连接到 AWS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html#connect-to-aws) 部分。

有关与兼容的每种 AWS 身份验证方法的更多信息 AWS Toolkit for Visual Studio Code，请参阅本用户指南中的[身份验证和访问](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html#connect-to-aws)主题。

## 在开发环境中使用 Toolkit for VS Code
<a name="codecatalyst-devenvironment-toolkit"></a>

在 VS Code 中打开或创建开发环境后，您可以使用 Toolkit for VS Code 进行工作，这类似于在 VS Code 的本地实例中的工作方式。运行 VS Code 的开发环境配置为自动安装 AWS 工具包并使用您的 AWS 生成器 ID 进行连接。

### 停止开发环境
<a name="codecatalyst-devenvironment-stop"></a>

要停止当前的开发环境，请执行以下操作：

1. 在 Toolkit for VS Code 中，展开**开发人员工具**资源管理器。

1. 展开**CodeCatalyst**并选择 “**停止开发环境**”。

1. 当 VS Code 显示提示时，请确认您是否要停止开发环境。

1. 当 VS Code 关闭远程连接并返回到本地开发实例时，您的开发环境已成功停止。

### 打开开发环境设置
<a name="codecatalyst-devenvironment-settings"></a>

要打开当前开发环境的设置，请完成以下步骤：

**注意**  
开发环境在创建之后就无法更改分配到其中的存储空间量。

1. 在 Toolkit for VS Code 中，展开**开发人员工具**资源管理器。

1. 展开**CodeCatalyst**并选择 “**打开设置”**，打开当前**开发环境的 “开发环境设置”** 视图。

1. 在 **Dev Environment Settings**（开发环境设置）视图中，以下部分包含开发环境的选项：
   + **Alias**（别名）：查看和更改分配给您的开发环境的 **Alias**（别名）。
   + **状态**：查看您当前的开发环境状态、已分配给开发环境的项目以及停止开发环境。
   + **Devfile**：查看开发环境的 `Devfile` 的名称和位置。选择**在编辑器中打开**按钮可打开 `Devfile`。
   + **计算设置：**更改开发环境的大小和默认**超时长度**。