앱 호스트 구성

아티클
12/12/2024

앱 호스트 프로젝트는 분산 애플리케이션(DistributedApplication)을 구성하고 시작합니다. DistributedApplication 실행되면 앱 호스트에서 구성을 읽습니다. 구성은 앱 호스트에 설정된 환경 변수에서 로드되고 DistributedApplicationOptions.

구성에는 다음이 포함됩니다.

주소 및 인증 옵션과 같은 리소스 서비스를 호스팅하기 위한 설정입니다.
대시보드의 프런트 엔드 및 OTLP(OpenTelemetry Protocol) 주소와 같은 .NET.NET Aspire 대시보드시작하는 데 사용되는 설정입니다.
.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시작 프로필이 하나 있습니다.
.NET .NET Aspire 앱 호스트 프로젝트를 구성합니다.
- applicationUrl 속성은 대시보드 시작 주소(ASPNETCORE_URLS)를 구성합니다.
- DOTNET_DASHBOARD_OTLP_ENDPOINT_URL 및 DOTNET_RESOURCE_SERVICE_ENDPOINT_URL 같은 환경 변수는 앱 호스트에서 설정됩니다.

자세한 내용은 및 시작 프로필을 참조하세요.

메모

이 페이지에 설명된 구성은 .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 키입니다. API 키는 앱 호스트가 실행 모드이고, 대시보드가 비활성화되지 않고, `DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS`익명 액세스를 허용하도록 대시보드가 구성되지 않은 경우에 필요합니다.

대시보드

기본적으로 대시보드는 앱 호스트에서 자동으로 시작됩니다. 대시보드는 자체 구성집합을 지원하며 일부 설정은 앱 호스트에서 구성할 수 있습니다.

선택	기본값	묘사
`ASPNETCORE_URLS`	`null`	대시보드 주소입니다. `ASPIRE_ALLOW_UNSECURED_TRANSPORT` 또는 `DistributedApplicationOptions.AllowUnsecuredTransport` true가 아니면 `https` 합니다. launchSettings를 사용하여 자동으로 생성됩니다. localhost임의 포트를json. 시작 설정의 값은 `applicationUrls` 속성에 설정됩니다.
`ASPNETCORE_ENVIRONMENT`	`Production`	대시보드가 실행되는 환경을 구성합니다. 자세한 내용은 ASP.NET Core여러 환경 사용을 참조하세요.
`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`익명 액세스를 허용하도록 구성되지 않습니다.

다음을 통해 공유

앱 호스트 구성

일반 구성

리소스 서비스

대시보드

내부

추가 리소스