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

# O AWS Toolkit for Visual Studio - Trabalhando com o.NET Core no Elastic Beanstalk
<a name="dotnet-toolkit-linux"></a>

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 seus ambientes de aplicativos do Elastic Beanstalk e monitorar a integridade do seu aplicativo.

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

**Topics**
+ [Pré-requisitos](#dotnet-toolkit-linux-core-tutorial-prereqs)
+ [Criar um projeto de aplicação](#dotnet-toolkit-linux-core-tutorial-create-project)
+ [Criar um ambiente do Elastic Beanstalk e implantar a aplicação](#dotnet-toolkit-linux-core-tutorial-create-env-and-deploy)
+ [Encerrar um ambiente](#dotnet-toolkit-linux-core-tutorial-terminate-env)
+ [Gerenciar os ambientes de aplicações do Elastic Beanstalk](create_deploy_NET-linux.managing.md)
+ [Monitorar a integridade do aplicativo](create_deploy_NET-linux.healthstatus.md)

## Pré-requisitos
<a name="dotnet-toolkit-linux-core-tutorial-prereqs"></a>

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](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html).

Se você nunca usou o kit de ferramentas antes, a primeira coisa que precisará fazer depois de instalar o kit de ferramentas é registrar suas AWS credenciais no kit de ferramentas. Para obter mais informações sobre isso, consulte [Fornecer credenciais da AWS](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/credentials.html).

## Criar um projeto de aplicação
<a name="dotnet-toolkit-linux-core-tutorial-create-project"></a>

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)**.

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

1. 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.  
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. 
Se você for solicitado a permitir que a aplicação do Visual Studio, faça alterações no dispositivo, selecione **Yes (Sim)**.
Selecione a guia **Workloads (Cargas de trabalho)** e a opção **ASP.NET and web development (ASP.NET e desenvolvimento Web). ** 
Selecione o botão **Modify (Modificar)**. O **Visual Studio Installer (Instalador do Visual Studio)** instala o modelo de projeto. 
Depois que o instalador for concluído, saia do painel para retornar ao ponto em que você parou no Visual Studio.

1. 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)**.

1. 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
<a name="dotnet-toolkit-linux-core-tutorial-create-env-and-deploy"></a>

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

1. 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 ).**

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

   1. Em **Region (Região)**, selecione a região em que você deseja implantar a aplicação. Para obter informações sobre AWS regiões disponíveis, consulte [AWS Elastic Beanstalk Endpoints and Quotas](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) 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.

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

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

1. Na próxima caixa de diálogo de **AWS**opções, defina EC2 as opções da Amazon e outras opções AWS relacionadas para seu aplicativo implantado.

   1. Para o **tipo de contêiner**, selecione **Amazon Linux 2 v de 64 bits {{<n.n.n>}} 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. 

   1. 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.)

   1. 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 key pair permite o acesso por desktop remoto às suas instâncias da Amazon EC2 . Para obter mais informações sobre os pares de EC2 chaves da Amazon, consulte [Usando credenciais no Guia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-credentials.html) do *usuário do Amazon Elastic Compute Cloud*.

   1. 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](using-features-managing-env-types.md).

   1. Escolha **Próximo**.

    Para obter mais informações sobre as AWS opções 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 Amazon personalizada (AMI) no ambiente Elastic Beanstalk](using-features.customenv.md).
   + 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](using-features.managing.elb.md) para obter mais informações. 
   + O Elastic Beanstalk usará a configuração padrão da [Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/) (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](vpc.md).
   + 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](using-features.deploy-existing-version.md).
   + 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](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.RDSSecurityGroups.html) no *Guia do usuário do Amazon RDS*.

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

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

1. 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
<a name="dotnet-toolkit-linux-core-tutorial-terminate-env"></a>

 Para evitar cobranças por AWS recursos não utilizados, você pode usar o AWS Toolkit for Visual Studio para encerrar um ambiente em execução.

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

**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).**

1. Quando solicitado, selecione **Yes (Sim)** para confirmar que você deseja encerrar o ambiente. São necessários alguns minutos para que o Elastic Beanstalk AWS encerre os recursos 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.