本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 部署到 Amazon EC2 Container Service
**重要**
新的**发布到 AWS** 功能旨在简化将 .NET 应用程序发布到 AWS 的方式。在您选择**将容器发布到 AWS** 后，系统可能会询问您是否要切换到此发布体验。有关更多信息，请参阅 [在 Visual Studio 中使用“发布到 AWS”](publish-experience.md)。
Amazon Elastic Container Service 是一种高度可扩展、高性能的容器管理服务，它支持 Docker 容器并可让您在 Amazon EC2 实例的托管集群上轻松运行应用程序。
要在 Amazon Elastic Container Service 上部署应用程序，您开发应用程序组件时必须要使其可以在 Docker 容器中运行。Docker 容器是一个软件开发的标准化单位，包含您的软件应用程序需要运行的一切：代码、运行时、系统工具、系统库等。
Toolkit for Visual Studio 提供了一个向导，可简化通过 Amazon ECS 进行的应用程序发布。此向导将在以下部分中介绍。
有关 Amazon ECS 的更多信息，请参阅 [Elastic Container Service 文档](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html)。它概述了 [Docker 的基础知识](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/docker-basics.html)和[集群创建](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create_cluster.html)。
**Topics**
+ [指定 AWS 凭证](deployment-ecs-specify-credentials.md)
+ [部署 ASP.NET Core 2.0 应用程序（Fargate）（旧版）](deployment-ecs-aspnetcore-fargate.md)
+ [部署 ASP.NET 内核 2.0 应用程序 (EC2)](deployment-ecs-aspnetcore-ec2.md)
# 为您的 ASP.NET 酷睿 2 应用程序指定 AWS 凭据
当您将应用程序部署到 Docker 容器时，有两种类型的凭证在发挥作用：部署凭证和实例凭证。
发布容器到向 AWS 导使用部署凭证在 Amazon ECS 中创建环境。这包括任务、服务、IAM 角色、Docker 容器存储库等，如果您选择的话，还包括负载均衡器。
实例（包括您的应用程序）使用实例证书来访问不同的 AWS 服务。例如，如果您的 ASP.NET Core 2.0 应用程序读取和写入到 Amazon S3 对象，则该应用程序需要适当的权限。您可以根据环境使用不同的方法提供不同凭证。例如，您的 ASP.NET 内核e 2 应用程序可能面向*开发*和*生产*环境。您可以使用本地 Docker 实例和凭证进行开发，而在生产中使用定义的角色。
## 指定部署凭证
您在 “ AWS 将**容器发布到 AWS” 向**导中指定的 AWS 账户就是该向导用于部署到 Amazon ECS 的账户。账户资料必须具有访问亚马逊弹性计算云、亚马逊弹性容器服务和 AWS Identity and Access Management。
如果您注意到下拉列表中缺少某些选项，可能是因为您缺乏权限。例如，如果您为应用程序创建了一个集群但在**将容器发布到 AWS** 向导的集群页面中没有看到它。如果出现这种情况，请添加所缺的权限并重试该向导。
## 指定开发实例凭证
对于非生产环境，您可以在 appsettings..json 文件中配置凭证。例如，要在 Visual Studio 2017 的 appsettings.Development.json 文件中配置凭证，请执行以下操作：
1. 添加 AWSSDK .Extensions。 NETCore.将 NuGet 软件包安装到您的项目中。
1. 将 AWS 设置添加到 appSettings.developmen 以下配置将设置 `Profile` 和 `Region`。
```
{
"AWS": {
"Profile": "local-test-profile",
"Region": "us-west-2"
}
}
```
## 指定生产实例凭证
对于生产实例，建议使用 IAM 角色来控制应用程序（和服务）可以访问的内容。例如，要在 AWS 管理控制台中将 Amazon ECS 的 IAM 角色配置为具有对 Amazon Simple Storage Service 和 Amazon DynamoDB 的权限的服务主体，请执行以下操作：
1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。
1. 在 IAM 控制台的导航窗格中，选择角色，然后选择创建角色。
1. 选择 **AWS 服务**角色类型，然后选择 **EC2 Container Service**。
1. 选择 **EC2 Container Service Task (EC2 Container Service 任务)** 使用案例。用例由服务定义以包含服务要求的信任策略。然后选择**下一步：权限**。
1. 选择 **AmazonS3 FullAccess** 和**AmazonDynamoDBFull访问**权限策略。选中每个策略旁边的复选框，然后选择 **Next: Review (下一步: 审核)**。
1. 对于**Role name (角色名称)**，键入有助于识别此角色的作用的角色名称或角色名称后缀。角色名称在您的 AWS 账户内必须是唯一的。它们不按大小写区分。例如，您无法同时创建名为 `PRODROLE` 和 `prodrole` 的角色。由于多个单位可能引用该角色，角色创建完毕后无法编辑角色名称。
1. (可选) 对于 **Role description**，键入新角色的描述。
1. 检查角色，然后选择**创建角色**。
您可以使用此角色作为**将容器发布到 AWS** 向导中 **ECS 任务定义**页面上的**任务角色**。
有关更多信息，请参阅[使用基于服务的角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)。
# 将 ASP.NET Core 2.0 应用程序部署到 Amazon ECS（Fargate）（旧版）
**重要**
本文档涉及旧版服务和功能。有关更新的指南和内容，请参阅 [AWS .NET deployment tool](https://aws.github.io/aws-dotnet-deploy/) 指南和更新的[部署到 AWS](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/deployment-chapt.html) 目录。
本部分介绍如何借助**将容器发布到 AWS** 向导（作为 Toolkit for Visual Studio 的一部分提供）来使用 Fargate 启动类型通过 Amazon ECS 部署针对 Linux 的容器化 ASP.NET Core 2.0 应用程序。由于 Web 应用程序要持续运行，因此将作为一项服务部署。
## 在您发布容器之前
在使用**将容器发布到 AWS** 向导部署 ASP.NET Core 2.0 应用程序之前，请执行以下操作：
+ [指定 AWS 凭证](deployment-ecs-specify-credentials.md)并[设置以使用 Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/get-set-up-for-amazon-ecs.html)。
+ [安装 Docker](https://docs.docker.com/engine/installation)。有几个不同的安装选项，包括 [Docker for Windows](https://docs.docker.com/docker-for-windows/install/)。
+ 在 Visual Studio 中创建（或打开）一个针对 Linux 的 ASP.NET Core 2.0 容器化应用程序的项目。
## 访问 “将容器发布到 AWS ” 向导
要部署针对 Linux 的 ASP.NET Core 2.0 容器化应用程序，请右键单击解决方案浏览器中的项目并选择**将容器发布到 AWS**。
![\[Context menu showing "Publish Container to AWS" option highlighted for deployment.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step0a.png)
您还可以在 Visual Studio 的“构建”菜单中选择**将容器发布到 AWS**。
## 将容器发布到 AWS 向导
![\[AWS Publish Container interface showing profile, Docker image, and deployment options for ECR.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step1.png)
**Account profile to use (要使用的账户配置文件)** - 选择要使用的账户配置文件。
**Region (区域)** - 选择部署区域。配置文件和区域用于设置您的部署环境资源并选择默认的 Docker 注册表。
**Configuration (配置)** - 选择 Docker 映像构建配置。
**Docker Repository (Docker 存储库)** - 选择现有 Docker 存储库，或键入新存储库的名称即可创建新存储库。这是构建容器要推送到的存储库。
**Tag (标签)** - 选择现有标签或键入新标签的名称。标签可以跟踪重要详细信息，如 Docker 容器的版本、选项或其他唯一配置元素。
**Deployment Target (部署目标)** – 选择 **Service on an ECS Cluster (ECS 集群上的服务)**。当您的应用程序（如 ASP.NET Web 应用程序）计划长时间运行时，请使用此部署选项。
**将设置保存到 `aws-docker-tools-defaults.json` 并为命令行部署配置项目** - 如果您需要从命令行灵活部署，请选中此选项。使用您的项目目录中的 `dotnet ecs deploy` 以部署和 `dotnet ecs publish` 容器。
## “Launch Configuration (启动配置)”页面
![\[AWS Launch Configuration interface for creating an empty ECS 集群 with FARGATE launch type.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step2.png)
**ECS Cluster (ECS 集群)** – 选择将运行 Docker 映像的集群。如果您选择创建空集群，请为您的新集群命名。
**Launch Type (启动类型)** - 选择 **FARGATE**。
**CPU Maximum (vCPU) (CPU 最大容量(vCPU))** - 选择您的应用程序所需的最大计算容量。要查看 CPU 和内存值的允许范围，请参阅[任务大小](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html)。
**Memory Maximum (GB) (CPU 最大容量(GB))** – 选择您的应用程序可用的最大内存容量。
**VPC Subnets (VPC 子网)** – 选择单个 VPC 中的一个或多个子网。如果您选择多个子网，则您的任务将分配到这几个子网中。这可以提高可用性。有关更多信息，请参阅[默认 VPC 和默认子网](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/default-vpc.html)。
**Security Groups (安全组)** - 选择一个安全组。
安全组可作为关联 Amazon EC2 实例的防火墙，在实例级别控制入站和出站流量。
[默认安全组](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html)配置为允许来自分配给同一安全组的实例的入站 IPv4 流量和所有出站流量。您需要允许出站，以便服务可以访问容器存储库。
**Assign Public IP Address (分配公有 IP 地址)** – 选中此复选框以便从 Internet 访问任务。
## “Service Configuration (服务配置)”页面
![\[AWS Service Configuration interface for deploying an application with customizable parameters.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step3.png)
**Service (服务)** - 从下拉框中选择一项服务，将您的容器部署到该现有服务。或者选择 **Create New (新建)** 新建一项服务。一个集群中的服务名称必须唯一，但是您可以为一个区域或多个区域中多个集群中的服务提供相似的名称。
**Number of Tasks (任务数)** - 要在您的集群中部署并保持运行的任务数量。每个任务都是您的容器的一个实例。
**Minimum Healthy Percent (最小正常运行状况百分比)** - 在部署期间必须处于 `RUNNING` 状态的任务百分比（四舍五入到最近的整数）。
**Maximum Percent (最大百分比)** - 在部署期间允许处于 `RUNNING` 或 `PENDING` 状态的任务百分比（向下舍入到最近的整数）。
## “Application Load Balancer (应用程序负载均衡器)”页面
![\[Application Load Balancer configuration interface for AWS with options for load balancer and target group settings.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step4.png)
**Configure Application Load Balancer (配置应用程序负载均衡器)** - 选中此项可配置应用程序负载均衡器。
**Load Balancer (负载均衡器)** - 选择一个现有负载均衡器，或者选择 **Create New (新建)** 并键入新负载均衡器的名称。
**Listener Port (侦听器端口)** - 选择一个现有侦听器端口，或者选择 **Create New (新建)** 并键入一个端口号。默认端口 `80` 适用于大多数 Web 应用程序。
**目标组** – 选择 Amazon ECS 要将服务任务注册到的目标组。
**Path Pattern (路径模式)** - 负载均衡器将使用基于路径的路由。接受默认 `/` 或提供一个不同模式。路径模式区分大小写，长度最多为 128 个字符，并且可包含[一组选定字符](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#path-conditions)。
**Health Check Path (运行状况检查路径)** - 进行运行状况检查的目标上的目的地的 Ping 路径。默认为 `/`。输入不同的路径（如果需要）。如果您输入的路径无效，则运行状况检查将失败，并将视为运行状况不佳。
如果您要部署多个服务，且每个服务都将部署到不同的路径或位置，您需要自定义检查路径。
## “Task Definition (任务定义)”页面
![\[AWS Task Definition interface for configuring Docker container parameters and permissions.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step5.png)
**Task Definition (任务定义)** - 选择一个现有任务定义，或者选择 **Create New (新建)** 并键入新任务定义的名称。
**Container (容器)** - 选择一个现有容器，或者选择 **Create New (新建)** 并键入新容器的名称。
**任务角色**-选择一个 IAM 角色，该角色具有您的应用程序访问 AWS 服务所需的证书。凭证就是通过这种方法传递给您的应用程序的。请参阅[如何为应用程序指定 AWS 安全凭证](deployment-ecs-specify-credentials.md)。
**任务执行角色**-选择有权提取私有镜像和发布日志的角色。 AWS Fargate 将代表你使用它。
**Port Mapping (端口映射)** - 选择绑定到自动分配的主机端口的容器上的端口号。
**Environment Variables (环境变量)** - 添加、修改或删除容器的环境变量。您可以进行修改以满足部署要求。
如果您对配置满意，请单击 **Publish (发布)** 开始部署流程。
## 将容器发布到 AWS
![\[AWS container publishing progress window showing steps for deploying to ECS and ECR.\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-visual-studio/latest/user-guide/images/wiz-ecspub-fargate-step6.png)
在部署过程中会显示事件。成功完成后向导会自动关闭。您可以通过取消选中页面底部的复选框来覆盖该功能。
您可以在 AWS 资源管理器中找到新实例的 URL。展开 Amazon ECS 和集群，然后单击您的集群。
# 将 ASP.NET Core 2.0 应用程序部署到 Amazon ECS（EC2）
本部分介绍如何借助**将容器发布到 AWS** 向导（作为 Toolkit for Visual Studio 的一部分提供）来使用 EC2 启动类型通过 Amazon ECS 部署针对 Linux 的容器化 ASP.NET Core 2.0 应用程序。由于 Web 应用程序要持续运行，因此该应用程序将作为一项服务部署。
## 在您发布容器之前
在使用**将容器发布到 AWS** 部署 ASP.NET Core 2.0 应用程序之前，请执行以下操作：
+ [指定 AWS 凭证](deployment-ecs-specify-credentials.md)并[设置以使用 Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/get-set-up-for-amazon-ecs.html)。
+ [安装 Docker](https://docs.docker.com/engine/installation)。有几个不同的安装选项，包括 [Docker for Windows](https://docs.docker.com/docker-for-windows/install/)。
+ 根据 Web 应用程序的需求[创建 Amazon ECS 集群](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-cluster.html)。只需几个步骤即可完成。
+ 在 Visual Studio 中创建（或打开）一个针对 Linux 的 ASP.NET Core 2.0 容器化应用程序的项目。
## 访问 “将容器发布到 AWS ” 向导
要部署针对 Linux 的 ASP.NET Core 2.0 容器化应用程序，请右键单击解决方案浏览器中的项目并选择**将容器发布到 AWS**。
您还可以在 Visual Studio 的“构建”菜单中选择**将容器发布到 AWS**。
## 将容器发布到 AWS 向导
**Account profile to use (要使用的账户配置文件)** - 选择要使用的账户配置文件。
**Region (区域)** - 选择一个部署区域。配置文件和区域用于设置您的部署环境资源并选择默认的 Docker 注册表。
**Configuration (配置)** - 选择 Docker 映像构建配置。
**Docker Repository (Docker 存储库)** - 选择现有 Docker 存储库，或键入新存储库的名称即可创建新存储库。这是构建的容器映像要推送到的存储库。
**Tag (标签)** - 选择现有标签或键入新标签的名称。标签可以跟踪重要详细信息，如 Docker 容器的版本、选项或其他唯一配置元素。
**Deployment (部署)** – 选择 **Service on an ECS Cluster (ECS 集群上的服务)**。当您的应用程序（如 ASP.NET 内核 2.0 Web 应用程序）计划长时间运行时，请使用此部署选项。
**将设置保存到 `aws-docker-tools-defaults.json` 并为命令行部署配置项目** - 如果您需要从命令行灵活部署，请选中此选项。使用您的项目目录中的 `dotnet ecs deploy` 以部署和 `dotnet ecs publish` 容器。
## “Launch Configuration (启动配置)”页面
**ECS Cluster (ECS 集群)** – 选择将运行 Docker 映像的集群。您可以使用 AWS 管理控制[台创建 ECS 集群](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create_cluster.html)。
**Launch Type (启动类型)** - 选择 EC2。要使用 Fargate 启动类型，请参阅[将 ASP.NET 内核 2.0 应用程序部署到 Amazon ECS (Fargate)](deployment-ecs-aspnetcore-fargate.md)。
## “Service Configuration (服务配置)”页面
**Service (服务)** - 从下拉框中选择一项服务，将您的容器部署到该现有服务。或者选择 **Create New (新建)** 新建一项服务。一个集群中的服务名称必须唯一，但是您可以为一个区域或多个区域中多个集群中的服务提供相似的名称。
**Number of Tasks (任务数)** - 要在您的集群中部署并保持运行的任务数量。每个任务都是您的容器的一个实例。
**Minimum Healthy Percent (最小正常运行状况百分比)** - 在部署期间必须处于 `RUNNING` 状态的任务百分比（四舍五入到最近的整数）。
**Maximum Percent (最大百分比)** - 在部署期间允许处于 `RUNNING` 或 `PENDING` 状态的任务百分比（向下舍入到最近的整数）。
**Placement Templates (放置模板)** – 选择任务放置模板。
如果您在集群中启动任务，Amazon ECS 必须根据任务定义中指定的要求（例如 CPU 和内存）确定将任务放置在何处。同样，如果您缩减任务计数，Amazon ECS 必须确定终止哪些任务。
放置模板用于控制任务如何在集群中启动：
+ AZ Balanced Spread (AZ 均衡分散) - 在各个可用区以及每个可用区中的各个容器实例中分配任务。
+ 可用区平衡 BinPack -在可用内存最少的可用区域和容器实例之间分配任务。
+ BinPack -根据最少可用的 CPU 或内存量来分配任务。
+ One Task Per Host (每个主机一项任务) - 在每个容器实例中最多可放置服务的一个任务。
有关更多信息，请参阅 [Amazon ECS 任务放置](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html)。
## “Application Load Balancer (应用程序负载均衡器)”页面
**Configure Application Load Balancer (配置应用程序负载均衡器)** - 选中此项可配置应用程序负载均衡器。
**Select IAM role for service (为服务选择 IAM 角色)** – 选择一个现有角色，或者选择 **Create New (新建)** 即可创建一个新角色。
**Load Balancer (负载均衡器)** - 选择一个现有负载均衡器，或者选择 **Create New (新建)** 并键入新负载均衡器的名称。
**Listener Port (侦听器端口)** - 选择一个现有侦听器端口，或者选择 **Create New (新建)** 并键入一个端口号。默认端口 `80` 适用于大多数 Web 应用程序。
**Target Group (目标组)** - 默认情况下，负载均衡器使用您为目标组指定的端口和协议将请求发送到已注册目标。在将每个目标注册到目标组时，可以覆盖此端口。
**Path Pattern (路径模式)** - 负载均衡器将使用基于路径的路由。接受默认 `/` 或提供一个不同模式。路径模式区分大小写，长度最多为 128 个字符，并且可包含[一组选定字符](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-listeners.html#path-conditions)。
**Health Check Path (运行状况检查路径)** - 进行运行状况检查的目标上的目的地的 Ping 路径。默认为 `/`，该设置适用于 Web 应用程序。输入不同的路径（如果需要）。如果您输入的路径无效，则运行状况检查将失败，并将视为运行状况不佳。
如果您要部署多个服务，且每个服务都将部署到不同的路径或位置，您可能需要自定义检查路径。
## “ECS Task Definition (ECS 任务定义)”页面
**Task Definition (任务定义)** - 选择一个现有任务定义，或者选择 **Create New (新建)** 并键入新任务定义的名称。
**Container (容器)** - 选择一个现有容器，或者选择 **Create New (新建)** 并键入新容器的名称。
**Memory (MiB) (内存(MiB))** - 提供**软限制**和/或**硬限制**的值。
要为容器预留的内存量的*软限制*（以 MiB 为单位）。Docker 尝试将容器内存控制在软限制以下。如果容器需要消耗更多内存，则上限为内存参数指定的硬限制（如果适用）或者容器实例中的全部可用内存，以较低者为准。
要提供给容器的内存的*硬限制*（以 MiB 为单位）。如果容器尝试使用超出此处指定的内存，该容器将被终止。
**任务角色**-为 IAM 角色选择一个任务角色，该角色允许容器代表您调用其关联策略中指定的权限。 AWS APIs 凭证就是通过这种方法传递给您的应用程序的。了解[如何为您的应用程序指定 AWS 安全证书](deployment-ecs-specify-credentials.md)。
**Port Mapping (端口映射)** – 添加、修改或删除容器的端口映射。如果负载均衡器为开启状态，主机端口将默认设置为 0，端口分配采用动态方式。
**Environment Variables (环境变量)** - 添加、修改或删除容器的环境变量。
如果您对配置满意，请单击 **Publish (发布)** 开始部署流程。
## 将容器发布到 AWS
在部署过程中会显示事件。成功完成后向导会自动关闭。您可以通过取消选中页面底部的复选框来覆盖该功能。
您可以在 AWS 资源管理器中找到新实例的 URL。展开 Amazon ECS 和集群，然后单击您的集群。