O AWS Toolkit for Visual Studio: trabalhar com o .NET Core

O AWS Toolkit for Visual Studio é um plugin para o Visual Studio IDE. Com o toolkit, é possível implantar e gerenciar aplicações no Elastic Beanstalk enquanto trabalha no ambiente do Visual Studio.

Este tópico mostra como você pode executar as seguintes tarefas usando o AWS Toolkit for Visual Studio:

• Crie uma aplicação Web ASP.NET Core usando um modelo do Visual Studio.

• Crie um ambiente Amazon Linux do Elastic Beanstalk.

• Implante a aplicação Web ASP.NET Core no novo ambiente Amazon Linux.

Este tópico também explora como você pode usar o AWS Toolkit for Visual Studio para gerenciar os ambientes de aplicação do Elastic Beanstalk e monitorar a integridade da aplicação.

Seções

• Pré-requisitos
• Criar um projeto de aplicação
• Criar um ambiente do Elastic Beanstalk e implantar a aplicação
• Encerrar um ambiente
• Gerenciar os ambientes de aplicações do Elastic Beanstalk
• Monitorar a integridade do aplicativo

Pré-requisitos

Antes de iniciar este tutorial, é necessário instalar o AWS Toolkit for Visual Studio. Para obter instruções, consulte Configurar o AWS Toolkit for Visual Studio.

Se nunca usou o toolkit, a primeira coisa que você precisará fazer após instalá-lo será inscrever-se com as credenciais da AWS com o toolkit. Para obter mais informações sobre isso, consulte Fornecer credenciais da AWS.

Criar um projeto de aplicação

Se você não tiver um projeto de aplicação .NET Core no Visual Studio, poderá facilmente criar um usando um dos modelos de projeto do Visual Studio.

Como criar um novo projeto de aplicação Web ASP.NET Core

1. No Visual Studio, no menu File (Arquivo), escolha New (Novo) e, depois, escolha Project (Projeto).

2. Na caixa de diálogo Create a new project (Criar um projeto), selecione C#, Linux e Cloud (Nuvem).

3. Na lista de modelos de projeto exibida, selecione ASP.NET Core Web Application (Aplicação Web ASP.NET Core) e Next (Próximo).

   nota

   Se a ASP.NET Core Web Application (Aplicação Web ASP.NET Core) não estiver listada nos modelos de projeto, você poderá instalá-la no Visual Studio.

   1. Role até a parte inferior da lista de modelos e selecione o link Install more tools and features (Instalar mais ferramentas e recursos) que está localizado na lista de modelos.

   2. Se você for solicitado a permitir que a aplicação do Visual Studio, faça alterações no dispositivo, selecione Yes (Sim).

   3. Selecione a guia Workloads (Cargas de trabalho) e a opção ASP.NET and web development (ASP.NET e desenvolvimento Web).

   4. Selecione o botão Modify (Modificar). O Visual Studio Installer (Instalador do Visual Studio) instala o modelo de projeto.

   5. Depois que o instalador for concluído, saia do painel para retornar ao ponto em que você parou no Visual Studio.

4. Na caixa de diálogo Configure your new project (Configurar o novo projeto), insira um Project name (Nome do projeto). O Solution name (Nome da solução) é padrão para o nome do projeto. Depois, selecione Create (Criar).

5. Na caixa de diálogo Create a new ASP.NET Core web application (Criar uma aplicação Web ASP.NET Core), selecione .NET Core e ASP.NET Core 3.1. Na lista de tipos de aplicação exibida, selecione Web Application (Aplicação Web) e selecione o botão Create (Criar).

   

O Visual Studio exibe a caixa de diálogo Creating Project (Criando projeto) ao criar a aplicação. Depois que o Visual Studio concluir a geração da aplicação, será exibido um painel com o nome da aplicação.

Criar um ambiente do Elastic Beanstalk e implantar a aplicação

Esta seção descreve como criar um ambiente do Elastic Beanstalk para a aplicação e implantá-la nesse ambiente.

Como criar um ambiente e implantar a aplicação

1. No Visual Studio, selecione View (Visualizar) e, depois, Solution Explorer.

2. Em Solution Explorer, abra o menu de contexto (clique com o botão direito do mouse) da aplicação e selecione Publish to AWS Elastic Beanstalk (Publicar no ).

   

3. No assistente Publicar na AWS Elastic Beanstalk, insira as informações da sua conta.

   1. Em Account profile to use (Perfil de conta a ser usado), selecione a conta default (padrão) ou selecione o ícone Add another account (Adicionar outra conta) para inserir as informações da novas conta.

   2. Em Region (Região), selecione a região em que você deseja implantar a aplicação. Para obter informações sobre regiões da AWS disponíveis, consulte Endpoints e cotas do AWS Elastic Beanstalk no Referência geral da AWS. Se você selecionar uma região não compatível com o Elastic Beanstalk, a opção para implantar no Elastic Beanstalk não estará disponível.

   3. Selecione Create a new application environment (Criar um ambiente de aplicação) e Next (Próximo).

      

