在 Windows 中设置开发环境

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

先决条件

要学习本教程，您需要一个与 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

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

> wsl --install -d Ubuntu-20.04

对于较旧的 Windows 版本，请按照 WSL 2 文档中的说明进行操作：旧版本手动安装步骤

安装 Docker

要安装 Docker Desktop，请从 hub.docker.com 下载安装程序包并运行。如遇到问题，请按照 Docker 网站上的说明进行操作：Docker Desktop WSL 2 后端。

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

注意

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

配置 Ubuntu

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

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

配置虚拟机

1. 更新 Ubuntu 自带的软件。

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

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

   $ sudo apt install unzip python3-pip

3. 使用 pip 安装 Python 库。

   $ pip3 install awscli panoramacli

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

   $ aws configure

   如果没有访问密钥，您可以在 IAM 控制台中生成。

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

获取示例应用程序

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

2. 运行随附的脚本以测试编译、构建应用程序容器并将程序包上传到 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 控制台部署示例应用程序。

后续步骤

要浏览和编辑项目文件，您可以使用文件资源管理器或支持 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。完成安装后，添加远程 WSL 扩展。

您一直在使用标准 Ubuntu 终端运行命令，而 Windows 终端是其替代方案。此终端支持多个选项卡，可运行 PowerShell、命令提示符和您安装的任何其他类型的 Linux 终端。还支持使用 Ctrl +C 和 Ctrl +V 复制粘贴、可点击访问的 URL 以及其他实用的改进。要安装 Windows 终端，请访问 microsoft.com。