prerequisites-github-codestarconnection.md

GitHub - AWS CodeStar Connection Prerequisite

To be able to use GitHub repositories in AWS CodePipeline with cicd-boot, a AWS CodeStar Connection needs to be established. For more details go to the GitHub connection page.

Quick Setup

To create the AWS CodeStar Connection go to the desired AWS account where the AWS CodePipeline are planned to be placed and execute the following command.

aws codestar-connections create-connection --provider-type GitHub --profile $RES_ACCOUNT_AWS_PROFILE --region ${AWS_REGION} --connection-name MyConnection

This will initialize the connection from the AWS side. As a follow up go to the AWS CodeStar Connection on the Console and follow up the installation steps through the browser.

Note: The user needs to have the following permission to establish the connection.

• Ownership permission on the GitHub Organization / Account
• IAM Permissions on the account
  • codestar-connections:ListConnections
  • codestar-connections:CreateConnection
  • codestar-connections:UpdateConnectionInstallation

Known Issues

• Careful if you see a page with AccessDeniedException when you open the Console. You might be using a wrong region or you don't have the right permissions.
• Make sure you have cookies enabled for your browser and you have the right permissions on both AWS and GitHub side

Pointers to external documentation

• GitHub connection
• Update a pending connection