AWS CodeCommit - User Guide

1 AWS CodeCommitUser GuideAPI Version 2015-04-13 AWS CodeCommit user GuideAWS CodeCommit : user GuideCopyright 2018 Amazon Web Services, Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored CodeCommit user GuideTable of ixWhat Is AWS CodeCommit ? .. 1 Introducing AWS CodeCommit .. 1 How Does AWS CodeCommit Work? .. 2 How Is AWS CodeCommit Different from File Versioning in Amazon S3?

2 3 How Do I Get Started with AWS CodeCommit ? .. 3 Where Can I Learn More About Git? .. 3 Setting Up .. 4 Setting Up Using Git Credentials .. 4 Setting Up Using Other Methods .. 4 Compatibility for AWS CodeCommit , Git, and Other Components .. 5 For HTTPS Users Using Git Credentials .. 5 Step 1: Initial Configuration for AWS CodeCommit .. 6 Step 2: Install 6 Step 3: Create Git Credentials for HTTPS Connections to AWS CodeCommit .. 7 Step 4: Connect to the AWS CodeCommit Console and Clone the Repository .. 8 Next Steps .. 9 For Connections from Development Tools .. 9 Integrate AWS Cloud9 with AWS CodeCommit .. 12 Integrate Visual Studio with AWS CodeCommit .. 15 Integrate Eclipse with AWS CodeCommit .. 19 For SSH Users Not Using the AWS CLI.

3 23 Step 1: Associate Your Public Key with Your IAM user .. 24 Step 2: Add AWS CodeCommit to Your SSH Configuration .. 24 Next Steps .. 25 For SSH Connections on Linux, macOS, or Unix .. 25 Step 1: Initial Configuration for AWS CodeCommit .. 25 Step 2: Install 26 Step 3: Configure Credentials on Linux, macOS, or Unix .. 26 Step 4: Connect to the AWS CodeCommit Console and Clone the Repository .. 28 Next Steps .. 29 For SSH Connections on Windows .. 29 Step 1: Initial Configuration for AWS CodeCommit .. 30 Step 2: Install 30 SSH and Windows: Set Up the Public and Private Keys for Git and AWS CodeCommit .. 31 Step 4: Connect to the AWS CodeCommit Console and Clone the Repository .. 33 Next Steps .. 33 For HTTPS Connections on Linux, macOS, or Unix with the AWS CLI Credential Helper.

4 34 Step 1: Initial Configuration for AWS CodeCommit .. 34 Step 2: Install 36 Step 3: Set Up the Credential Helper .. 36 Step 4: Connect to the AWS CodeCommit Console and Clone the Repository .. 37 Next Steps .. 38 For HTTPS Connections on Windows with the AWS CLI Credential Helper .. 38 Step 1: Initial Configuration for AWS CodeCommit .. 38 Step 2: Install 40 Step 3: Set Up the Credential Helper .. 40 Step 4: Connect to the AWS CodeCommit Console and Clone the Repository .. 42 Next Steps .. 42 Getting Started .. 43 AWS CodeCommit Tutorial .. 43 Step 1: Create an AWS CodeCommit Repository .. 45 Step 2: Add Files to Your Repository .. 46 Step 3: Browse the Contents of Your Repository .. 48 API Version 2015-04-13iiiAWS CodeCommit user GuideStep 4: Create and Collaborate on a Pull Request.

5 54 Step 5: Next Steps .. 58 Step 6: Clean 58 Git with AWS CodeCommit Tutorial .. 58 Step 1: Create an AWS CodeCommit Repository .. 59 Step 2: Create a Local Repo .. 60 Step 3: Create Your First Commit .. 60 Step 4: Push Your First Commit .. 61 Step 5: Share the AWS CodeCommit Repository and Push and Pull Another Commit .. 61 Step 6: Create and Share a Branch .. 63 Step 7: Create and Share a Tag .. 64 Step 8: Set Up Access Permissions .. 65 Step 9: Clean 66 Product and Service Integrations .. 68 Integration with Other AWS Services .. 68 Integration Examples from the Community .. 72 Blog Posts .. 72 Code 74 Working with Repositories .. 75 Create a Repository .. 76 Create a Repository (Console) .. 76 Create an AWS CodeCommit Repository (AWS CLI).

