Setting up with AWS Proton - AWS Proton

Setting up with AWS Proton

If you want to use the AWS CLI to run AWS Proton APIs, verify that you have installed it. If you haven’t installed it, see Setting up with the AWS CLI.

AWS Proton specific configuration:

For more information about provisioning methods, see How AWS-managed provisioning works.

Setting up an Amazon S3 bucket

To set up an S3 bucket, follow the instructions at Create your first S3 bucket to set up an S3 bucket. Place your inputs to AWS Proton in the bucket where AWS Proton can retrieve them. These inputs are known as template bundles. You can learn more about them in other sections of this guide.

Setting up an AWS CodeStar connection

To connect AWS Proton to a repository, you create an AWS CodeStar connection that activates a pipeline when a new commit is made on a third-party source code repository.

AWS Proton uses the connection to:

  • Activate a service pipeline when a new commit is made on your repository source code.

  • Make a pull request on an infrastructure as code repository.

  • Create a new template minor or major version whenever a commit is pushed to a template repository that changes one of your templates, if the version doesn’t already exist.

You can connect to Bitbucket, GitHub, GitHub Enterprise and GitHub Enterprise Server repositories with AWS CodeStar connections. For more information, see AWS CodeStar connections in the AWS CodePipeline User Guide.

To set up a CodeStar connection.

  1. In the AWS Proton console.

  2. In the navigation pane, select Settings and then Repository connections to take you to the Connections page in Developer Tools Settings. The page displays a list of connections.

  3. Choose Create connection and follow the instructions.

Setting up account CI/CD settings

AWS Proton can provision CI/CD pipelines for deploying application code into your service instances. The AWS Proton settings you need for pipeline provisioning depend on the provisioning method you choose for your pipeline.

AWS-managed provisioning—set up a CI/CD pipeline role

With AWS-managed provisioning, AWS Proton provisions pipelines for you. Therefore, AWS Proton needs a service role that provides permissions for provisioning pipelines.

To create a pipeline service role using the console

  1. Open the AWS Proton console.

  2. In the navigation pane, choose Settings, and then choose Account settings.

  3. In the Account CI/CD settings page, choose Configure.

  4. In the Configure account settings page, in the CI/CD pipeline roles section:

    1. Select New service role.

    2. Enter a name for the role, for example, myProtonPipelineServiceRole.

    3. Check the check box to agree to create an AWS Proton role with administrative privileges in your account.

  5. Choose Save changes.

    Your new pipeline service role is displayed on the Account settings page.

Self-managed provisioning—set up a CI/CD pipeline repository

With self-managed provisioning, AWS Proton sends a pull request (PR) to a provisioning repository that you have set up, and your automation code is responsible for provisioning pipelines. Therefore, AWS Proton doesn't need a service role to provision pipelines. Instead, it needs a registered provisioning repository. Your automation code in the repository has to assume an appropriate role that provides permissions for provisioning pipelines.

To register a pipeline provisioning repository using the console

  1. Create a CI/CD pipeline provisioning repository if you haven't yet created one. For more information about pipelines in self-managed provisioning, see How self-managed provisioning works.

  2. In the navigation pane, choose Settings, and then choose Account settings.

  3. In the Account CI/CD settings page, choose Configure.

  4. In the Configure account settings page, in the CI/CD pipeline repository section:

    1. Select New repository, and then choose one of the repository providers.

    2. For CodeStar connection, choose one of your connections.

      Note

      If you don't yet have a connection to the relevant repository provider account, choose Add a new CodeStar connection, complete the connection creation process, and then choose the refresh button next to the CodeStar connection menu. You should now be able to choose your new connection in the menu.

    3. For Repository name, choose your pipeline provisioning repository. The drop-down menu shows the list of repositories in the provider account.

    4. For Branch name, choose one of the repository branches.

  5. Choose Save changes.

    Your pipeline repository is displayed on the Account settings page.

Setting up with the AWS CLI

To use the AWS CLI to make AWS Proton API calls, verify that you have installed the latest version of the AWS CLI. For more information, see Getting started with the AWS CLI