リモートアプリのセットアップ

Von Bedeutung

フレームワークとコアアプリケーションでは、同じ仮想ディレクトリレイアウトを使用する必要があります。

仮想ディレクトリのセットアップは、システム内のルートの生成、承認、およびその他のサービスに使用されます。この時点で、ASP.NET Framework のしくみにより、異なる仮想ディレクトリを有効にする信頼性の高い方法は見つかりませんでした。

一部の増分アップグレードシナリオでは、新しい ASP.NET Core アプリが元の ASP.NET アプリと通信できるようになると便利です。

一般的なシナリオでは、次のことが可能になります。

YARP を使用してレガシアプリケーションにフォールバックする
リモートアプリ認証
リモートセッション

設定値

ASP.NET Core アプリが ASP.NET アプリと通信できるようにするには、各アプリに少し変更を加える必要があります。

両方のアプリケーションで 2 つの構成値を構成する必要があります。

RemoteAppApiKey: 2 つのアプリケーション間で共有されるキー ( GUID として解析可能である必要があります)。これは、 12345678-1234-1234-1234-123456789012のような GUID 値である必要があります。
RemoteAppUri: リモート ASP.NET Framework アプリケーションの URI (ASP.NET Core アプリケーション構成でのみ必要)。これは、 https://localhost:44300 や https://myapp.example.comなど、ASP.NET Framework アプリがホストされている完全な URL である必要があります。

ASP.NET Framework アプリケーションの構成

Von Bedeutung

ASP.NET Framework アプリケーションは、SSL を有効にしてホストする必要があります。増分移行用のリモートアプリのセットアップでは、外部から直接アクセスする必要はありません。プロキシ経由でクライアントアプリケーションからのアクセスのみを許可することをお勧めします。

ASP.NET Framework アプリケーションの場合は、次の値を web.config セクションの<appSettings>に追加します。

Von Bedeutung

ASP.NET Framework では、appSettings が web.configに格納されます。ただし、構成ビルダーを使用して、他のソース (環境変数など) から取得できます。これにより、このセットアップでローカルアプリケーションとリモートアプリケーション間で構成値を簡単に共有できるようになります。

<appSettings>
  <add key="RemoteAppApiKey" value="..." />
</appSettings>

ASP.NET Core クライアントからの要求を処理できるようにアプリケーションを構成するには、次を設定します。

NuGet パッケージをインストールする Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices

Application_Start ファイルの Global.asax.cs メソッドに構成コードを追加します。

protected void Application_Start()
{
    HttpApplicationHost.RegisterHost(builder =>
    {
        builder.AddSystemWebAdapters()
            .AddRemoteAppServer(options =>
            {
                // ApiKey is a string representing a GUID
                options.ApiKey = System.Configuration.ConfigurationManager.AppSettings["RemoteAppApiKey"];
            });
    });

    // ...existing code...
}

NuGet によってまだ追加されていない場合は、 SystemWebAdapterModule モジュールを web.config に追加します。このモジュール構成は、IIS ホスティングシナリオに必要です。 ASP.NET Core に SDK スタイルプロジェクトを使用する場合、 SystemWebAdapterModule モジュールは自動的に追加されません。
```
  <system.webServer>
    <modules>
+      <remove name="SystemWebAdapterModule" />
+      <add name="SystemWebAdapterModule" type="Microsoft.AspNetCore.SystemWebAdapters.SystemWebAdapterModule, Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices" preCondition="managedHandler" />
    </modules>
</system.webServer>
```

コアアプリケーション ASP.NET 構成する

ASP.NET Core アプリケーションの場合は、次の値を appsettings.jsonに追加します。

{
  "RemoteAppApiKey": "...",
  "RemoteAppUri": "https://localhost:44300"
}

ASP.NET アプリに要求を送信できるように ASP.NET Core アプリを設定するには、System.Web アダプターサービスを AddRemoteAppClient に登録した後、AddSystemWebAdaptersを呼び出してリモートアプリクライアントを構成します。

Program.cs ファイルに次の構成を追加します。