6 77 Connect to a Repository .. 78 Prerequisites for Connecting to an AWS CodeCommit Repository .. 78 Connect to the AWS CodeCommit Repository by Cloning the Repository .. 79 Connect a Local Repo to the AWS CodeCommit Repository .. 80 Share a Repository .. 81 Choose the Connection Protocol to Share with Your Users .. 81 Create IAM Policies for Your Repository .. 82 Create an IAM Group for Repository Users .. 83 Share the Connection Information with Your Users .. 83 Configuring Notifications for Repository Events .. 84 Using Repository Notifications .. 85 Configure Repository Notifications .. 86 Change, Disable, or Enable 88 Delete Notification Settings for a Repository .. 89 Manage Triggers for a Repository .. 90 Create the Resource and Add Permissions for AWS CodeCommit .

7 90 Create a Trigger for an Amazon SNS Topic .. 91 Create a Trigger for a Lambda Function .. 95 Create a Trigger for an Existing Lambda Function .. 98 Edit Triggers for a Repository .. 104 Test Triggers for a Repository .. 105 Delete Triggers from a Repository .. 106 View Repository Details .. 108 View Repository Details (Console) .. 108 View AWS CodeCommit Repository Details (Git) .. 109 View AWS CodeCommit Repository Details (AWS CLI) .. 110 Change Repository Settings .. 112 Change Repository Settings (Console) .. 112 Change AWS CodeCommit Repository Settings (AWS CLI) .. 113 Sync Changes Between Repositories .. 115 Push Commits to Two Repositories .. 115 Configure Cross-Account Access to a Repository .. 118 Cross-Account Repository Access: Actions for the Administrator in AccountA.

8 119 Cross Account Repository Access: Actions for the Administrator in AccountB .. 122 Cross-Account Repository Access: Actions for the Repository user in AccountB .. 123 API Version 2015-04-13ivAWS CodeCommit user GuideDelete a Repository .. 127 Delete a Repository (Console) .. 127 Delete a Local Repo .. 127 Delete an AWS CodeCommit Repository (AWS CLI) .. 127 Working with Files .. 129 Browse Files in a Repository .. 130 Browse an AWS CodeCommit Repository .. 130 Create or Add a File .. 131 Create or Upload a File (Console) .. 132 Add a File (AWS CLI) .. 133 Add a File (Git) .. 134 Edit the Contents of a File .. 134 Edit a File (Console) .. 135 Edit a File (AWS CLI) .. 136 Edit a File (Git) .. 137 Working with Pull Requests .. 138 Create a Pull Request.

9 140 Create a Pull Request (Console) .. 140 Create a Pull Request (AWS CLI) .. 142 View Pull Requests .. 143 View Pull Requests (Console) .. 143 View Pull Requests (AWS CLI) .. 144 Review a Pull Request .. 146 Review a Pull Request (Console) .. 147 Review Pull Requests (AWS CLI) .. 150 Update a Pull Request .. 153 Update a Pull Request (Git) .. 153 Update a Pull Request (Console) .. 154 Update Pull Requests (AWS CLI) .. 155 Close a Pull Request .. 156 Close a Pull Request (Console) .. 157 Close Pull Requests (AWS CLI) .. 158 Working with Commits .. 160 Create a Commit .. 161 View Commit 163 Browse Commits in a Repository .. 163 View Commit Details (AWS CLI) .. 166 View Commit Details (Git) .. 168 Compare Commits .. 170 Compare a Commit to Its Parent.

10 170 Compare Any Two Commit Specifiers .. 173 Comment on a 175 View Comments on a Commit in a Repository .. 176 Add and Reply to Comments on a Commit in a Repository .. 176 View, Add, Update, and Reply to Commments (AWS CLI) .. 181 Create a Tag .. 185 Use Git to Create a Tag .. 185 View Tag Details .. 186 View Tag Details (Console) .. 186 View Tag Details (Git) .. 187 Delete a Tag .. 188 Use Git to Delete a Tag .. 188 Working with Branches .. 190 Create a Branch .. 191 Create a Branch (Console) .. 191 Use Git to Create a Branch .. 192 Create a Branch (AWS CLI) .. 193 API Version 2015-04-13vAWS CodeCommit user GuideLimit Pushes and Merges to Branches .. 194 Configure an IAM Policy to Limit Pushes and Merges to a Branch .. 194 Apply the IAM Policy to an IAM Group or Role.