Troubleshooting

Terrabuild has limitations like all tools. This document tries to explain common errors and misunderstanding.

My project does not recompile despite a file has changed

If your project references files outside project hierarchy, use the includes attribute on project. By default, Terrabuild only tracks files below project path.

Support of props files in .net

Props files are not supported as they lies outside project structure and are not explicit. Dotnet extension does not attempt to find such files.

If you still need to track dependencies on such files, use the includes attribute on project.

Build fails to use environment variables

Probably you are using Docker. In order to allow given variables for the builder, use variables parameter when configuring extension on workspace or project.

extension @dotnet {
    container = "mcr.microsoft.com/dotnet/sdk:8.0.302"
    variables = [
        "DOTNET_NOLOGO"
        "DOTNET_CLI_TELEMETRY_OPTOUT"
        "DOTNET_SKIP_WORKLOAD_INTEGRITY_CHECK"
    ]
}