aws logo
AWS Classic v5.31.0, Mar 10 23

Dockerized ASP.NET App on AWS ECS Fargate | C#

View Code Deploy

This example defines a basic ASP.NET application and all of the infrastructure required to run it in AWS in C#.

This infrastructure includes everything needed to:

This example is inspired by Docker’s and ASP.NET’s Getting Started tutorials. The result is a simple development experience and yet an end result that uses modern, production-ready AWS infrastructure. ./Infra/Program.cs defines the project’s infrastructure.


Running the Example

Clone this repo and cd into it.

Next, to deploy the application and its infrastructure, follow these steps:

  1. Create a new stack, which is an isolated deployment target for this example:

    $ pulumi stack init dev
  2. Set your desired AWS region:

    $ pulumi config set aws:region us-east-1 # any valid AWS region will work
  3. Deploy everything with a single pulumi up command. This will show you a preview of changes first, which includes all of the required AWS resources (clusters, services, and the like). Don’t worry if it’s more than you expected – this is one of the benefits of Pulumi, it configures everything so that so you don’t need to!

    $ pulumi up

    After being prompted and selecting “yes”, your deployment will begin. It’ll complete in a few minutes:

    Updating (dev):
         Type                                        Name                Status
     +   pulumi:pulumi:Stack                         aws-cs-fargate-dev  created
     +   ├─ aws:ec2:SecurityGroup                    web-sg              created
     +   ├─ aws:ecs:Cluster                          app-cluster         created
     +   ├─ aws:iam:Role                             task-exec-role      created
     +   ├─ aws:elasticloadbalancingv2:TargetGroup   web-tg              created
     +   ├─ aws:ecr:Repository                       app-repo            created
     +   ├─ docker:image:Image                       app-img             created
     +   ├─ aws:iam:RolePolicyAttachment             task-exec-policy    created
     +   ├─ aws:ecs:TaskDefinition                   app-task            created
     +   ├─ aws:elasticloadbalancingv2:LoadBalancer  web-lb              created
     +   └─ aws:ecs:Service                          app-svc             created
        url: ""
        + 11 created
    Duration: 3m41s

    Notice that the automatically assigned load-balancer URL is printed as a stack output.

  4. At this point, your app is running – let’s curl it. The CLI makes it easy to grab the URL:

    $ curl $(pulumi stack output url)
    Hello World!
  5. Try making some changes and rerunning pulumi up.

    If you just change the application code, and deploy the results, for example, only the Docker image will be updated and rolled out. Try changing "Hello World!" inside of App/Startup.cs to "Hello Pulumi!":

    $ pulumi up
    Updating (dev):
          Type                       Name                Plan        Info
          pulumi:pulumi:Stack        aws-cs-fargate-dev
      +-  ├─ aws:ecs:TaskDefinition  app-task            replaced    [diff: ~containerDefinitions]
      ~   ├─ aws:ecs:Service         app-svc             updated     [diff: ~taskDefinition]
          └─ docker:image:Image      app-img
         ~ 1 updated
         +-1 replaced
         2 changes. 9 unchanged

    Notice that pulumi up redeploys just the parts of the application/infrastructure that you’ve edited.

    Now the endpoint will run the newly updated application code:

    $ curl $(pulumi stack output Url)
    Hello Pulumi!
  6. Once you are done, you can destroy all of the resources, and the stack:

    $ pulumi destroy
    $ pulumi stack rm