My app uses appsettings.json for some settings. If appsettings.local.json is present, that should override appsettings.json for whatever settings it contains. So far, no problem.
But I use git for version control. Obviously, I don't want other users pulling down my local settings. So I git ignore appsettings.json.
Furthermore, there are a lot of projects in the solution. They share the same settings. So there is an appsettings.json at the solution level, and all the projects include it as a link.
Still fine, except for one thing. In order to be usable, I have to copy appsettings.local.json over to the output directory. But it shouldn't be in version control. So if someone clones the solution fresh they won't have it. That ought to be fine, but it isn't. VS. says "this file should be linked, but where the heck is it?" build error.
How can I deal with that?
With v2 this is dead simple.
- Add an
appsettings.local.json
to your project (it should nest itself below the main appsettings.json
file).
- Add
appsettings.local.json
to your .gitignore
In your startup.cs
within the constructor do the following:
public class Startup
{
public IConfigurationRoot Configuration { get; }
public Startup(IHostingEnvironment env)
{
var builder = new ConfigurationBuilder()
.SetBasePath(env.ContentRootPath)
.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true) //load base settings
.AddJsonFile("appsettings.local.json", optional: true, reloadOnChange: true) //load local settings
.AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true) //load environment settings
.AddEnvironmentVariables();
Configuration = builder.Build();
}
/*
* rest of your startup.cs
*/
}
For .Net Core >2.1 you can simply chain the extension method ConfigureAppConfiguration(Action<WebHostBuilderContext, IConfigurationBuilder> configureDelegate)
to your WebHost. Here is an example:
WebHost.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((hostingContext, config) =>
{
config.AddJsonFile(
"appsettings.Local.json",
optional: true,
reloadOnChange: true);
})
// ...
And of course ignore the appsettings.Local.json in your .gitignore.
The plan:
- Place default local values to
appsettings.local-base.json
.
- Add
appsettings.local.json
to .gitignore
.
- Copy
appsettings.local-base.json
as appsettings.local.json
to output folder if
appsettings.local.json
doesn't exist.
- Do nothing if user has his own
appsettings.local.json
in project folder (it will be copied to output folder by VS).
MSBuild Copy
target can conditionally copy a file before/after build. The target below is actual for a Visual Studio 2017 and csproj-based .NET Core project (file names are reduced):
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netcoreapp1.1</TargetFramework>
</PropertyGroup>
<!--rest of file -->
<Target Name="TestTarget" AfterTargets="Build">
<ItemGroup>
<FromFile Include="src.json" />
<ToFile Include="$(OutDir)dest.json" />
</ItemGroup>
<Message Text="Copying @(FromFile) file to: @(ToFile)" Importance="high" />
<Copy
SourceFiles="@(FromFile)"
DestinationFiles="@(ToFile)"
Condition="!Exists('@(ToFile)')"
OverwriteReadOnlyFiles="true"
SkipUnchangedFiles="false" />
</Target>
</Project>
After the project build the following message should appear in VS build output:
Copying src.json file to: bin\Debug\netcoreapp1.1\dest.json
Seems like this stuff is changing so fast, it's hard to keep track of "the right way" Microsoft wants these things handled.
In ASP.NET Core 2, I believe the expected way for developers to handle per-developer configuration values is with the Secret Manager.
Short summary: In Visual Studio 2019, right-click the project and choose Manage User Secrets. This creates a JSON file in %APPDATA%\Microsoft\UserSecrets\...
that is picked up automatically by WebHost.CreateDefaultBuilders()
(which is called implicitly in default ASP.NET core projects).