builder.Services.AddSystemWebAdapters()
    .AddRemoteAppClient(options =>
    {
        options.RemoteAppUrl = new(builder.Configuration["RemoteAppUri"]);
        options.ApiKey = builder.Configuration["RemoteAppApiKey"];
    });

ASP.NET と ASP.NET Core アプリの両方が更新されたので、拡張メソッドを使用して、必要に応じてリモートアプリ認証またはリモートセッションを設定できるようになりました。

プロキシを有効にする

ASP.NET Core アプリケーションから ASP.NET Framework アプリケーションへのプロキシを有効にするには、一致しない要求をレガシアプリケーションに転送するフォールバックルートを設定できます。これにより、ASP.NET Core アプリが移行された機能を処理しながら、移行されていない機能のために元のアプリにフォールバックする段階的な移行が可能になります。

最新のガイダンスに従って、YARP (さらに別のリバースプロキシ) NuGet パッケージをインストールします。

必要な using ステートメントを Program.csに追加します。

using Microsoft.Extensions.Options;
using Microsoft.AspNetCore.SystemWebAdapters;

リバースプロキシサービスを Program.csに登録します。
```
builder.Services.AddReverseProxy();
```

アプリをビルドして他のミドルウェアを構成した後、フォールバックルートマッピングを追加します。

var app = builder.Build();

// Configure your other middleware here (authentication, routing, etc.)

// Map the fallback route
app.MapForwarder("/{**catch-all}", app.Services.GetRequiredService<IOptions<RemoteAppClientOptions>>().Value.RemoteAppUrl.OriginalString)

    // Ensures this route has the lowest priority (runs last)
    .WithOrder(int.MaxValue)

    // Skips remaining middleware when this route matches
    .ShortCircuit();

app.Run();

オーケストレーション Aspire セットアップ

Von Bedeutung

この統合は現在プレビュー段階であり、NuGet.org のプレリリースパッケージとして公開されています。パッケージを追加するときは、ツールでプレリリースパッケージを有効にします (たとえば、Visual Studio の NuGet パッケージマネージャーで Include prerelease を選択するか、.NET CLI で同等のプレリリースオプションを使用します)。

ASP.NET Framework アプリケーション用のオーケストレーションAspireを追加する
ソリューションに新しい ASP.NET Core アプリケーションを追加し、 Aspire オーケストレーションに追加する
Aspire.Hosting.IncrementalMigration パッケージを AppHost プロジェクトに追加します。

フレームワークアプリケーションをローカルでホストするように IIS Express を構成し、増分移行拡張機能を使用して増分移行フォールバックを構成します。

var builder = DistributedApplication.CreateBuilder(args);

// Add ASP.NET Framework app with IIS Express
var frameworkApp = builder.AddIISExpressProject<Projects.FrameworkApplication>("framework");

// Add ASP.NET Core app with fallback to Framework app
var coreApp = builder.AddProject<Projects.CoreApplication>("core")
    .WithIncrementalMigrationFallback(frameworkApp, options =>
    {
        options.RemoteSession = RemoteSession.Enabled;
        options.RemoteAuthentication = RemoteAuthentication.DefaultScheme;
    });

builder.Build().Run();

サポートするシナリオの増分移行フォールバックのオプションを構成します。

ASP.NET Framework をサポートするように ServiceDefaults を構成する

パッケージ Aspire.Microsoft.AspNetCore.SystemWebAdapters をアプリケーションに追加します。

.NET Framework をサポートするように ServiceDefaults プロジェクトを更新します。これは既定の ServiceDefaults に基づいており、何かをカスタマイズした場合は異なる場合があります。

ターゲットフレームワークをマルチターゲットに更新します。

- <TargetFramework>net10.0</TargetFramework>
+ <TargetFrameworks>net481;net10.0</TargetFrameworks>

さまざまなフレームワークを考慮するように PackageReferences を更新します。

<ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Http.Resilience" />
    <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" />
    <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" />
    <PackageReference Include="OpenTelemetry.Extensions.Hosting" />
    <PackageReference Include="OpenTelemetry.Instrumentation.Http" />
    <PackageReference Include="OpenTelemetry.Instrumentation.Runtime" />
    <PackageReference Include="OpenTelemetry.Instrumentation.SqlClient" />
