

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

# 使用 Amazon Elastic Cloud
<a name="ec2-overview"></a>

以下各部分介绍了如何在 AWS Toolkit for Visual Studio Code中使用 Amazon Elastic Compute Cloud。

## 先决条件
<a name="w2aac17c31b9b5"></a>

本用户指南主题中描述的功能已在使用以下操作系统的 Amazon EC2 实例上进行了测试：
+ Windows 2016\$1
**注意**  
此操作系统仅在连接 VS Code 终端时起才可运行。它连接完整 VS Code 远程实例时无法运行。有关 VS Code 终端和远程实例的更多信息，请参阅 VS Code 文档中的 [Getting started with the terminal](https://code.visualstudio.com/docs/terminal/getting-started) 和 [VS Code Remote Development](https://code.visualstudio.com/docs/remote/remote-overview) 主题。
+ Amazon Linux 2023
+ Ubuntu 22.04

要打开与 Amazon EC2 实例的远程连接，需要本地安装的 **SSH**，但无需使用本地安装的 SSH 即可打开与 Amazon EC2 实例的终端。

您的 Amazon EC2 实例配置文件必须包含以下 AWS Identity and Access Management (IAM) 权限。

```
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel",
"ssm:DescribeAssociation",
"ssm:ListAssociations",
"ssm:UpdateInstanceInformation
```

**注意**  
所需的权限包含在以下 AWS 托管策略中。  
`AmazonSSMManagedInstanceCore`
`AmazonSSMManagedEC2InstanceDefaultPolicy`

## 查看现有的 Amazon EC2 实例
<a name="w2aac17c31b9b7"></a>

要通过 AWS 工具包查看您的现有 Amazon EC2 实例，请完成以下步骤。

1. 在 AWS 工具包中，展开 AWS 工具包资源管理器。

1. 扩展包含您要查看的 Amazon EC2 实例的区域。

1. 展开标**EC2**题以显示您的现有 Amazon EC2 实例。

## 启动一个新的 Amazon EC2 实例
<a name="w2aac17c31b9b9"></a>

有三种方法可以使用该 AWS 工具包创建新的 Amazon EC2 实例。

每个工作流都会在 AWS 管理控制台中打开**启动实例**向导。**有关通过启动实例向导启动新 Amazon EC2 实例的详细信息，请参阅 A *mazon Elastic Compute Cloud* 用户指南中[控制台中的使用启动实例向导](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2-launch-instance-wizard.html)启动实例主题。** EC2要启动新的 Amazon EC2 实例，请完成以下步骤之一。

### 从 VS Code 命令面板启动一个新的 Amazon EC2 实例
<a name="w2aac17c31b9b9b7b1"></a>

1. 在 VS Code 中，按下 **command \$1 shift \$1 P (Windows: ctrl \$1 shift \$1 P)** 以打开 VS Code 命令面板

1. 在 VS Code 命令面板中，搜索该**AWS: Launch EC2**命令并在其填充到列表中时将其选中，以在 VS Code 中打开 Launch EC2 实例**选择区域**提示符。

1. 在启动 EC2 实例**选择区域**提示中，选择要在其中启动新实例的区域，然后确认要在默认 Web 浏览器中打开 AWS 控制台。

1. 在默认 Web 浏览器的 AWS 控制台中，完成身份验证过程以继续**启动实例**向导。

1. 在**启动实例**向导中，完成必填部分，然后选择**启动实例按钮以启动**您的新 Amazon EC2 实例。

1.  AWS Explorer 会更新以显示您的新 Amazon EC2 实例。

### 从 AWS Explorer 启动一个新的 Amazon EC2 实例
<a name="w2aac17c31b9b9b7b3"></a>

1. 展开 AWS Toolkit Explorer，然后展开要在其中创建新 Amazon EC2 实例的区域。

1. 展开或将鼠标悬停在**EC2**标题上，然后选择 **\$1（启动 EC2 实例）**图标。

1. 出现提示时，确认您要在默认 Web 浏览器中打开 AWS 控制台。

1. 在 Web 浏览器的 AWS 控制台中，完成身份验证过程以继续**启动实例**向导。

1. 在**启动实例**向导中，完成必填部分，然后选择**启动实例按钮以启动**您的新 Amazon EC2 实例。

1.  AWS Explorer 会更新以显示您的新 Amazon EC2 实例。

### 从上下文（右键单击）菜单启动新的 Amazon EC2 实例
<a name="w2aac17c31b9b9b7b5"></a>

1. 展开 AWS Toolkit Explorer，然后展开要在其中创建新 Amazon EC2 实例的区域。

1. 右键单击标**EC2**题，然后选择**启动 EC2 实例**。

1. 出现提示时，确认您要在默认 Web 浏览器中打开 AWS 控制台。

1. 在 Web 浏览器的 AWS 控制台中，完成身份验证过程以继续**启动实例**向导。

1. 在**启动实例**向导中，完成必填部分，然后选择**启动实例按钮以启动**您的新 Amazon EC2 实例。

1.  AWS Explorer 会更新以显示您的新 Amazon EC2 实例。

## 将 VS Code 连接到亚马逊 EC2 实例
<a name="w2aac17c31b9c11"></a>

通过 VS Code 连接亚马逊 EC2 实例有三种方法。要将 VS Code 连接到您的 EC2 实例，请完成以下过程之一。

### 通过命令面板将 VS Code 连接到 Amazon EC2 实例
<a name="w2aac17c31b9c11b5b1"></a>

1. 在 VS Code 中，按下 **command \$1 shift \$1 P (Windows: ctrl \$1 shift \$1 P)** 以打开 VS Code 命令面板

1. 从 VS Code 命令面板中搜索该**AWS: Connect VS Code to EC2 instance...**命令，并在该命令填充到列表中时将其选中，以在 VS Code 中打开 **“选择 EC2实例”** 提示符。

1. 在**选择 EC2 实例**提示中，选择包含您要连接的实例的区域，然后选择要连接的实例。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，将打开一个新窗口，显示您的 Amazon EC2 实例。

### 通过 AWS 资源管理器将 VS Code 连接到 Amazon EC2 实例。
<a name="w2aac17c31b9c11b5b3"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要连接的 Amazon EC2 实例的区域。

1. 将鼠标悬停在 Amazon EC2 实例上，然后选择**（将 VS 代码连接到 EC2 实例）**图标。
**注意**  
您也可以从 AWS 资源管理器的**EC2**服务标题中选择**（Connect VS Code 到 EC2实例）**图标。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，将打开一个新窗口，显示您的 Amazon EC2 实例。

### 通过右键单击菜单将 VS Code 连接到 Amazon EC2 实例
<a name="w2aac17c31b9c11b5b5"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要连接的 Amazon EC2 实例的区域。

1. 右键单击要连接的 Amazon EC2 实例，然后选择 C **onnect VS Code 到 EC2 实例**。
**注意**  
您也可以在 AWS 资源管理器中右键单击**EC2**服务标题，然后选择**要 EC2实例的 Connect VS Code**。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，将打开一个新窗口，显示您的 Amazon EC2 实例。

## 打开一个连接到 Amazon EC2 实例的终端。
<a name="w2aac17c31b9c13"></a>

有三种方法可以从 VS Code 终端连接到 Amazon EC2 实例。

### 通过命令面板将 VS Code 连接到 Amazon EC2 实例
<a name="w2aac17c31b9c13b5b1"></a>

1. 在 VS Code 中，按下 **command \$1 shift \$1 P (Windows: ctrl \$1 shift \$1 P)** 以打开 VS Code 命令面板

1. 从 VS Code 命令面板中搜索该**AWS:Open terminal to EC2 instance...**命令，并在该命令填充到列表中时将其选中，以在 VS Code 中打开 **“选择 EC2实例”** 提示符。

1. 从 **“选择 EC2 实例”** 提示中，选择包含要在终端中打开的实例的区域，然后选择该实例。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，系统将打开 VS Code 终端，显示您的新会话。

### 通过 AWS 资源管理器在 VS Code 终端中打开一个 Amazon EC2 实例。
<a name="w2aac17c31b9c13b5b3"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要连接的 Amazon EC2 实例的区域。

1. 将鼠标悬停在 Amazon EC2 实例上，然后选择**（打开终端到 EC2实例...）** 图标。
**注意**  
你也可以选择**（打开终端到 EC2实例...）** AWS 资源管理器中**EC2**服务标题中的图标。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，系统将打开 VS Code 终端，显示您的新会话。

### 通过右键单击菜单在 VS Code 终端中打开 Amazon EC2 实例
<a name="w2aac17c31b9c13b5b5"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含要在 VS Code 终端中打开的 Amazon EC2 实例的区域。

1. 右键单击要在终端中打开的 Amazon EC2 实例，然后选择**打开终端到 EC2实例...** 。
**注意**  
您也可以在 AWS 资源管理器中右键单击**EC2**服务标题，然后选择**打开终端进行 EC2实例...** 。

1. VS Code 在建立连接时会显示状态。

1. 连接完成后，系统将打开 VS Code 终端，显示您的新会话。

## 启动或重启 Amazon 实例 EC2
<a name="w2aac17c31b9c15"></a>

有三种方法可以启动或重启 Amazon EC2 实例。

### 从命令面板重启 Amazon EC2 实例
<a name="w2aac17c31b9c15b5b1"></a>

1. 在 VS Code 中，按下 **command \$1 shift \$1 P (Windows: ctrl \$1 shift \$1 P)** 以打开 VS Code 命令面板

1. 从 VS Code 命令面板中搜索该**AWS: Reboot EC2 instance**命令，并在该命令填充到列表中时将其选中，以在 VS Code 中打开 **“选择 EC2实例”** 提示符。
**注意**  
要启动未运行的实例，必须选择 **AWS: Start EC2 instance** 命令。**AWS: Reboot EC2 instance** 命令仅重启当前正在运行的实例。

1. 从 **“选择 EC2 实例”** 提示中，选择包含您要启动或重启的实例的区域。

1. VS Code 会在实例重启时显示状态。

1. E AWS xplorer 会更新以显示您的实例在完成重启后正在运行。

### 从资源管理器启动或重启 Amazon EC2 实例 AWS
<a name="w2aac17c31b9c15b5b3"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要启动或重启的 Amazon EC2 实例的区域。

1. 将鼠标悬停在 Amazon EC2 实例上，然后选择**（重启 EC2 实例）**图标。
**注意**  
如果实例已停止，则唯一的选项是**（启动 EC2 实例）**图标

1. VS Code 会在实例重启时显示状态。

1. E AWS xplorer 会更新以显示您的实例在完成重启后正在运行。

### 通过右键单击菜单启动或重启 Amazon EC2 实例
<a name="w2aac17c31b9c15b5b5"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要启动或重启的 Amazon EC2 实例的区域。

1. 右键单击要连接的 Amazon EC2 实例，然后选择**重启 EC2 实例**。
**注意**  
如果实例已停止，则唯一的选项是**启动 EC2 实例**。

1. VS Code 会在实例重启时显示状态。

1. E AWS xplorer 会更新以显示您的实例在完成重启后正在运行。

## 停止 Amazon EC2 实例
<a name="w2aac17c31b9c17"></a>

有三种方法可以停止 Amazon EC2 实例。

### 从命令面板中停止 Amazon EC2 实例
<a name="w2aac17c31b9c17b5b1"></a>

1. 在 VS Code 中，按下 **command \$1 shift \$1 P (Windows: ctrl \$1 shift \$1 P)** 以打开 VS Code 命令面板

1. 从 VS Code 命令面板中搜索该**AWS: Stop EC2 instance**命令，并在该命令填充到列表中时将其选中，以在 VS Code 中打开 **“选择 EC2实例”** 提示符。

1. 从 **“选择 EC2 实例”** 提示中，选择包含您要停止的实例的区域。

1. VS Code 会在实例停止时显示状态。

1. E AWS xplorer 会更新以显示您的实例已停止。

### 从 AWS Explorer 中停止 Amazon EC2 实例
<a name="w2aac17c31b9c17b5b3"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要停止的 Amazon EC2 实例的区域。

1. 将鼠标悬停在 Amazon EC2 实例上，然后选择**（停止 EC2 实例）**图标。

1. VS Code 会在实例停止时显示状态。

1. E AWS xplorer 会更新以显示您的实例已停止。

### 通过右键单击菜单停止 Amazon EC2 实例
<a name="w2aac17c31b9c17b5b5"></a>

1. 展开 AWS Toolkit Explorer，然后展开包含您要停止的 Amazon EC2 实例的区域。

1. 右键单击要连接的 Amazon EC2 实例，然后选择**重启 EC2 实例**。

1. VS Code 会在实例停止时显示状态。

1. E AWS xplorer 会更新以显示您的实例已停止。

## 复制实例 ID
<a name="w2aac17c31b9c19"></a>

要复制实例 ID，请完成以下步骤。

1. 右键单击要从中复制 ID 的实例。

1. 选择**复制实例 ID**。

1. 系统会将实例 ID 复制到您的本地剪贴板。

## 复制名称
<a name="w2aac17c31b9c21"></a>

要复制实例名称，请完成以下步骤。

1. 右键单击要从中复制名称的实例。

1. 选择**复制实例名称**。

1. 系统会将实例名称复制到您的本地剪贴板。

## 复制 ARN
<a name="w2aac17c31b9c23"></a>

要复制实例 ARN，请完成以下步骤。

1. 右键单击要从中复制 ARN 的实例。

1. 选择**复制实例 ARN**。

1. 系统会将实例 ARN 复制到您的本地剪贴板。