次の方法で共有

アプリ ホストの構成

  • [アーティクル]

アプリ ホスト プロジェクトは、分散アプリケーション (DistributedApplication) を構成して起動します。 DistributedApplication を実行すると、アプリ ホストから構成が読み取られます。 構成は、アプリ ホストと DistributedApplicationOptionsに設定されている環境変数から読み込まれます。

構成には次のものが含まれます。

  • アドレスや認証オプションなど、リソース サービスをホストするための設定。
  • .NET .NET Aspire ダッシュボードのを開始するために使用される設定 (ダッシュボードのフロントエンドアドレスや OpenTelemetry プロトコル (OTLP) アドレスなど)。
  • アプリ ホストの実行に使用 .NET.NET Aspire 内部設定。 これらは内部的に設定されますが、.NET.NET Aspireを拡張する統合によってアクセスできます。

アプリ ホストの構成は、アプリ ホスト起動プロファイルによって提供されます。 アプリ ホストには、launchSettings 起動設定ファイルの呼び出しがあります。json 起動プロファイルの一覧があります。 各起動プロファイルは、アプリケーションを起動 dotnet 方法を定義する関連オプションのコレクションです。

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:17134;http://localhost:15170",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "DOTNET_ENVIRONMENT": "Development",
        "DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21030",
        "DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22057"
      }
    }
  }
}

上記の起動設定ファイル:

  • httpsという名前の起動プロファイルが 1 つ含まれます。
  • .NET .NET Aspire アプリ ホスト プロジェクトを構成します。
    • applicationUrl プロパティは、ダッシュボードの起動アドレス (ASPNETCORE_URLS) を構成します。
    • DOTNET_DASHBOARD_OTLP_ENDPOINT_URL や DOTNET_RESOURCE_SERVICE_ENDPOINT_URL などの環境変数は、アプリ ホストで設定されます。

詳細については、「.NET.NET Aspire プロファイルと起動プロファイルの」を参照してください。

手記

このページで説明する構成は、.NET.NET Aspire アプリ ホスト プロジェクト用です。 スタンドアロン ダッシュボードを構成するには、ダッシュボードの構成を参照してください。

一般的な構成

オプション 既定値 形容
ASPIRE_ALLOW_UNSECURED_TRANSPORT false https を使用しないアプリ ホストとの通信を許可します。 ASPNETCORE_URLS (ダッシュボード アドレス) と DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (アプリ ホスト リソース サービス アドレス) は、true でない限り HTTPS で保護する必要があります。
DOTNET_ASPIRE_CONTAINER_RUNTIME docker コンテナーによってサポートされるリソースの代替コンテナー ランタイムのユーザーを許可します。 指定できる値は、docker (既定値) または podmanです。 の詳細については、「セットアップとツールの概要」を参照してください。

リソース サービス

リソース サービスは、アプリ ホストによってホストされます。 リソース サービスは、.NET.NET Aspireによって調整されているリソースに関する情報を取得するためにダッシュボードによって使用されます。

オプション 既定値 形容
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null アプリ ホストによってホストされるリソース サービスのアドレスを構成します。 launchSettings を使用して自動的に生成されます。localhostにランダムなポートを持つjson。 たとえば、https://localhost:17037します。
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY 自動生成された 128 ビット エントロピ トークン。 アプリ ホストのリソース サービスに対する要求の認証に使用される API キー。 アプリ ホストが実行モードで、ダッシュボードが無効になっていない場合、およびダッシュボードが DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSでの匿名アクセスを許可するように構成されていない場合は、API キーが必要です。

ダッシュボード

既定では、ダッシュボードはアプリ ホストによって自動的に開始されます。 ダッシュボードでは、独自の構成セット サポートされており、一部の設定はアプリ ホストから構成できます。

