Configurar um ambiente de desenvolvimento no Windows - AWS Panorama
Pré-requisitosInstalação do WSL 2 e do UbuntuInstalar o DockerConfiguração do UbuntuPróximas etapas

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

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.

Pré-requisitos

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

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 seguinte comando do 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

Instalar o Docker

Para instalar o Docker Desktop, baixe e execute o pacote do instalador em hub.docker.com. Se você encontrar problemas, siga as instruções no site do Docker: Docker Desktop WSL 2 backend.

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

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

  2. Instale ferramentas de desenvolvimento com apt.

    $ sudo apt install unzip python3-pip

  3. Instale as bibliotecas Python com o pip.

    $ pip3 install awscli panoramacli

  4. 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.

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

  2. 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 com o console do AWS Panorama.

Próximas etapas

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. Após a instalação, adicione a extensão 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 executar PowerShell, Prompt de comando e terminais para qualquer outra variedade de Linux que você instalar. Ele permite copiar e colar com Ctrl +C e Ctrl +V , URLs clicáveis e outras melhorias úteis. Para instalar o Windows Terminal, visite microsoft.com.