.NET Language Provider

A .NET language provider for Pulumi. Use your favorite .NET language to write Pulumi programs and deploy infrastructure to any cloud.

Installing the nuget package

dotnet add package Pulumi

Example Pulumi program with .NET and C#

Here's a simple example of a Pulumi app written in C# that creates some simple AWS resources:

using System.Collections.Generic;
using System.Threading.Tasks;
using Pulumi;
using Pulumi.Aws.S3;

return await Deployment.RunAsync(() =>
{
    // Create the bucket, and make it public.
    var bucket = new Bucket("media", new ()
    {
        Acl = "public-read"
    });

    // Add some content.
    var content = new BucketObject("basic-content", new ()
    {
        Acl = "public-read",
        Bucket = bucket.Id,
        ContentType = "text/plain; charset=utf8",
        Key = "hello.txt",
        Source = new StringAsset("Made with ❤, Pulumi, and .NET"),
    });

    // Return some values that will become the Outputs of the stack.
    return new Dictionary<string, object>
    {
        ["hello"] = "world",
        ["bucket-id"] = bucket.Id,
        ["content-id"] = content.Id,
        ["object-url"] = Output.Format($"http://{bucket.BucketDomainName}/{content.Key}"),
    };
});

Make a Pulumi.yaml file:

$ cat Pulumi.yaml

name: hello-dotnet
runtime: dotnet

Then, configure it:

$ pulumi stack init hello-dotnet
$ pulumi config set aws:region us-west-2

And finally, pulumi preview and pulumi up as you would any other Pulumi project.

Development and Testing

Prerequisites

• Dotnet SDK v6+ installed on your machine.
• Go 1.24+ for building and testing pulumi-language-dotnet
• The Pulumi CLI (used in automation tests and for integration tests)
• Run 'git submodule update --init --recursive'

Then you can run one of the following commands:

# Run all tests
make test [TEST_FILTER=testName]

# Build the Pulumi SDK
make build_sdk

# Running tests for the Pulumi SDK [or a specific test]
make test_sdk [TEST_FILTER=testName]

# Running tests for the Pulumi Automation SDK
dotnet run test-automation-sdk

# Install the language plugin
make install

# Building the language plugin. A binary will be built into the pulumi-language-dotnet folder.
# this is the binary that will be used by the integration tests.
make build_language_host

# Testing the language plugin
dotnet run test-language-plugin

# List all integration tests
go test -C integration_tests -list=. | grep ^Test

# Run all integration tests [or a specific test]
make test_integration [TEST_FILTER=testName]

# Format the code
make format_fix

# Check the code formatting
make format

Running integration tests

When running integration tests via an IDE like Goland or VSCode, you want the Pulumi CLI to use the pulumi-language-dotnet plugin from this repository, not the one that comes bundled with your Pulumi CLI. To do this, in your terminal dotnet run build-language-plugin or simply cd pulumi-language-dotnet && go build.

Alternatively, you can run make test_integration [TEST_FILTER=testName] which will build the language plugin for you just before running the tests.

Public API Changes

When making changes to the code you may get the following compilation error:

error RS0016: Symbol XYZ' is not part of the declared API.

This indicates a change in public API. If you are developing a change and this is intentional, add the new API elements to PublicAPI.Shipped.txt corresponding to your project (some IDEs will do this automatically for you, but manual additions are fine as well).