本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS Toolkit for Visual Studio -在 Elastic Beanstalk 上使用.net Core
<a name="dotnet-toolkit-linux"></a>

本主题说明如何使用 AWS Toolkit for Visual Studio执行以下任务：
+ 使用 Visual Studio 模板创建 ASP.NET Core Web 应用程序。
+ 创建 Elastic Beanstalk Amazon Linux 环境。
+ 将 ASP.NET Core Web 应用程序部署到新的 Amazon Linux 环境。

本主题还探讨了如何使用 AWS Toolkit for Visual Studio 来管理 Elastic Beanstalk 应用程序环境和监控应用程序的运行状况。

 AWS Toolkit for Visual Studio 是 Visual Studio IDE 的插件。使用该工具包，您在 Visual Studio 环境中工作时，可以在 Elastic Beanstalk 中部署和管理应用程序。

**Topics**
+ [先决条件](#dotnet-toolkit-linux-core-tutorial-prereqs)
+ [创建新的应用程序项目](#dotnet-toolkit-linux-core-tutorial-create-project)
+ [创建 Elastic Beanstalk 环境并部署应用程序](#dotnet-toolkit-linux-core-tutorial-create-env-and-deploy)
+ [终止环境](#dotnet-toolkit-linux-core-tutorial-terminate-env)
+ [管理 Elastic Beanstalk 应用程序环境](create_deploy_NET-linux.managing.md)
+ [监控应用程序运行状况](create_deploy_NET-linux.healthstatus.md)

## 先决条件
<a name="dotnet-toolkit-linux-core-tutorial-prereqs"></a>

在开始本教程之前，您需要安装 AWS Toolkit for Visual Studio。有关说明，请参阅[设置 AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html)。

如果您以前从未使用过该工具包，则安装该工具包后需要做的第一件事就是向该工具包注册您的 AWS 凭据。有关这一点的更多信息，请参阅[提供 AWS 凭证](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/credentials.html)。

## 创建新的应用程序项目
<a name="dotnet-toolkit-linux-core-tutorial-create-project"></a>

如果您在 Visual Studio 中没有 .NET Core 应用程序项目，则可以使用其中一个 Visual Studio 项目模板轻松创建一个项目。

**创建新的 ASP.NET Core Web 应用程序项目**

1. 在 Visual Studio 中，在 **File**（文件）菜单上选择 **New**（新建），然后选择 **Project**（项目）。

1. 在**创建新项目**对话框中，选择 **C\$1**，选择 **Linux**，然后选择**云**。

1. 从显示的项目模板列表中选择 **ASP.NET Core Web 应用程序**，然后选择**下一步**。
**注意**  
如果您在项目模板中没有看到 **ASP.NET Core Web Application**（ASP.NET Core Web 应用程序）列出，则可以在 Visual Studio 中安装它。  
滚动到模板列表的底部，然后选择位于模板列表下的**安装更多工具和功能**链接。
如果系统提示您允许 Visual Studio 应用程序对设备进行更改，请选择**是**。
选择**工作负载**选项卡，然后选择 **ASP.NET 和 Web 开发**。
选择**修改**按钮。**Visual Studio 安装程序**将安装项目模板。
安装程序完成后，退出面板以返回到 Visual Studio 中您之前离开的位置。

1. 在**配置新项目**对话框中，输入**项目名称**。**解决方案名称**默认为您的项目名称。接下来，选择**创建**。

1. 在**创建新的 ASP.NET Core Web 应用程序**对话框中，选择 **.NET Core**，然后选择 **ASP.NET Core 3.1**。从显示的应用程序类型列表中选择 **Web 应用程序**，然后选择**创建**按钮。

 Visual Studio 在创建应用程序时将显示 **Creating Project**（正在创建项目）对话框。当 Visual Studio 完成生成应用程序后，将显示一个包含您的应用程序名称的面板。

## 创建 Elastic Beanstalk 环境并部署应用程序
<a name="dotnet-toolkit-linux-core-tutorial-create-env-and-deploy"></a>

本节介绍如何为应用程序创建 Elastic Beanstalk 环境并将应用程序部署到该环境。

**创建新环境并部署应用程序**

1.  在 Visual Studio 中，依次选择 **View**（查看）和 **Solution Explorer**（解决方案浏览器）。

1. 在 **Solution Explorer（解决方案资源管理器）**中，打开应用程序的上下文（右键单击）菜单，然后选择 **Publish to AWS Elastic Beanstalk（发布到 Amazon Elastic Beanstalk）**。

1. 在 **Publish to AWS Elastic Beanstalk**（发布到亚马逊云科技）向导中，输入您的账户信息。

   1. 对于**要使用的账户配置文件**，请选择**默认**账户或选择**添加其他账户**图标以输入新账户信息。

   1. 对于**区域**，选择要在其中部署应用程序的区域。有关可用 AWS 区域的信息，请参阅中的[AWS Elastic Beanstalk 终端节点和配额*AWS 一般参考*](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html)。如果您选择了一个 Elastic Beanstalk 不支持的区域，则部署到 Elastic Beanstalk 的选项不可用。

   1. 选择**创建新的应用程序环境**，然后选择**下一步**。

1. 在**应用程序环境**对话框中，输入新应用程序环境的详细信息。

1. 在下一个**AWS**选项对话框中，为您部署的应用程序设置 Amazon EC2 选项和其他 AWS 相关选项。

   1. 对于**容器类型**，请选择***<n.n.n>*运行.NET Core 的 64 位 Amazon Linux 2 v**。
**注意**  
我们建议您选择 Linux 的当前平台版本。此版本包含最新 Amazon Machine Image (AMI) 中包含的最新安全和错误修复。

   1. 对于**实例类型**，选择 **t2.micro**。（选择微型实例类型将最大限度地降低与运行实例相关的成本。）

   1. 对于 **Key pair**（密钥对），选择 **Create new key pair**（创建新密钥对）。输入新密钥对的名称，然后选择**确定**。（在此示例中，我们使用 **myuseastkeypair**）。key pair 允许远程桌面访问您的 Ama EC2 zon 实例。有关亚马逊 EC2 密钥对的更多信息，请参阅*亚马逊弹性计算云用户指南*中的[使用证书](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-credentials.html)。

   1. 对于简单的低流量应用程序，请选择**单一实例环境**。有关更多信息，请参阅 [环境类型](using-features-managing-env-types.md)

   1. 选择 **Next**（下一步）。

    有关本示例中未使用的 AWS 选项的更多信息，请考虑以下页面：
   + 有关**使用自定义 AMI**，请参阅[在 Elastic Beanstalk 环境中使用自定义亚马逊机器映像（AMI）](using-features.customenv.md)。
   + 如果您未选择**单一实例环境**，则需要选择**负载均衡类型**。请参阅[Elastic Beanstalk 环境的负载均衡器](using-features.managing.elb.md)了解更多信息。
   + 如果您没有选择 **Use non-default VPC**（使用非默认 VPC），Elastic Beanstalk 将使用默认 [Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/)（Amazon Virtual Private Cloud）配置。有关更多信息，请参阅 [将 Elastic Beanstalk 和 Amazon VPC 结合使用](vpc.md)。
   + 通过选择**启用滚动部署**选项，可以将部署拆分为多个批处理，以避免部署期间可能停机。有关更多信息，请参阅 [将应用程序部署到 Elastic Beanstalk 环境](using-features.deploy-existing-version.md)。
   + 通过选择 **Relational Database Access**（关系数据库访问）选项，可以将 Elastic Beanstalk 环境连接到以前创建的具有 *Amazon RDS 数据库安全组*的 Amazon RDS 数据库。有关更多信息，请参阅 *Amazon RDS 用户指南*中的[使用安全组控制访问权限](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.RDSSecurityGroups.html)。

1. 在**权限**对话框中选择**下一步**。

1. 在**应用程序选项**对话框中选择**下一步**。

1. 查看您的部署选项。验证设置是否正确后，选择**部署**。

您的 ASP.NET Core Web 应用程序将导出为 Web 部署文件。此文件会上传到 Amazon S3，并通过 Elastic Beanstalk 注册为一个新的应用程序版本。Elastic Beanstalk 部署功能会监控您的现有环境，直到该环境可用且具有最新部署的代码。“环境:<环境名称>”选项卡上将显示环境的**状态**。状态更新为**环境运行状况正常**后，您可以选择要启动 Web 应用程序的 URL 地址。

## 终止环境
<a name="dotnet-toolkit-linux-core-tutorial-terminate-env"></a>

 为了避免因未使用的 AWS 资源而产生费用，您可以使用 AWS Toolkit for Visual Studio 来终止正在运行的环境。

**注意**  
稍后，您始终都可以使用相同的版本启动新的环境。

**终止环境**

1. 展开 Elastic Beanstalk 节点和应用程序节点。在 **AWS Explorer** 中，打开应用程序环境的上下文（右键单击）菜单，然后选择 **Terminate Environment（终止环境）**。

1. 当系统提示时，选择**是**以确认要终止该环境。Elastic Beanstalk 需要几分钟才能 AWS 终止在环境中运行的资源。

“环境:<环境变量>”选项卡上环境的**状态**将更改为**正在终止**，并最终更改为**已终止**。

**注意**  
 终止环境时，与已终止环境相关联的别名记录可供任何人使用。