

终止支持通知：2026 年 5 月 31 日， AWS 将终止对的支持。 AWS Panorama 2026 年 5 月 31 日之后，您将无法再访问 AWS Panorama 控制台或 AWS Panorama 资源。有关更多信息，请参阅[AWS Panorama 终止支持](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html)。

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

# 在 Windows 中设置开发环境
<a name="applications-devenvwindows"></a>

要构建 AWS Panorama 应用程序，您需要使用 Docker、命令行工具和 Python。在 Windows 中，您可以使用与 Windows Subsystem for Linux 和 Ubuntu 兼容的 Docker Desktop 来设置开发环境。本教程将指导您了解使用 AWS Panorama 工具和示例应用程序测试过的开发环境的设置过程。

**Topics**
+ [

## 先决条件
](#applications-devenvwindows-prerequisites)
+ [

## 安装 WSL 2 与 Ubuntu
](#applications-devenvwindows-wsl2)
+ [

## 安装 Docker
](#applications-devenvwindows-docker)
+ [

## 配置 Ubuntu
](#applications-devenvwindows-ubuntu)
+ [

## 后续步骤
](#applications-devenvwindows-nextsteps)

## 先决条件
<a name="applications-devenvwindows-prerequisites"></a>

要学习本教程，您需要一个与 Windows Subsystem for Linux 2 (WSL 2) 的 Windows 版本。

****
+ Windows 10 版本 1903 及更高版本（Build 18362 及更高版本）或 Windows 11
+ Windows 功能
  + Windows Subsystem for Linux
  + Hyper-V
  + 虚拟机平台

本教程使用以下软件版本开发。

****
+ Ubuntu 20.04
+ Python 3.8.5
+ Docker 20.10.8

## 安装 WSL 2 与 Ubuntu
<a name="applications-devenvwindows-wsl2"></a>

如果你有 Windows 10 版本 2004 及更高版本（Build 19041 及更高版本），则可以使用以下命令安装 WSL 2 和 Ubuntu 20.04。 PowerShell 

```
> wsl --install -d Ubuntu-20.04
```

对于较旧的 Windows 版本，请按照 WSL 2 文档中的说明进行操作：[旧版本手动安装步骤](https://docs.microsoft.com/en-us/windows/wsl/install-manual)

## 安装 Docker
<a name="applications-devenvwindows-docker"></a>

要安装 Docker Desktop，请从 [hub.docker.com](https://hub.docker.com/editions/community/docker-ce-desktop-windows/) 下载安装程序包并运行。如遇到问题，请按照 Docker 网站上的说明进行操作：[Docker Desktop WSL 2 后端](https://docs.docker.com/desktop/windows/wsl/)。

运行 Docker Desktop 并按照首次运行的教程构建示例容器。

**注意**  
Docker Desktop 仅在默认发行版中启用 Docker。如果您在运行本教程之前安装了其他 Linux 发行版本，请在新安装的 Ubuntu 发行版中，在**资源**、**WSL 集成**下的 Docker Desktop 设置菜单中启用 Docker。

## 配置 Ubuntu
<a name="applications-devenvwindows-ubuntu"></a>

您现在可以在 Ubuntu 虚拟机中运行 Docker 命令。要打开命令行终端，请从开始菜单运行发行版本。首次运行时，需要设置用户名和密码，用于运行管理员命令。

要完成开发环境的配置，请更新虚拟机的软件并安装工具。

**配置虚拟机**

1. 更新 Ubuntu 自带的软件。

   ```
   $ sudo apt update && sudo apt upgrade -y && sudo apt autoremove
   ```

1. 使用 apt 安装开发工具。

   ```
   $ sudo apt install unzip python3-pip
   ```

1. 使用 pip 安装 Python 库。

   ```
   $ pip3 install awscli panoramacli
   ```

1. 打开一个新终端，然后运行 `aws configure` 以配置 AWS CLI。

   ```
   $ aws configure
   ```

   如果没有访问密钥，您可以在 [IAM 控制台](https://console.aws.amazon.com/iamv2/home?#/users)中生成。

最后，下载并导入示例应用程序。

**获取示例应用程序**

1. 下载并解压示例应用程序。

   ```
   $ wget https://github.com/awsdocs/aws-panorama-developer-guide/releases/download/v1.0-ga/aws-panorama-sample.zip
   $ unzip aws-panorama-sample.zip
   $ cd aws-panorama-sample
   ```

1. 运行随附的脚本以测试编译、构建应用程序容器并将程序包上传到 AWS Panorama。

   ```
   aws-panorama-sample$ ./0-test-compile.sh
   aws-panorama-sample$ ./1-create-role.sh
   aws-panorama-sample$ ./2-import-app.sh
   aws-panorama-sample$ ./3-build-container.sh
   aws-panorama-sample$ ./4-package-app.sh
   ```

AWS Panorama 应用程序 CLI 会上传程序包并将其注册到 AWS Panorama 服务。现在，您可以使用 AWS Panorama 控制台[部署示例应用程序](gettingstarted-deploy.md#gettingstarted-deploy-deploy)。

## 后续步骤
<a name="applications-devenvwindows-nextsteps"></a>

要浏览和编辑项目文件，您可以使用文件资源管理器或支持 WSL 的集成式开发环境 (IDE)。

要访问虚拟机的文件系统，请打开文件资源管理器并在导航栏中输入 `\\wsl$`。此目录包含链接至虚拟机的文件系统 (`Ubuntu-20.04`) 和 Docker 数据的文件系统的链接。在 `Ubuntu-20.04` 下，您的用户目录位于 `home\username`。

**注意**  
要从 Ubuntu 中访问 Windows 安装中的文件，请导航到 `/mnt/c` 目录。例如，您可以通过运行 `ls /mnt/c/Users/windows-username/Downloads` 来列出下载目录中的文件。

您可以使用 Visual Studio Code 在开发环境中编辑应用程序代码，并通过集成终端运行命令。要安装 Visual Studio Code，请访问 [code.visualstudio.com](https://code.visualstudio.com/)。完成安装后，添加[远程 WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) 扩展。

您一直在使用标准 Ubuntu 终端运行命令，而 Windows 终端是其替代方案。它支持多个选项卡 PowerShell，可以在你安装的任何其他类型的 Linux 上运行、命令提示符和终端。它支持使用和进行复制 Ctrl C 和粘贴 Ctrl V  URLs、可点击以及其他有用的改进。要安装 Windows 终端，请访问 [microsoft.com](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701)。