reference deployment

.NET Framework CI/CD on Amazon ECS

Deploy an automated pipeline for containerized .NET applications

This Quick Start deploys a continuous integration and continuous delivery (CI/CD) pipeline on the Amazon Web Services (AWS) Cloud for .NET applications that run on Amazon Elastic Container Service (Amazon ECS). Your application is updated each time code is changed on your configured GitHub repository branch without interrupting the Amazon ECS service.

AWS CodePipeline creates a pipeline with source, build, and deploy stages. During the source stage, code is retrieved from GitHub and stored on Amazon Simple Storage Service (Amazon S3). In the build stage, AWS CodeBuild and AWS Systems Manager build a new Docker container image of your code on a temporary Amazon Elastic Compute Cloud (Amazon EC2) instance. In the deploy stage, AWS CodeDeploy deploys the updated image to Amazon ECS.

This Quick Start was developed by AWS.

  •  What you'll build
  • This Quick Start sets up the following:

    • AWS CodePipeline to create a pipeline with source, build, and deploy stages. The pipeline is invoked when a developer commits a code change to the configured GitHub repository branch. 
    • An Amazon S3 bucket to store pipeline artifacts.
    • AWS CodeBuild to build the source code into a new Docker container image. AWS CodeBuild connects to AWS Systems Manager, which automates the following build tasks:
      • Retrieves code from Amazon S3.
      • Provisions a temporary Amazon EC2 instance in the default virtual private cloud (VPC).
      • Builds a new Docker container image from the source code. 
      • Publishes the new Docker container image to Amazon Elastic Container Registry (Amazon ECR).
    • AWS CodeDeploy to deploy the new Docker container image to Amazon ECS.
  •  How to deploy
  • To deploy .NET Framework CI/CD for Amazon ECS, follow the instructions in the deployment guide. The deployment process takes about 5 minutes and includes these steps:

    1. Sign in to your AWS account. If you don't have an account, sign up at
    2. Choose one of the following options to launch the Quick Start. Before you create the stack, choose the AWS Region from the top toolbar.
    3. Test the deployment. 

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on this solution.  

  •  Cost and licenses
  • You are responsible for the cost of the AWS services and any third-party licenses used while running this Quick Start reference deployment. There is no additional cost for using the Quick Start. This Quick Start does not require additional licenses for deployment.

    The AWS CloudFormation templates for this Quick Start include configuration parameters that you can customize. Some of these settings affect the cost of deployment. For cost estimates, see the pricing pages for each AWS service you use. Prices are subject to change.

    Tip: After you deploy the Quick Start, create AWS Cost and Usage Reports to track costs associated with the Quick Start. These reports deliver billing metrics to an Amazon Simple Storage Service (Amazon S3) bucket in your account. They provide cost estimates based on usage throughout each month and aggregate the data at the end of the month. For more information about the report, see What are AWS Cost and Usage Reports?