本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# QuickStart: 在 Windows 应用程序上部署.NET 核心到 Elastic Beanstalk
本 QuickStart 教程将引导你完成在 Windows 应用程序上创建.NET Core 并将其部署到 Amazon Elastic Beanstalk 环境的过程。
**不用于生产用途**
示例仅用于演示。请勿在生产环境中使用示例应用程序。
**Topics**
+ [你的 Amazon 账户](#dotnet-quickstart-aws-account)
+ [先决条件](#dotnet-quickstart-prereq)
+ [步骤 1：创建 .NET Core on Windows 应用程序](#dotnet-quickstart-create-app)
+ [步骤 2：在本地运行应用程序](#dotnet-quickstart-run-local)
+ [步骤 3：使用 EB CLI 部署 .NET Core on Windows 应用程序](#dotnet-quickstart-deploy)
+ [步骤 4：在 Elastic Beanstalk 上运行应用程序](#dotnet-quickstart-run-eb-ap)
+ [第 5 步：清理](#go-tutorial-cleanup)
+ [Amazon 您的应用程序的资源](#dotnet-quickstart-eb-resources)
+ [后续步骤](#dotnet-quickstart-next-steps)
+ [使用 Elastic Beanstalk 控制台进行部署](#dotnet-quickstart-console)
## 你的 Amazon 账户
如果您还不是 Amazon 客户，则需要创建一个 Amazon 帐户。注册后，您就可以访问 Elastic Beanstalk Amazon 和其他所需的服务。
如果您已经有一个 Amazon 帐户，则可以继续前进[先决条件](#dotnet-quickstart-prereq)。
### 创建一个 Amazon 账户
#### 注册获取 Amazon Web Services 账户
如果您没有 Amazon Web Services 账户，请完成以下步骤来创建一个。
**报名参加 Amazon Web Services 账户**
1. 打开[https://portal.aws.amazon.com/billing/注册。](https://portal.amazonaws.cn/billing/signup)
1. 按照屏幕上的说明操作。
在注册时，将接到电话或收到短信，要求使用电话键盘输入一个验证码。
当您注册时 Amazon Web Services 账户，就会创建*Amazon Web Services 账户根用户*一个。根用户有权访问该账户中的所有 Amazon Web Services 服务 和资源。作为最佳安全实践，请为用户分配管理访问权限，并且只使用根用户来执行[需要根用户访问权限的任务](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。
Amazon 注册过程完成后会向您发送一封确认电子邮件。您可以随时前往 [https://aws.amazon.com/](https://www.amazonaws.cn/)并选择 “**我的账户”，查看您当前的账户活动并管理您的账户**。
#### 保护 IAM 用户
注册后 Amazon Web Services 账户，开启多重身份验证 (MFA)，保护您的管理用户。有关说明，请参阅《IAM 用户指南》**中的 [为 IAM 用户启用虚拟 MFA 设备（控制台）](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-iam-user)。
要允许其他用户访问您的 Amazon Web Services 账户 资源，请创建 IAM 用户。为了保护您的 IAM 用户，请启用 MFA 并仅向 IAM 用户授予执行任务所需的权限。
有关创建和保护 IAM 用户的更多信息，请参阅《IAM 用户指南》中的以下主题：**
+ [在你的 IAM 用户中创建 Amazon Web Services 账户](https://docs.amazonaws.cn//IAM/latest/UserGuide/id_users_create.html)
+ [适用于 Amazon 资源的访问权限管理](https://docs.amazonaws.cn/IAM/latest/UserGuide/access.html)
+ [基于 IAM 身份的策略示例](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_examples.html)
## 先决条件
为了遵循本指南中的步骤，您需要命令行终端或 Shell，以便运行命令。命令显示在列表中，前面带有提示符（>）和当前目录的名称（如果适用）。
```
C:\eb-project> this is a command
this is output
```
### EB CLI
本教程使用 Elastic Beanstalk 命令行界面 (EB CLI)。有关安装和配置 EB CLI 的详细信息，请参阅 [使用设置脚本安装 EB CLI（推荐）](eb-cli3.md#eb-cli3-install) 和 [配置 EB CLI](eb-cli3-configuration.md)。
### .NET Core on Windows
如果您的本地计算机上尚未安装 .NET SDK，则可以按照 [.NET 文档](https://learn.microsoft.com/en-us/dotnet/)网站上的[下载 .NET](https://dotnet.microsoft.com/en-us/download) 链接进行安装。
通过运行以下命令来验证您的 .NET SDK 安装。
```
C:\> dotnet --info
```
## 步骤 1：创建 .NET Core on Windows 应用程序
创建项目目录。
```
C:\> mkdir eb-dotnetcore
C:\> cd eb-dotnetcore
```
接下来，通过运行以下命令创建一个示例 Hello RESTful World Web 服务应用程序。
```
C:\eb-dotnetcore> dotnet new web --name HelloElasticBeanstalk
C:\eb-dotnetcore> cd HelloElasticBeanstalk
```
## 步骤 2：在本地运行应用程序
运行以下命令以在本地运行您的应用程序。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet run
```
输出应类似于以下文本。
```
info: Microsoft.Hosting.Lifetime[14]
Now listening on: https://localhost:7222
info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://localhost:5228
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
Content root path: C:\Users\Administrator\eb-dotnetcore\HelloElasticBeanstalk
```
**注意**
在本地运行应用程序时，`dotnet` 命令会随机选择一个端口。在此示例中，端口为 5228。当您将应用程序部署到 Elastic Beanstalk 环境时，该应用程序将在端口 5000 上运行。
在您的网络浏览器中输入 URL 地址 `http://localhost:port`。对于这个具体的示例，命令是 `http://localhost:5228`。Web 浏览器应显示“Hello World\$1”。
## 步骤 3：使用 EB CLI 部署 .NET Core on Windows 应用程序
运行以下命令为此应用程序创建 Elastic Beanstalk 环境。
**创建环境并部署 .NET Core on Windows 应用程序**
1. 在 `HelloElasticBeanstalk` 目录中运行以下命令来发布和压缩应用程序。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet publish -o site
C:\eb-dotnetcore\HelloElasticBeasntalk> cd site
C:\eb-dotnetcore\HelloElasticBeasntalk\site> Compress-Archive -Path * -DestinationPath ../site.zip
C:\eb-dotnetcore\HelloElasticBeasntalk\site> cd ..
```
1. 在 `HelloElasticBeanstalk` 中创建一个名为 `aws-windows-deployment-manifest.json` 包含以下内容的新文件：
```
{
"manifestVersion": 1,
"deployments": {
"aspNetCoreWeb": [
{
"name": "test-dotnet-core",
"parameters": {
"appBundle": "site.zip",
"iisPath": "/",
"iisWebSite": "Default Web Site"
}
}
]
}
}
```
1. 使用 **eb init** 命令，初始化 EB CLI 存储库。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> eb init -p iis dotnet-windows-server-tutorial --region us-east-2
```
此命令将创建名为 `dotnet-windows-server-tutorial` 的应用程序，并配置本地存储库，以创建具有最新 Windows Server 平台版本的环境。
1. 创建环境并使用 **eb create** 将应用程序部署到此环境中。Elastic Beanstalk 会自动为您的应用程序生成一个 zip 文件，并在端口 5000 上启动该文件。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> eb create dotnet-windows-server-env
```
Elastic Beanstalk 大约需要五分钟来创建您的环境。
## 步骤 4：在 Elastic Beanstalk 上运行应用程序
当创建环境的过程完成后，使用 **eb open** 打开您的网站。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> eb open
```
恭喜您！您已使用 Elastic Beanstalk 部署了 .NET Core on Windows 应用程序！这将使用为应用程序创建的域名打开一个浏览器窗口。
## 第 5 步：清理
应用程序使用完毕时，您可以终止您的环境。Elastic Beanstalk Amazon 会终止与您的环境关联的所有资源。
要使用 EB CLI 终止您的 Elastic Beanstalk 环境，请运行以下命令。
```
C:\eb-dotnetcore\HelloElasticBeasntalk> eb terminate
```
## Amazon 您的应用程序的资源
您刚刚创建了一个单实例应用程序。它可用作带有单个 EC2 实例的简单示例应用程序，因此不需要负载平衡或自动扩缩。对于单实例应用程序，Elastic Beanstalk 会创建以下资源： Amazon
+ **EC2 实例** - 配置来在您选择的平台上运行 Web 应用程序的 Amazon EC2 虚拟机。
各平台运行一组不同的软件、配置文件和脚本以支持特定的语言版本、框架、Web 容器或其组合。大多数平台使用 Apache 或 nginx 作为在 Web 应用程序前处理 Web 流量的反向代理，向其转发请求、提供静态资产以及生成访问和错误日志。
+ **实例安全组** - 配置为允许端口 80 上的传入流量的 Amazon EC2 安全组。通过此资源，HTTP 流量可以从负载均衡器到达运行您的 Web 应用程序的 EC2 实例。默认情况下，其他端口不允许流量进入。
+ **Amazon S3 存储桶** – 使用 Elastic Beanstalk 时创建的源代码、日志和其他构件的存储位置。
+ **Amazon CloudWatch CloudWatch 警**报 — 两个警报，用于监控您环境中实例的负载，并在负载过高或过低时触发。警报触发后，您的 Auto Scaling 组会扩展或收缩以进行响应。
+ **Amazon CloudFormation 堆栈** — Elastic Amazon CloudFormation Beanstalk 用于在您的环境中启动资源并传播配置更改。这些资源在您可通过 [Amazon CloudFormation 控制台](https://console.amazonaws.cn/cloudformation)查看的模板中定义。
+ **域名**-以表单形式路由到您的 Web 应用程序的域名**subdomain*。 *region*.eb.amazonaws.com.cn。*
Elastic Beanstalk 管理所有这些资源。当您终止环境时，Elastic Beanstalk 会终止其包含的所有资源。
## 后续步骤
有了运行应用程序的环境以后，您随时可以部署新的应用程序版本或不同的应用程序。部署新应用程序版本非常快，因为不需要配置或重新启动 EC2 实例。您还可以使用 Elastic Beanstalk 控制台探索新环境。有关详细步骤，请参阅本指南*入门*一章中的[探索您的环境](GettingStarted.md#GettingStarted.Explore)。
**尝试更多教程**
如果您想尝试包含不同示例应用程序的其他教程，请参阅 [QuickStart 适用于ASP.NET](aspnet-quickstart.md)。
部署一到两个示例应用程序并准备好开始在本地开发和运行 .NET Core on Windows 应用程序后，请参阅 [设置 .NET 开发环境](dotnet-devenv.md)
## 使用 Elastic Beanstalk 控制台进行部署
您还可以使用 Elastic Beanstalk 控制台来启动示例应用程序。有关详细步骤，请参阅本指南*入门*一章中的[创建示例应用程序](GettingStarted.md#GettingStarted.CreateApp)。