Example 1: Create an AWS CodeCommit pipeline with AWS CloudFormation

This walkthrough shows you how to use the AWS CloudFormation console to create infrastructure that includes a pipeline connected to a CodeCommit source repository. In this tutorial, you use the provided sample template file to create your resource stack, which includes your artifact store, pipeline, and change-detection resources, such as your Amazon CloudWatch Events rule. After you create your resource stack in AWS CloudFormation, you can view your pipeline in the AWS CodePipeline console. The pipeline is a two-stage pipeline with a CodeCommit source stage and a CodeDeploy deployment stage.

Prerequisites:

You must have created the following resources to use with the AWS CloudFormation sample template:

• You must have created a source repository. You can use the AWS CodeCommit repository you created in Tutorial: Create a simple pipeline (CodeCommit repository).

• You must have created a CodeDeploy application and deployment group. You can use the CodeDeploy resources you created in Tutorial: Create a simple pipeline (CodeCommit repository).

• Choose one of these links to download the sample AWS CloudFormation template file for creating a pipeline: YAML | JSON

  Unzip the file and place it on your local computer.

• Download the SampleApp_Linux.zip sample application file.

Create your pipeline in AWS CloudFormation

1. Unzip the files from SampleApp_Linux.zip and upload the files to your AWS CodeCommit repository. You must upload the unzipped files to the root directory of your repository. You can follow the instructions in Step 2: Add sample code to your CodeCommit repository to push the files to your repository.

2. Open the AWS CloudFormation console and choose Create Stack. Choose With new resources (standard).

3. Under Specify template, choose Upload a template. Select Choose file and then choose the template file from your local computer. Choose Next.

4. In Stack name, enter a name for your pipeline. Parameters specified by the sample template are displayed. Enter the following parameters:

   1. In ApplicationName, enter the name of your CodeDeploy application.

   2. In BetaFleet, enter the name of your CodeDeploy deployment group.

   3. In BranchName, enter the repository branch you want to use.

   4. In RepositoryName, enter the name of your CodeCommit source repository.

5. Choose Next. Accept the defaults on the following page, and then choose Next.

6. In Capabilities, select I acknowledge that AWS CloudFormation might create IAM resources, and then choose Create stack.

7. After your stack creation is complete, view the event list to check for any errors.

   Troubleshooting

   The IAM user who is creating the pipeline in AWS CloudFormation might require additional permissions to create resources for the pipeline. The following permissions are required in the policy to allow AWS CloudFormation to create the required Amazon CloudWatch Events resources for the CodeCommit pipeline:

   {
        "Effect": "Allow",
        "Action": [
           "events:PutRule",
           "events:PutEvents",
           "events:PutTargets",
           "events:DeleteRule",
           "events:RemoveTargets",
           "events:DescribeRule"
        ],
        "Resource": "resource_ARN"
   }

8. Sign in to the AWS Management Console and open the CodePipeline console at https://console.aws.amazon.com/codepipeline/.

   Under Pipelines, choose your pipeline and choose View. The diagram shows your pipeline source and deployment stages.

   Note

   To view the pipeline that was created, find the Logical ID column under the Resources tab for your stack in AWS CloudFormation. Note the name in the Physical ID column for the pipeline. In CodePipeline, you can view the pipeline with the same Physical ID (pipeline name) in the Region where you created your stack.

9. In your source repository, commit and push a change. Your change-detection resources pick up the change, and your pipeline starts.