次の方法で共有


アプリ ホストの構成

アプリ ホスト プロジェクトは、分散アプリケーション (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",
        "ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21030",
        "ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22057"
      }
    }
  }
}

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

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

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

手記

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

一般的な構成

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

リソース サービス

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

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

ダッシュボード

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

オプション 既定値 形容
ASPNETCORE_URLS null ダッシュボードのアドレス。 https または ASPIRE_ALLOW_UNSECURED_TRANSPORT が true でない限り、DistributedApplicationOptions.AllowUnsecuredTransport する必要があります。 にランダムなポートを持つ localhost で自動的に生成されます。 起動設定の値は、applicationUrls プロパティで設定されます。
ASPNETCORE_ENVIRONMENT Production ダッシュボードが実行される環境を構成します。 詳細については、「で複数の環境を使用する 」を参照してください。
ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL gRPC エンドポイントが構成されていない場合に http://localhost:18889 します。 ダッシュボード OTLP gRPC アドレスを構成します。 OTLP 経由でテレメトリを受信するためにダッシュボードによって使用されます。 リソースに OTEL_EXPORTER_OTLP_ENDPOINT env var として設定します。 OTEL_EXPORTER_OTLP_PROTOCOL env var は grpc にランダムなポートを持つ localhost で自動的に生成されます。
ASPIRE_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null ダッシュボード OTLP HTTP アドレスを構成します。 OTLP 経由でテレメトリを受信するためにダッシュボードによって使用されます。 ASPIRE_DASHBOARD_OTLP_HTTP_ENDPOINT_URL のみが構成されている場合は、OTEL_EXPORTER_OTLP_ENDPOINT env var としてリソースに設定されます。 OTEL_EXPORTER_OTLP_PROTOCOL env var は http/protobuf
ASPIRE_DASHBOARD_CORS_ALLOWED_ORIGINS null ダッシュボードで構成されている CORS で許可されている配信元をオーバーライドします。 この設定は、リソース エンドポイントに基づいて許可される配信元を計算する既定の動作を置き換えます。
ASPIRE_DASHBOARD_FRONTEND_BROWSERTOKEN 自動生成された 128 ビット エントロピ トークン。 フロントエンド ブラウザー トークンを構成します。 これは、認証モードが BrowserToken の場合にダッシュボードにアクセスするために入力する必要がある値です。 ブラウザー トークンが指定されていない場合は、アプリ ホストが起動されるたびに新しいトークンが生成されます。
ASPIRE_DASHBOARD_TELEMETRY_OPTOUT false 使用状況テレメトリを送信しないようダッシュボードを構成します。
ASPIRE_DASHBOARD_AI_DISABLED false ダッシュボードの GitHub Copilot は、サポートされている IDE によってアプリ ホストが起動されたときに使用できます。 trueに設定すると、ダッシュボードで Copilot が無効になり、Copilot UI は表示されません。

国内

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

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