Aracılığıyla paylaş

Uygulama ana bilgisayar yapılandırması

  • Makale

Uygulama ana bilgisayar projesi, dağıtılmış uygulamanızı (DistributedApplication) yapılandırıp başlatır. bir DistributedApplication çalıştırdığında uygulama konağından yapılandırmayı okur. Yapılandırma, uygulama konağından ayarlanan ortam değişkenlerinden yüklenir ve DistributedApplicationOptions.

Yapılandırma şunları içerir:

  • Adres ve kimlik doğrulama seçenekleri gibi kaynak hizmetini barındırma ayarları.
  • panonun ön ucu ve Protokolü (OTLP) adresleri gibi panosunu başlatmak için kullanılan ayarlar.
  • .NET .NET Aspire uygulama ana bilgisayarını çalıştırmak için kullandığı iç ayarlar. Bunlar dahili olarak ayarlanır, ancak .NET.NET Aspiregenişleten tümleştirmeler tarafından erişilebilir.

Uygulama ana bilgisayar yapılandırması, uygulama ana bilgisayar başlatma profili tarafından sağlanır. Uygulama konağı, başlatma profillerinin listesini içeren bir başlatma ayarları dosya çağrısı launchSettings.json sahiptir. Her başlatma profili, uygulamanızı başlatmak için nasıl dotnet istediğinizi tanımlayan ilgili seçeneklerden oluşan bir koleksiyondur.

{
  "$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"
      }
    }
  }
}

Önceki başlatma ayarları dosyası:

  • httpsadlı bir başlatma profili vardır.
  • .NET .NET Aspire uygulama ana bilgisayar projesini yapılandırıyor:
    • applicationUrl özelliği pano başlatma adresini (ASPNETCORE_URLS) yapılandırıyor.
    • DOTNET_DASHBOARD_OTLP_ENDPOINT_URL ve DOTNET_RESOURCE_SERVICE_ENDPOINT_URL gibi ortam değişkenleri uygulama ana bilgisayarında ayarlanır.

Daha fazla bilgi için bkz. ve başlatma profilleri.

Not

Bu sayfada açıklanan yapılandırma, .NET.NET Aspire uygulama ana bilgisayar projesi içindir. Tek başına panoyu yapılandırmak için bkz. pano yapılandırması.

Ortak yapılandırma

Seçenek Varsayılan değer Açıklama
ASPIRE_ALLOW_UNSECURED_TRANSPORT false Https olmadan uygulama konağıyla iletişime izin verir. ASPNETCORE_URLS (pano adresi) ve DOTNET_RESOURCE_SERVICE_ENDPOINT_URL (uygulama ana bilgisayarı kaynak hizmeti adresi) doğru olmadığı sürece HTTPS ile güvenli hale getirilmelidir.
DOTNET_ASPIRE_CONTAINER_RUNTIME docker Kapsayıcılar tarafından desteklenen kaynaklar için alternatif kapsayıcı çalışma zamanları kullanıcısına izin verir. Olası değerler docker (varsayılan) veya podman. diğer ayrıntılar için bkz. Kurulum ve araçlara genel bakış.

Kaynak hizmeti

Bir kaynak hizmeti, uygulama konağı tarafından barındırılır. Kaynak hizmeti, .NET.NET Aspiretarafından düzenlenen kaynaklar hakkında bilgi getirmek için pano tarafından kullanılır.

Seçenek Varsayılan değer Açıklama
DOTNET_RESOURCE_SERVICE_ENDPOINT_URL null Uygulama konağı tarafından barındırılan kaynak hizmetinin adresini yapılandırılır. localhostüzerinde rastgele bir bağlantı noktası olması için launchSettings.json ile otomatik olarak oluşturulur. Örneğin, https://localhost:17037.
DOTNET_DASHBOARD_RESOURCESERVICE_APIKEY Otomatik olarak 128 bit entropi belirteci oluşturulur. Uygulama konağı kaynak hizmetine yapılan isteklerin kimliğini doğrulamak için kullanılan API anahtarı. Uygulama konağı çalışma modundaysa, pano devre dışı bırakılmadıysa ve pano DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSile anonim erişime izin verecek şekilde yapılandırılmadıysa API anahtarı gereklidir.

Tablo

Varsayılan olarak, pano uygulama konağı tarafından otomatik olarak başlatılır. Pano, kendi yapılandırma kümesini destekler ve bazı ayarlar uygulama konağından yapılandırılabilir.

