本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 自訂 ASP.NET Core Elastic Beanstalk 部署
<a name="deployment-beanstalk-custom-netcore"></a>

本主題說明部署的運作方式，以及使用 Elastic Beanstalk 和 Toolkit for Visual Studio 建立 ASP.NET Core 應用程式時，您可以執行哪些自訂部署。

在您完成 Toolkit for Visual Studio 中的部署精靈後，工具組會封裝應用程式，並將其傳送至 Elastic Beanstalk。建立應用程式套件的第一步是使用新的 dotnet CLI，以使用發佈命令準備應用程式進行**發佈**。架構和組態會從精靈中的設定傳遞至**發佈**命令。因此，如果您為 選擇了**發行**版本`configuration`，並為 選擇了 **netcoreapp1.0**`framework`，則工具組將執行下列命令：

 `dotnet publish --configuration Release --framework netcoreapp1.0` 

當**發佈**命令完成時，工具組會將新的部署資訊清單寫入發佈資料夾。部署資訊清單是名為 **aws-windows-deployment-manifest.json** 的 JSON 檔案，Elastic Beanstalk Windows 容器 (1.2 版或更新版本） 會讀取此檔案以判斷如何部署應用程式。例如，對於您想要在 IIS 根目錄部署的 ASP.NET Core 應用程式，工具組會產生如下所示的資訊清單檔案：

```
{
  "manifestVersion": 1,
  "deployments": {

    "aspNetCoreWeb": [
      {
        "name": "app",
        "parameters": {
          "appBundle": ".",
          "iisPath": "/",
          "iisWebSite": "Default Web Site"
        }
      }
    ]
  }
}
```

`appBundle` 屬性指出應用程式位元與資訊清單檔案的關聯。此屬性可以指向目錄或 ZIP 封存。`iisPath` 和 `iisWebSite` 屬性指出 IIS 中託管應用程式的位置。

## 自訂資訊清單
<a name="tkv-deploy-beanstalk-custom-netcore-manifest"></a>

工具組只會在發佈資料夾中不存在資訊清單檔案時寫入資訊清單檔案。如果檔案確實存在，工具組會更新資訊清單 `aspNetCoreWeb`區段下列出之第一個應用程式中的 `appBundle``iisPath`和 `iisWebSite` 屬性。這可讓您將 **aws-windows-deployment-manifest.json** 新增至您的專案，並自訂資訊清單。若要在 Visual Studio 中為 ASP.NET Core Web 應用程式執行此操作，請將新的 JSON 檔案新增至專案的根目錄，並命名為 **aws-windows-deployment-manifest.json**。

資訊清單必須命名為 **aws-windows-deployment-manifest.json**，且必須位於專案的根目錄。Elastic Beanstalk 容器會在根目錄中尋找資訊清單，如果找到資訊清單，則會叫用部署工具。如果檔案不存在，Elastic Beanstalk 容器會回到較舊的部署工具，其假設封存是 **ms 部署**封存。

為確保 dotnet CLI `publish`命令包含資訊清單，請更新 `project.json` 檔案，以在 的包含區段`include`中包含資訊清單檔案`publishOptions`。

```
{
   "publishOptions": {
     "include": [
       "wwwroot",
       "Views",
       "Areas/**/Views",
       "appsettings.json",
       "web.config",
       "aws-windows-deployment-manifest.json"
     ]
   }
 }
```

現在您已宣告資訊清單，使其包含在應用程式套件中，您可以進一步設定部署應用程式的方式。您可以自訂部署，超出部署精靈支援的範圍。 AWS 已為 **aws-windows-deployment-manifest.json 檔案**定義了 JSON 結構描述，而且當您安裝 Toolkit for Visual Studio 時，安裝程式會註冊結構描述的 URL。

當您開啟 時`windows-deployment-manifest.json`，您會在結構描述下拉式方塊中看到選取的結構描述 URL。您可以導覽至 URL，以取得資訊清單中可設定內容的完整描述。選取結構描述後，Visual Studio 會在您編輯資訊清單時提供 IntelliSense。

您可以執行的其中一個自訂是設定應用程式將在其中執行的 IIS 應用程式集區。下列範例示範如何定義 IIS 應用程式集區 ("customPool")，該集區每 60 分鐘回收一次程序，並使用 將其指派給應用程式`"appPool": "customPool"`。

```
{
  "manifestVersion": 1,
  "iisConfig": {
    "appPools": [
      {
        "name": "customPool",
        "recycling": {
          "regularTimeInterval": 60
        }
      }
    ]
  },
  "deployments": {
    "aspNetCoreWeb": [
      {
        "name": "app",
        "parameters": {
          "appPool": "customPool"
        }
      }
    ]
  }
}
```

此外，資訊清單可以宣告 Windows PowerShell 指令碼在安裝、重新啟動和解除安裝動作之前和之後執行。例如，下列資訊清單會執行 Windows PowerShell 指令碼`PostInstallSetup.ps1`，以在 ASP.NET Core 應用程式部署至 IIS 之後執行進一步的設定工作。新增這類指令碼時，請確定指令碼已新增至 `project.json` 檔案中 publishOptions 下的包含區段，就像您對 `aws-windows-deployment-manifest.json` 檔案所做的一樣。如果沒有，指令碼不會包含在 dotnet CLI **發佈**命令中。

```
{
  "manifestVersion": 1,
  "deployments": {
    "aspNetCoreWeb": [
      {
        "name": "app",
        "scripts": {
          "postInstall": {
            "file": "SetupScripts/PostInstallSetup.ps1"
          }
        }
      }
    ]
  }
}
```

## .ebextensions 如何？
<a name="tkv-deploy-beanstalk-custom-netcore-ebextensions"></a>

支援 Elastic Beanstalk **.ebextensions** 組態檔案，如同所有其他 Elastic Beanstalk 容器一樣。若要將 .ebextensions 包含在 ASP.NET Core 應用程式中，請將 `.ebextensions`目錄新增至 `project.json` 檔案`publishOptions`的 `include`區段。如需 .ebextensions 的詳細資訊，請參閱 [Elastic Beanstalk 開發人員指南](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/ebextensions.html)。