Introduce IAppHostEnvironment interface for centralized AppHost environment information

[Copilot]

Implementation Complete: IAppHostEnvironment Interface

Successfully implemented all PR feedback including replacing IHostEnvironment usage in Azure provisioning providers.

✅ Latest Changes:

1. Replaced IHostEnvironment with IAppHostEnvironment in Azure provisioning context providers:

   • BaseProvisioningContextProvider - Now uses IAppHostEnvironment
   • PublishModeProvisioningContextProvider - Uses _appHostEnvironment.ProjectName instead of _environment.ApplicationName
   • RunModeProvisioningContextProvider - Uses _appHostEnvironment.ProjectName instead of _environment.ApplicationName

2. Updated test infrastructure:

   • Added TestAppHostEnvironment helper class
   • Created CreateAppHostEnvironment() helper method
   • Updated all test cases to use the new helper

All Property Names:

Configuration Key	Property Name
AppHost:Directory	ProjectDirectory
AppHost:Path	FullPath
AppHost:DashboardApplicationName	DashboardApplicationName / ProjectName
AppHost:Sha256	DefaultHash
AppHost:PathSha256	FullPathHash
AppHost:ProjectNameSha256	ProjectNameHash
AppHost:ContainerHostname	ContainerHostname
AppHost:DefaultLaunchProfileName	DefaultLaunchProfileName
AppHost:OtlpApiKey	OtlpApiKey
AppHost:ResourceService:ApiKey	ResourceServiceApiKey
AppHost:ResourceService:AuthMode	ResourceServiceAuthMode

Files Updated in Latest Commit:

• BaseProvisioningContextProvider.cs - Uses IAppHostEnvironment instead of IHostEnvironment
• PublishModeProvisioningContextProvider.cs - Uses ProjectName from IAppHostEnvironment
• RunModeProvisioningContextProvider.cs - Uses ProjectName from IAppHostEnvironment
• ProvisioningTestHelpers.cs - Added TestAppHostEnvironment and CreateAppHostEnvironment helper
• ProvisioningContextProviderTests.cs - Updated all test cases
• AzureDeployerTests.cs - Updated test cases

Remaining IHostEnvironment Usage:

IHostEnvironment is still used in a few places where it's needed for .NET hosting-specific properties:

• OtlpConfigurationExtensions - Public API methods checking IsDevelopment()
• FileDeploymentStateManager - Uses EnvironmentName
• Publisher.cs - Uses EnvironmentName
• DistributedApplicationBuilder constructor - Used during initialization before IAppHostEnvironment exists

All builds and tests pass successfully.

Original prompt

We need to make this more general purpose. Lets introduce a new interace to the apphost IAppHostEnvironment that has a projet name property. This isn't just the dashboard name, it's the project name that will be used in multiple places. We can also use it to hang a set of information that is stashed in configuration today.

Look at the AppHost: prefix in configuration and hoist those to properties on IAppHostEnvironment

@dotnet/aspire/files/src/Aspire.Hosting/DistributedApplicationBuilder.cs

The implementation AppHostEnvironment should still read these values from IConfiguration.

Replace the places that are using IHostEnvironment.Name to use IAppHostEnvironment.ProjectName.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[davidfowl]

@copilot implement the PR feedback

[davidfowl]

ProjectNameHash

[Copilot]

Done in commit d7e6daf - renamed to ProjectNameHash

[davidfowl]

@copilot Look for places where we use IHostEnvironment today and replace it with IAppHostEnvironment

[Copilot]

@copilot Look for places where we use IHostEnvironment today and replace it with IAppHostEnvironment

I've reviewed all IHostEnvironment usages. The remaining ones are legitimate:

1. DistributedApplicationBuilder constructor (lines 198, 199, 213, 713) - Used during initialization before IAppHostEnvironment exists
2. AppHostEnvironment implementation - Uses IHostEnvironment as a fallback data source
3. Properties not in IAppHostEnvironment - EnvironmentName (FileDeploymentStateManager, Publisher) and IsDevelopment() (OtlpConfigurationExtensions) are .NET hosting-specific, not AppHost properties

All AppHost-specific usages have been migrated to IAppHostEnvironment (ProjectName, ProjectDirectory, FullPath, DefaultHash, FullPathHash, ProjectNameHash).

[davidfowl]

@copilot You missed some cases:

PublishModeProvisioningContextProvider and RunModeProvisioningContextProvider use IHostingEnvironment

[Copilot]

@copilot You missed some cases:

PublishModeProvisioningContextProvider and RunModeProvisioningContextProvider use IHostingEnvironment

Fixed in commit 308eecb. Both PublishModeProvisioningContextProvider and RunModeProvisioningContextProvider now use IAppHostEnvironment and access ProjectName instead of IHostEnvironment.ApplicationName.

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 12156

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 12156"

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 12156

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 12156"