Seçenek Varsayılan değer Açıklama
ASPNETCORE_URLS null Pano adresi. https veya ASPIRE_ALLOW_UNSECURED_TRANSPORT doğru olmadığı sürece DistributedApplicationOptions.AllowUnsecuredTransport olmalıdır. localhostüzerinde rastgele bir bağlantı noktası olması için launchSettings.json ile otomatik olarak oluşturulur. Başlatma ayarlarındaki değer applicationUrls özelliğinde ayarlanır.
ASPNETCORE_ENVIRONMENT Production Panonun çalıştığı ortamı yapılandırıyor. Daha fazla bilgi için bkz. ASP.NET Core'de birden çok ortam kullanma.
DOTNET_DASHBOARD_OTLP_ENDPOINT_URL Hiçbir gRPC uç noktası yapılandırılmamışsa http://localhost:18889. Pano OTLP gRPC adresini yapılandırıyor. OtLP üzerinden telemetri almak için pano tarafından kullanılır. Kaynakları OTEL_EXPORTER_OTLP_ENDPOINT var olarak ayarlayın. OTEL_EXPORTER_OTLP_PROTOCOL env var grpc. localhostüzerinde rastgele bir bağlantı noktası olması için launchSettings.json ile otomatik olarak oluşturulur.
DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL null Pano OTLP HTTP adresini yapılandırıyor. OtLP üzerinden telemetri almak için pano tarafından kullanılır. Yalnızca DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL yapılandırılmışsa, kaynaklarda OTEL_EXPORTER_OTLP_ENDPOINT env var olarak ayarlanır. OTEL_EXPORTER_OTLP_PROTOCOL env var http/protobuf.
DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN Otomatik olarak 128 bit entropi belirteci oluşturulur. Ön uç tarayıcı belirtecini yapılandırıyor. Bu, kimlik doğrulama modu BrowserToken olduğunda panoya erişmek için girilmesi gereken değerdir. Tarayıcı belirteci belirtilmezse, uygulama konağı her başlatıldığında yeni bir belirteç oluşturulur.

Dahili

İç ayarlar, uygulama konağı ve tümleştirmeleri tarafından kullanılır. İç ayarlar doğrudan yapılandırılacak şekilde tasarlanmamıştır.

Seçenek Varsayılan değer Açıklama
AppHost:Directory Proje yoksa içerik kökü. Uygulama ana bilgisayarının bulunduğu projenin dizini. IDistributedApplicationBuilder.AppHostDirectoryerişilebilir.
AppHost:Path Uygulama adıyla birleştirilen dizin. Uygulama konağı yolu. Dizini uygulama adıyla birleştirir.
AppHost:Sha256 Uygulama ana bilgisayarı yayımlama modundayken uygulama ana bilgisayar adından oluşturulur. Aksi takdirde uygulama ana bilgisayar yolundan oluşturulur. Geçerli uygulama için onaltılık kodlanmış karma. Karma, uygulamanın geçerli makinedeki konumunu temel alır, bu nedenle uygulama konağı başlatmaları arasında kararlıdır.
AppHost:OtlpApiKey Otomatik olarak 128 bit entropi belirteci oluşturulur. Pano OTLP hizmetine gönderilen isteklerin kimliğini doğrulamak için kullanılan API anahtarı. Gerekirse değer mevcuttur: uygulama konağı çalışma modundadır, pano devre dışı bırakılmaz ve pano DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSile anonim erişime izin verecek şekilde yapılandırılmaz.
AppHost:BrowserToken Otomatik olarak 128 bit entropi belirteci oluşturulur. Uygulama konağı tarafından başlatıldığında panoya gözatma kimliğini doğrulamak için kullanılan tarayıcı belirteci. Tarayıcı belirteci DOTNET_DASHBOARD_FRONTEND_BROWSERTOKENtarafından ayarlanabilir. Gerekirse değer mevcuttur: uygulama konağı çalışma modundadır, pano devre dışı bırakılmaz ve pano DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSile anonim erişime izin verecek şekilde yapılandırılmaz.
AppHost:ResourceService:AuthMode ApiKey. DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS true ise değeri Unsecuredolur. Kaynak hizmetine erişmek için kullanılan kimlik doğrulama modu. Gerekirse değer mevcut olur: uygulama konağı çalışma modundadır ve pano devre dışı bırakılmaz.
AppHost:ResourceService:ApiKey Otomatik olarak 128 bit entropi belirteci oluşturulur. Uygulama konağı kaynak hizmetine yapılan isteklerin kimliğini doğrulamak için kullanılan API anahtarı. API anahtarı DOTNET_DASHBOARD_RESOURCESERVICE_APIKEYtarafından ayarlanabilir. Gerekirse değer mevcuttur: uygulama konağı çalışma modundadır, pano devre dışı bırakılmaz ve pano DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUSile anonim erişime izin verecek şekilde yapılandırılmaz.