

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
<a name="dotnet-toolkit"></a>

O Visual Studio fornece modelos para diferentes linguagens de programação e tipos de aplicativos. Você pode começar com qualquer um desses modelos. O AWS Toolkit for Visual Studio também fornece três modelos de projeto que inicializam o desenvolvimento do seu aplicativo AWS : Console Project AWS , Web Project AWS e Empty Project. Para este exemplo, você vai criar um novo aplicativo web ASP.NET.

**Como criar um novo projeto de aplicativo web ASP.NET**

1. No Visual Studio, no menu **Arquivo**, clique em **Novo** e em **Projeto**.

1. Na caixa de diálogo **Novo projeto**, clique em **Modelos instalados**, clique em **Visual C\#** e, em seguida, clique em **Web**. Clique em **Aplicativo web ASP.NET vazio**, digite um nome de projeto e, em seguida, clique em **OK**. 

**Para executar um projeto**

Execute um destes procedimentos:

1. Pressione **F5**.

1. Selecione **Iniciar depuração** no menu **Depurar**.

## Testar localmente
<a name="create_deploy_NET.sdlc.testlocal"></a>

O Visual Studio facilita testar seu aplicativo localmente. Para testar ou executar aplicativos web em ASP.NET, você precisa de um servidor web. O Visual Studio oferece várias opções, como o Internet Information Services (IIS), IIS Express ou o Visual Studio Development Server. Para saber mais sobre cada uma dessas opções e decidir qual é a melhor para você, consulte [Servidores Web no Visual Studio para projetos Web ASP.NET ](http://msdn.microsoft.com/en-us/library/58wxa9w5.aspx).

## Criar um ambiente do Elastic Beanstalk
<a name="create_deploy_NET.sdlc.deploy"></a>

Depois de testar a aplicação, você estará pronto para implantá-la no Elastic Beanstalk.

**nota**  
O [Arquivo de configuração](ebextensions.md) precisa fazer parte do projeto para ser incluído no arquivo. Se preferir, em vez de incluir os arquivos de configuração no projeto, você pode usar o Visual Studio para implantar todos os arquivos na pasta do projeto. Em **Solution Explorer**, clique com o botão direito do mouse no nome do projeto e, em seguida, clique em **Propriedades**. Clique na guia **Package/Publish Web**. Na seção **Items to deploy**, selecione **All Files in the Project Folder** na lista suspensa.

**Para implantar seu aplicativo no Elastic Beanstalk AWS usando o kit de ferramentas do Visual Studio**

1. No **Solution Explorer**, clique com o botão direito do mouse em seu aplicativo e selecione **Publicar em AWS**.

1. No assistente **Publicar na AWS**, insira as informações da sua conta.

   1. Para **Conta da AWS a utilizar para implantação**, selecione sua conta ou selecione **Outra** para inserir as informações da nova conta. 

   1. Para **Região**, selecione a região em que você deseja implantar o aplicativo. Para obter informações sobre AWS regiões disponíveis, consulte [AWS Elastic Beanstalk Endpoints e cotas](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 se tornará indisponível.

   1.  Clique em **Implantar novo aplicativo com modelo** e selecione **Elastic Beanstalk**. Em seguida, clique em **Próximo**.  
![Publicar no AWS assistente 1](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-create-newapp-template.png)

1. Na página **Aplicativo**, insira os detalhes de seu aplicativo.

   1. Em **Nome**, digite o nome do aplicativo.

   1. Em **Descrição**, digite uma descrição do aplicativo. Esta etapa é opcional.

   1. O rótulo da versão do aplicativo é exibido automaticamente em **Deployment version label (Rótulo da versão de implantação)**

   1. Selecione **Implantar aplicativo incrementalmente** para implantar somente os arquivos alterados. Uma implantação incremental é mais rápida porque você está atualizando somente os arquivos alterados em vez de todos os arquivos. Se você escolher essa opção, uma versão do aplicativo será definida a partir do ID de confirmação do Git. Se você optar por não implantar seu aplicativo de forma incremental, poderá atualizar o rótulo da versão na caixa **Rótulo da versão de implantação**.   
![Assistente Publish to beanstalk 2](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk1.png)

   1. Clique em **Next**.

1. Na página **Ambiente**, descreva os detalhes de seu ambiente.

   1. Selecione **Criar um novo ambiente para este aplicativo**.

   1. Em **Nome**, digite um nome para o ambiente.

   1. Em **Descrição**, caracterize seu ambiente. Esta etapa é opcional.

   1. Em **Tipo**, selecione o tipo de ambiente que deseja.

      Você pode selecionar um ambiente **Carga balanceada, escalabilidade automática** ou **Única instância**. Para obter mais informações, consulte [Tipos de ambiente](using-features-managing-env-types.md).

       
**nota**  
Para ambientes de uma única instância, as configurações de balanceamento de carga, autoescalabilidade e URL de verificação de integridade não se aplicam

   1. O URL do ambiente é exibido automaticamente em **URL do ambiente** assim que você move o cursor para essa caixa.

   1. Clique em **Verificar disponibilidade** para garantir que o URL do ambiente esteja disponível.  
![Assistente Publish to beanstalk 3](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk2.png)

   1. Clique em **Next**.

1. Na página **Opções da AWS **, configure as opções adicionais e as informações de segurança de sua implantação. 

   1.  Em **Tipo de contêiner**, selecione **Windows Server 2012 de 64 bits executando IIS 8** ou **Windows Server 2008 de 64 bits executando IIS 7.5**.

   1. Para **Tipo de instância**, selecione **Micro**. 

   1. Para **Par de chaves**, selecione **Criar novo par de chaves**. Digite um nome para o novo par de chaves: neste exemplo, usamos **myuswestkeypair** e, depois, clique em **OK**. 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. Selecione um perfil da instância.

      Se você não tiver um perfil da instância, selecione **Criar um perfil da instância padrão**. Para obter informações sobre como usar perfis de instância com o Elastic Beanstalk, consulte [Gerenciar perfis de instância do Elastic Beanstalk](iam-instanceprofile.md).

   1. Se você tiver uma VPC personalizada que gostaria de usar com seu ambiente, clique em **Iniciar no VPC**. Você pode configurar as informações da VPC na próxima página. Para obter mais informações sobre a Amazon VPC, consulte [Amazon Virtual Private Cloud (Amazon VPC)](https://aws.amazon.com/vpc/). Para obter uma lista de tipos de contêiner não legados compatíveis, consulte [Por que algumas versões de plataforma são marcadas como legadas?](using-features.migration.md#using-features.migration.why)  
![Assistente Publish to beanstalk 4](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk3b_iam.png)

   1.  Clique em **Next**. 

1. Se você optou por iniciar seu ambiente dentro de uma VPC, a **Opções da VPC** será exibida; caso contrário, a página **Opções adicionais** será exibida. Aqui você configurará as opções de sua VPC.  
![Opções de VPC para ambiente escalável e com balanceamento de carga](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk3b_vpc.png)  
![Opções da VPC para ambiente de única instância](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk3b_vpc-single.png)

   1. Selecione o ID da VPC em que gostaria de iniciar seu ambiente. 

   1. Para um ambiente escalável e com balanceamento de carga, selecione **private (privado)** em **ELB Scheme (Esquema ELB)** se não quiser que o Elastic Load Balancer fique disponível na Internet.

      Para um ambiente de única instância, essa opção não é aplicável porque o ambiente não tem um load balancer. Para obter mais informações, consulte [Tipos de ambiente](using-features-managing-env-types.md).

   1. Para um ambiente escalável e com balanceamento de carga, selecione as sub-redes para o balanceador de carga elástico e as instâncias. EC2 Se você criou sub-redes públicas e privadas, certifique-se de que o balanceador de carga elástico e as EC2 instâncias estejam associados à sub-rede correta. Por padrão, a Amazon VPC cria uma sub-rede pública padrão usando 10.0.0.0/24 e uma sub-rede privada usando 10.0.1.0/24. Você pode visualizar suas sub-redes existentes no console da Amazon VPC em. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

      Para um ambiente de única instância, a VPC precisa apenas de uma sub-rede pública para a instância. A seleção de uma sub-rede para o load balancer não é aplicável porque o ambiente não tem um load balancer. Para obter mais informações, consulte [Tipos de ambiente](using-features-managing-env-types.md).

   1. Para um ambiente escalável e com balanceamento de carga, selecione o grupo de segurança criado para as instâncias, se aplicável.

      Para um ambiente de única instância, você não precisa de um dispositivo NAT. Selecione o security group padrão. O Elastic Beanstalk atribui um endereço IP elástico à instância, permitindo que ela acesse a Internet.

   1. Clique em **Next**.

1. Na página **Opções do aplicativo**, configure as opções de seu aplicativo. 

   1. Para o framework de destino, selecione **.NET Framework 4.0**. 

   1. O Elastic Load Balancing usa uma verificação de saúde para determinar se as EC2 instâncias da Amazon que executam seu aplicativo estão íntegras. A verificação de integridade determina um status de integridade da instância sondando um URL especificado em um intervalo definido. Você pode substituir o URL padrão para corresponder a um recurso existente no seu aplicativo (por exemplo, `/myapp/index.aspx`), inserindo-o na caixa **URL da verificação de integridade do aplicativo**. Para obter mais informações sobre como configurar verificações de integridade do aplicativo, consulte [Verificação de saúde](environments-cfg-clb.md#using-features.managing.elb.healthchecks). 

   1. Digite um endereço de e-mail para receber notificações do Amazon Simple Notification Service (Amazon SNS) sobre eventos importantes que afetam o seu aplicativo.

   1. A seção **Ambiente do aplicativo** permite que você especifique variáveis de ambiente nas EC2 instâncias da Amazon que estão executando seu aplicativo. Essa configuração proporciona maior portabilidade, pois acaba com a necessidade de recompilar o código-fonte quando você move entre ambientes.

   1. Selecione a opção de credenciais do aplicativo que deseja usar para implantar seu aplicativo.  
![Assistente Publish to beanstalk 6](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk3a.png)

   1. Clique em **Next**.

1. Se você já tiver configurado um banco de dados do Amazon RDS, a página **Security group do banco de dados do Amazon RDS** será exibida. Se você deseja conectar seu ambiente do Elastic Beanstalk com sua instância de banco de dados do Amazon RDS, selecione um ou mais security groups. Caso contrário, vá para a próxima etapa. Quando estiver pronto, clique em **Próximo**.  
![Assistente Publish to beanstalk 7](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk6b.png)

1.  Revise as opções de implantação. Se tudo estiver como você deseja, clique em **Implantar**.   
![Assistente Publish to beanstalk 8](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-publish-beanstalk4.png)

   Seu projeto ASP.NET atualizado será exportado como um arquivo de implantação da web, enviado para o Amazon S3 e registrado como uma nova versão do aplicativo no Elastic Beanstalk. O recurso de implantação do Elastic Beanstalk irá monitorar seu ambiente até ele se tornar disponível com o código recém-implantado. Na guia env:<nome do ambiente>, você verá o status do seu ambiente.   
![Status do ambiente](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-env-status.png)

## Encerrar um ambiente
<a name="create_deploy_NET.terminating"></a>

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

**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**. Clique com o botão direito do mouse no ambiente de seu aplicativo e selecione **Encerrar ambiente**.

1. Quando solicitado, clique em **Sim** para confirmar que você deseja encerrar o ambiente. O Elastic Beanstalk levará alguns minutos para AWS encerrar os recursos em execução no ambiente.  
![Caixa de diálogo de encerramento do ambiente do Elastic Beanstalk](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/aeb-vs-terminate-confirm.png)
**nota**  
Quando você encerra o ambiente, o CNAME associado ao ambiente encerrado torna-se disponível para qualquer pessoa utilizar. 