View source for GitHub Authentication for AWS CodePipeline

=External=

* https://docs.aws.amazon.com/codepipeline/latest/userguide/GitHub-authentication.html

=Internal=

* [[AWS_CodePipeline_Concepts#GitHub_Authentication|AWS CodePipeline Concepts]]
* [[GitHub_Procedures#GitHub_Authentication_for_AWS_CodePipeline|GitHub Procedures]]

=Overview=

This article describes how to configure the Source stage of an AWS CodePipeline to access a GitHub repository.

=Procedure=

==Create a Personal Access Token==

Use the procedure described here: {{Internal|GitHub_Procedures#Create_a_Personal_Access_Token_for_Command_Line|Create a GitHub Personal Access Token}}

==Update the Pipeline==

===CloudFormation===

Update "OAuthToken" value with the value of the personal access token.

<syntaxhighlight lang='yaml'>
Resources:
  MyPipeline:
    Type: AWS::CodePipeline::Pipeline
    Properties:
      Stages:
        - Name: Source
          Actions:
          - Name: 'pull-from-github'
            ActionTypeId:
              Category: Source
              Owner: ThirdParty
              Version: '1'
              Provider: GitHub
            Configuration:
              Owner: 'novaordis-llc'
              Repo: https://github.com/something
              Branch: master
              OAuthToken: <use the personal access token here>
</syntaxhighlight>

===AWS CLI===

<font color=darkgray>TODO, not tested.</font>

 aws codepipeline get-pipeline --name MyPipeline > pipeline.json

Update pipeline.json, as described [[#CloudFormation|above]], then

 aws codepipeline update-pipeline --cli-input-json file://pipeline.json

=Troubleshooting=

===="PermissionError: Could not access the GitHub repository====

{{External|https://docs.aws.amazon.com/codepipeline/latest/userguide/troubleshooting.html#troubleshooting-gs2}}