</ItemGroup>

<ItemGroup Condition=" '$(TargetFramework)' == 'net10.0' ">
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" />
</ItemGroup>

<ItemGroup Condition=" '$(TargetFramework)' == 'net481' ">
    <PackageReference Include="Microsoft.Extensions.Diagnostics.HealthChecks" />
    <PackageReference Include="OpenTelemetry.Instrumentation.AspNet" />
</ItemGroup>

テレメトリを有効にするには、メトリックとトレース登録を更新します。

        builder.Services.AddOpenTelemetry()
            .WithMetrics(metrics =>
            {
                metrics
+ #if NET
                    .AddAspNetCoreInstrumentation()
+ #else
+                   .AddAspNetInstrumentation()
+ #endif
                    .AddSqlClientInstrumentation()
                    .AddHttpClientInstrumentation()
                    .AddRuntimeInstrumentation();
            })
            .WithTracing(tracing =>
            {
                tracing.AddSource(builder.Environment.ApplicationName)
+ #if NET
                    .AddAspNetCoreInstrumentation()
+ #else
+                   .AddAspNetInstrumentation()
+ #endif
                    .AddSqlClientInstrumentation()
                    .AddHttpClientInstrumentation();
            });

ASP.NET Core にのみ適用されるため、既定のエンドポイントを無効にします。

+ #if NET
    public static WebApplication MapDefaultEndpoints(this WebApplication app)
    {
        // Default endpoint registrations
    }
+ #endif

ASP.NET Core と ASP.NET Framework の両方をサポートするマルチターゲット ServiceDefaults 構成の完全な実際の例については、System.Web アダプターリポジトリのサンプル Extensions.cs ファイル( https://github.com/dotnet/systemweb-adapters/blob/main/samples/ServiceDefaults/Extensions.cs)を参照してください。

ASP.NET Framework アプリケーションの構成

ServiceDefaults プロジェクトを参照する

Application_Start ファイルの Global.asax.cs メソッドに構成コードを追加します。

protected void Application_Start()
{
    HttpApplicationHost.RegisterHost(builder =>
    {
        builder.AddServiceDefaults();
        builder.AddSystemWebAdapters();
    });
}

コアアプリケーション ASP.NET 構成する

ServiceDefaults プロジェクトを参照する

Programs.csに System.Web アダプターを追加します。

var builder = WebApplication.CreateBuilder();

builder.AddServiceDefaults();
+ builder.AddSystemWebAdapters();

...

var app = builder.Build();

...

+ // Must be placed after routing if manually added
+ app.UseSystemWebAdapters();

...

+ app.MapRemoteAppFallback()
+
+   // Optional, but recommended unless middleware is needed
+   .ShortCircuit();

app.Run();

この構成では次のようになります。

ローカルルートが優先されます。ASP.NET Core アプリケーションに一致するルートがある場合、要求はローカルで処理されます
レガシアプリへのフォールバック: 一致しない要求は、ASP.NET Framework アプリケーションに自動的に転送されます
ミドルウェアの最適化: .ShortCircuit() メソッドは、要求を転送するときに不要なミドルウェアの実行を防ぎます

このセットアップにより、増分移行中にシームレスなユーザーエクスペリエンスが可能になり、ユーザーは単一のエンドポイントを介して移行された機能とレガシ機能の両方にアクセスできます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-16

次の方法で共有

リモート アプリのセットアップ

設定値

ASP.NET Framework アプリケーションの構成

コア アプリケーション ASP.NET 構成する

プロキシを有効にする

オーケストレーション Aspire セットアップ

ASP.NET Framework をサポートするように ServiceDefaults を構成する

ASP.NET Framework アプリケーションの構成

コア アプリケーション ASP.NET 構成する

フィードバック

その他のリソース

リモートアプリのセットアップ

コアアプリケーション ASP.NET 構成する

コアアプリケーション ASP.NET 構成する