オプション 既定値 形容
ASPNETCORE_URLS null ダッシュボードのアドレス。 ASPIRE_ALLOW_UNSECURED_TRANSPORT または DistributedApplicationOptions.AllowUnsecuredTransport が true でない限り、https する必要があります。 launchSettings を使用して自動的に生成されます。localhostにランダムなポートを持つjson。 起動設定の値は、applicationUrls プロパティで設定されます。
ASPNETCORE_ENVIRONMENT Production ダッシュボードが実行される環境を構成します。 詳細については、「で複数の環境を使用する 」を参照してください。
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL gRPC エンドポイントが構成されていない場合に http://localhost:18889 します。 ダッシュボード OTLP gRPC アドレスを構成します。 OTLP 経由でテレメトリを受信するためにダッシュボードによって使用されます。 リソースに OTEL_EXPORTER_OTLP_ENDPOINT env var として設定します。 OTEL_EXPORTER_OTLP_PROTOCOL env var は grpc。 launchSettings を使用して自動的に生成されます。localhostにランダムなポートを持つjson。
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null ダッシュボード OTLP HTTP アドレスを構成します。 OTLP 経由でテレメトリを受信するためにダッシュボードによって使用されます。 DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL のみが構成されている場合は、OTEL_EXPORTER_OTLP_ENDPOINT env var としてリソースに設定されます。 OTEL_EXPORTER_OTLP_PROTOCOL env var は http/protobuf。
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN 自動生成された 128 ビット エントロピ トークン。 フロントエンド ブラウザー トークンを構成します。 これは、認証モードが BrowserToken の場合にダッシュボードにアクセスするために入力する必要がある値です。 ブラウザー トークンが指定されていない場合は、アプリ ホストが起動されるたびに新しいトークンが生成されます。

国内

内部設定は、アプリ ホストと統合によって使用されます。 内部設定は、直接構成するようには設計されていません。

オプション 既定値 形容
AppHost:Directory プロジェクトがない場合のコンテンツ ルート。 アプリ ホストが配置されているプロジェクトのディレクトリ。 IDistributedApplicationBuilder.AppHostDirectoryからアクセスできます。
AppHost:Path アプリケーション名と組み合わせたディレクトリ。 アプリ ホストへのパス。 ディレクトリとアプリケーション名が結合されます。
AppHost:Sha256 アプリ ホストが発行モードのときに、アプリ ホスト名から作成されます。 それ以外の場合は、アプリのホスト パスから作成されます。 現在のアプリケーションの 16 進数でエンコードされたハッシュ。 ハッシュは現在のコンピューター上のアプリの場所に基づいているため、アプリ ホストの起動間で安定しています。
AppHost:OtlpApiKey 自動生成された 128 ビット エントロピ トークン。 ダッシュボード OTLP サービスに送信された要求の認証に使用される API キー。 この値は、必要に応じて存在します。アプリ ホストは実行モードで、ダッシュボードは無効ではなく、ダッシュボードは DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSでの匿名アクセスを許可するように構成されていません。
AppHost:BrowserToken 自動生成された 128 ビット エントロピ トークン。 アプリ ホストによってダッシュボードが起動されたときに、ダッシュボードの参照を認証するために使用されるブラウザー トークン。 ブラウザー トークンは、DOTNET_DASHBOARD_FRONTEND_BROWSERTOKENで設定できます。 この値は、必要に応じて存在します。アプリ ホストは実行モードで、ダッシュボードは無効ではなく、ダッシュボードは DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSでの匿名アクセスを許可するように構成されていません。
AppHost:ResourceService:AuthMode ApiKey. DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS が true の場合、値は Unsecured。 リソース サービスへのアクセスに使用される認証モード。 この値は、必要に応じて存在します。アプリ ホストは実行モードであり、ダッシュボードは無効になっていません。
AppHost:ResourceService:ApiKey 自動生成された 128 ビット エントロピ トークン。 アプリ ホストのリソース サービスに対する要求の認証に使用される API キー。 API キーは、DOTNET_DASHBOARD_RESOURCESERVICE_APIKEYで設定できます。 この値は、必要に応じて存在します。アプリ ホストは実行モードで、ダッシュボードは無効ではなく、ダッシュボードは DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSでの匿名アクセスを許可するように構成されていません。