4. Na caixa de diálogo Application Environment (Ambiente de aplicação), insira os detalhes do novo ambiente de aplicação.

5. Na próxima caixa de diálogo de opções da AWS, defina as opções do Amazon EC2 e outras opções relacionadas à AWS para a aplicação implantada.

   1. Em Container type (Tipo de contêiner), selecione 64bit Amazon Linux 2 v<n.n.n> running .NET Core (Amazon Linux 2 v<n.n.n> de 64 bits executando o .NET Core).

      nota

      Recomendamos que você selecione a versão atual da plataforma do Linux. Essa versão contém as correções de erros e segurança mais recentes que estão incluídas na imagem de máquina da Amazon (AMI) mais recente.

   2. Em Instance Type (Tipo de instância), selecione t2.micro. (Escolher um tipo de microinstância minimizará o custo associado à execução da instância.)

   3. Para Par de chaves, selecione Criar novo par de chaves. Insira um nome para o novo par de chaves e selecione OK. (Neste exemplo, usamos myuseastkeypair.) Um par de chaves permite o acesso do desktop remoto em suas instâncias do Amazon EC2. Para obter mais informações sobre pares de chaves do Amazon EC2, consulte Usar credenciais no Guia do usuário da Amazon Elastic Compute Cloud.

   4. Para uma aplicação simples e de baixo tráfego, selecione Single instance environment (Ambiente de instância única). Para obter mais informações, consulte Tipos de ambiente.

   5. Selecione Próximo.

   

   Para obter mais informações sobre as opções da AWS que não são usadas neste exemplo, considere as seguintes páginas:

   • Em Use custom AMI (Usar AMI personalizada), consulte Usar uma imagem de máquina da Amazon (AMI) personalizada.

   • Se você não selecionar Single instance environment (Ambiente de instância única), será necessário escolher um Load balance type (Tipo de balanceamento de carga). Consulte Balanceador de carga do ambiente do Elastic Beanstalk para obter mais informações.

   • O Elastic Beanstalk usará a configuração padrão da Amazon VPC (Amazon Virtual Private Cloud) se você não escolheu Use non-default VPC (Usar VPC não padrão). Para obter mais informações, consulte Usar o Elastic Beanstalk com Amazon VPC.

   • Escolher a opção Enable Rolling Deployments (Habilitar implantações contínuas) divide uma implantação em lotes para evitar possíveis períodos de inatividade durante as implantações. Para obter mais informações, consulte Implantar aplicações em ambientes do Elastic Beanstalk.

   • Escolher a opção Relational Database Access (Acesso ao banco de dados relacional) conecta o ambiente do Elastic Beanstalk a um banco de dados do Amazon RDS criado anteriormente com grupos de segurança de banco de dados do Amazon RDS. Para obter mais informações, consulte Controlar o acesso com grupos de segurança no Guia do usuário do Amazon RDS.

6. Selecione Next (Próximo) na caixa de diálogo Permissions (Permissões).

7. Selecione Next (Próximo) na caixa de diálogo Applications Options (Opções de aplicações).

8. Revise as opções de implantação. Depois de verificar se as configurações estão corretas, selecione Deploy (Implantar).

A aplicação Web ASP.NET Core é exportada como um arquivo de implantação da Web. Esse arquivo é, então, carregado para o Amazon S3 e registrado como uma nova versão da aplicação com o Elastic Beanstalk. O recurso de implantação do Elastic Beanstalk monitora o ambiente existente até ele se tornar disponível com o código recém-implantado. O Status do ambiente será exibido na guia Env:<nome do ambiente>. Depois que o status for atualizado para Environment is healthy (O ambiente está íntegro), você poderá selecionar o endereço URL para executar a aplicação Web.

Encerrar um ambiente

Para evitar cobranças de recursos da AWS não utilizados, use o AWS Toolkit for Visual Studio para terminar um ambiente em execução.

nota

Você sempre pode iniciar um novo ambiente usando a mesma versão mais tarde.

Para encerrar um ambiente

1. Expanda o nó Elastic Beanstalk e o nó da aplicação. No AWS Explorer, abra o menu de contexto (clique com o botão direito do mouse) do ambiente de aplicação e selecione Terminate Environment (Terminar ambiente).

2. Quando solicitado, selecione Yes (Sim) para confirmar que você deseja encerrar o ambiente. São necessários algns minutos para o Elastic Beanstalk terminar os recursos da AWS em execução no ambiente.

O Status do ambiente na guia Env:<nome do ambiente> é alterado para Terminating (Encerrando) e, por fim, para Terminated (Encerrado).

nota

Quando você encerra o ambiente, o CNAME associado ao ambiente encerrado torna-se disponível para qualquer pessoa utilizar.