Hosting startup updates (#11879)

pull/11900/head
Luke Latham 2019-04-08 12:23:23 -05:00 committed by GitHub
parent d19cd80511
commit 20ebae97f6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 3 deletions

View File

@ -5,7 +5,7 @@ description: Discover how to enhance an ASP.NET Core app from an external assemb
monikerRange: '>= aspnetcore-2.1'
ms.author: riande
ms.custom: "mvc, seodec18"
ms.date: 03/23/2019
ms.date: 04/06/2019
uid: fundamentals/configuration/platform-specific-configuration
---
# Use hosting startup assemblies in ASP.NET Core
@ -375,7 +375,14 @@ dotnet nuget locals all --clear
**Activation from a runtime store-deployed assembly**
1. The *StartupDiagnostics* project uses [PowerShell](/powershell/scripting/powershell-scripting) to modify its *StartupDiagnostics.deps.json* file. PowerShell is installed by default on Windows starting with Windows 7 SP1 and Windows Server 2008 R2 SP1. To obtain PowerShell on other platforms, see [Installing Windows PowerShell](/powershell/scripting/setup/installing-powershell#powershell-core).
1. Execute the *build.ps1* script in the *RuntimeStore* folder. The `dotnet store` command in the script uses the `win7-x64` [runtime identifier (RID)](/dotnet/core/rid-catalog) for a hosting startup deployed to Windows. When providing the hosting startup for a different runtime, substitute the correct RID.
1. Run the *deploy.ps1* script in the *deployment* folder.
1. Execute the *build.ps1* script in the *RuntimeStore* folder. The script:
* Generates the `StartupDiagnostics` package.
* Generates the runtime store for `StartupDiagnostics` in the *store* folder. The `dotnet store` command in the script uses the `win7-x64` [runtime identifier (RID)](/dotnet/core/rid-catalog) for a hosting startup deployed to Windows. When providing the hosting startup for a different runtime, substitute the correct RID on line 37 of the script.
* Generates the `additionalDeps` for `StartupDiagnostics` in the *additionalDeps/shared/Microsoft.AspNetCore.App/{Shared Framework Version}/* folder.
* Places the *deploy.ps1* file in the *deployment* folder.
1. Run the *deploy.ps1* script in the *deployment* folder. The script appends:
* `StartupDiagnostics` to the `ASPNETCORE_HOSTINGSTARTUPASSEMBLIES` environment variable.
* The hosting startup dependencies path to the `DOTNET_ADDITIONAL_DEPS` environment variable.
* The runtime store path to the `DOTNET_SHARED_STORE` environment variable.
1. Run the sample app.
1. Request the `/services` endpoint to see the app's registered services. Request the `/diag` endpoint to see the diagnostic information.