

Aviso de fim do suporte: em 31 de maio de 2026, AWS encerrará o suporte para AWS Panorama. Depois de 31 de maio de 2026, você não poderá mais acessar o AWS Panorama console ou os AWS Panorama recursos. Para obter mais informações, consulte [AWS Panorama Fim do suporte](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar um ambiente de desenvolvimento no Windows
<a name="applications-devenvwindows"></a>

Para criar uma aplicação do AWS Panorama, você usa o Docker, ferramentas de linha de comando e Python. No Windows, você pode configurar um ambiente de desenvolvimento usando o Docker Desktop com o Subsistema do Windows para Linux e Ubuntu. Este tutorial mostra o processo de configuração de um ambiente de desenvolvimento que foi testado com ferramentas e aplicações de exemplo do AWS Panorama.

**Topics**
+ [Pré-requisitos](#applications-devenvwindows-prerequisites)
+ [Instalação do WSL 2 e do Ubuntu](#applications-devenvwindows-wsl2)
+ [Instalar o Docker](#applications-devenvwindows-docker)
+ [Configuração do Ubuntu](#applications-devenvwindows-ubuntu)
+ [Próximas etapas](#applications-devenvwindows-nextsteps)

## Pré-requisitos
<a name="applications-devenvwindows-prerequisites"></a>

Para seguir este tutorial, você precisa de uma versão do Windows que ofereça suporte ao Subsistema do Windows para Linux 2 (WSL 2).

****
+ Windows 10 versão 1903 e superior (compilação 18362 e superior) ou Windows 11
+ Atributos do Windows
  + Subsistema Windows para Linux
  + Hyper-V
  + Plataforma de máquina virtual

Este tutorial foi desenvolvido com as seguintes versões de software.

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

## Instalação do WSL 2 e do Ubuntu
<a name="applications-devenvwindows-wsl2"></a>

Se você tiver o Windows 10 versão 2004 e superior (compilação 19041 e superior), poderá instalar o WSL 2 e o Ubuntu 20.04 com o comando a seguir. PowerShell 

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

Para versões mais antigas do Windows, siga as instruções na documentação do WSL 2: [Etapas de instalação manual para versões mais antigas](https://docs.microsoft.com/en-us/windows/wsl/install-manual)

## Instalar o Docker
<a name="applications-devenvwindows-docker"></a>

Para instalar o Docker Desktop, baixe e execute o pacote do instalador em [hub.docker.com](https://hub.docker.com/editions/community/docker-ce-desktop-windows/). Se você encontrar problemas, siga as instruções no site do Docker: [Docker Desktop WSL 2 backend](https://docs.docker.com/desktop/windows/wsl/).

Execute o Docker Desktop e siga o tutorial de primeira execução para criar um contêiner de exemplo.

**nota**  
O Docker Desktop só ativa o Docker na distribuição padrão. Se você tiver outras distribuições Linux instaladas antes de executar este tutorial, habilite o Docker na distribuição Ubuntu recém-instalada no menu de configurações do Docker Desktop em **Resources**, **WSL integration**.

## Configuração do Ubuntu
<a name="applications-devenvwindows-ubuntu"></a>

Agora você pode executar comandos do Docker na sua máquina virtual Ubuntu. Para abrir um terminal de linha de comando, execute a distribuição no menu Iniciar. Na primeira execução, configure um nome de usuário e uma senha que podem ser usados para executar comandos do administrador.

Para concluir a configuração do seu ambiente de desenvolvimento, atualize o software da máquina virtual e instale as ferramentas.

**Para configurar a máquina virtual**

1. Atualize o software que vem com o Ubuntu.

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

1. Instale ferramentas de desenvolvimento com apt.

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

1. Instale as bibliotecas Python com o pip.

   ```
   $ pip3 install awscli panoramacli
   ```

1. Abra um novo terminal e, em seguida, execute `aws configure` para configurar a AWS CLI.

   ```
   $ aws configure
   ```

   Se não tiver chaves de acesso, você poderá criá-las no [console do IAM](https://console.aws.amazon.com/iamv2/home?#/users).

Por fim, baixe e importe a aplicação de exemplo.

**Para obter a aplicação de exemplo**

1. Faça o download e extraia a aplicação de exemplo.

   ```
   $ 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. Execute os scripts incluídos para testar a compilação, criar o contêiner da aplicação e fazer upload de pacotes para o 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
   ```

A CLI da aplicação do AWS Panorama carrega pacotes e os registra no serviço AWS Panorama. Agora você pode [implantar a aplicação de exemplo](gettingstarted-deploy.md#gettingstarted-deploy-deploy) com o console do AWS Panorama.

## Próximas etapas
<a name="applications-devenvwindows-nextsteps"></a>

Para explorar e editar os arquivos do projeto, você pode usar o Explorador de arquivos ou um ambiente de desenvolvimento integrado (IDE) que suporte WSL.

Para acessar o sistema de arquivos da máquina virtual, abra o Explorador de arquivos e digite `\\wsl$` na barra de navegação. Esse diretório contém um link para o sistema de arquivos da máquina virtual (`Ubuntu-20.04`) e sistemas de arquivos para os dados do Docker. Em `Ubuntu-20.04`, seu diretório de usuários está em `home\username`.

**nota**  
Para acessar arquivos em sua instalação do Windows a partir do Ubuntu, navegue até o diretório `/mnt/c`. Por exemplo, você pode listar arquivos em seu diretório de downloads executando `ls /mnt/c/Users/windows-username/Downloads`.

Com o Visual Studio Code, você pode editar o código da aplicação em seu ambiente de desenvolvimento e executar comandos com um terminal integrado. Para instalar o Visual Studio Code, visite [code.visualstudio.com](https://code.visualstudio.com/). Após a instalação, adicione a extensão [Remote WSL.](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl)

O Windows Terminal é uma alternativa ao terminal padrão do Ubuntu no qual você está executando comandos. Ele suporta várias guias e pode ser executado PowerShell, prompt de comando e terminais para qualquer outra variedade de Linux que você instalar. Ele suporta copiar e colar com  Ctrl C  e Ctrl V , clicável URLs e outras melhorias úteis. Para instalar o Windows Terminal, visite [microsoft.com](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701).