Amazon CodeCommit User Guide API Version 2015-04-13 Amazon CodeCommit User Guide Amazon CodeCommit: User Guide Amazon CodeCommit User Guide Table of Contents What is CodeCommit? ........................................................................................................................ 1 Introducing CodeCommit ............................................................................................................ 1 CodeCommit, Git, and choosing the right Amazon service for your needs .......................................... 2 How does CodeCommit work? ..................................................................................................... 3 How is CodeCommit different from file versioning in Amazon S3? .................................................... 4 How do I get started with CodeCommit? ....................................................................................... 4 Where can I learn more about Git? ............................................................................................... 4 Setting up ......................................................................................................................................... 5 View and manage your credentials ............................................................................................... 5 Setting up using Git credentials ................................................................................................... 6 Setting up using other methods .................................................................................................. 6 Compatibility for CodeCommit, Git, and other components ............................................................. 7 For HTTPS users using Git credentials ........................................................................................... 8 Step 1: Initial configuration for CodeCommit ......................................................................... 8 Step 2: Install Git ............................................................................................................... 9 Step 3: Create Git credentials for HTTPS connections to CodeCommit ....................................... 9 Step 4: Connect to the CodeCommit console and clone the repository ..................................... 10 Next steps ....................................................................................................................... 11 For HTTPS connections with git-remote-codecommit .................................................................... 11 Step 0: Install prerequisites for git-remote-codecommit ........................................................ 12 Step 1: Initial configuration for CodeCommit ....................................................................... 12 Step 2: Install git-remote-codecommit ................................................................................ 14 Step 3: Connect to the CodeCommit console and clone the repository ..................................... 15 Next steps ....................................................................................................................... 16 For connections from development tools .................................................................................... 16 Integrate Amazon Cloud9 with Amazon CodeCommit ........................................................... 19 Integrate Visual Studio with Amazon CodeCommit ............................................................... 22 Integrate Eclipse with Amazon CodeCommit ........................................................................ 25 For SSH users not using the Amazon CLI ..................................................................................... 28 Step 1: Associate your public key with your IAM user ............................................................ 29 Step 2: Add CodeCommit to your SSH configuration ............................................................. 29 Next steps ....................................................................................................................... 30 For SSH connections on Linux, OS X, or Unix ............................................................................... 30 Step 1: Initial configuration for CodeCommit ....................................................................... 30 Step 2: Install Git ............................................................................................................. 31 Step 3: Configure credentials on Linux, OS X, or Unix ............................................................ 31 Step 4: Connect to the CodeCommit console and clone the repository ..................................... 34 Next steps ....................................................................................................................... 35 For SSH connections on Windows ............................................................................................... 35 Step 1: Initial configuration for CodeCommit ....................................................................... 35 Step 2: Install Git ............................................................................................................. 36 Step 3: Set up the public and private keys for Git and CodeCommit ........................................ 36 Step 4: Connect to the CodeCommit console and clone the repository ..................................... 39 Next steps ....................................................................................................................... 39 For HTTPS connections on Linux, OS X, or Unix with the Amazon CLI credential helper ...................... 40 Step 1: Initial configuration for CodeCommit ....................................................................... 40 Step 2: Install Git ............................................................................................................. 42 Step 3: Set up the credential helper ................................................................................... 43 Step 4: Connect to the CodeCommit console and clone the repository ..................................... 44 Next steps ....................................................................................................................... 45 For HTTPS connections on Windows with the Amazon CLI credential helper ..................................... 45 Step 1: Initial configuration for CodeCommit ....................................................................... 45 Step 2: Install Git ............................................................................................................. 48 Step 3: Set up the credential helper ................................................................................... 48 API Version 2015-04-13 iii Amazon CodeCommit User Guide Step 4: Connect to the CodeCommit console and clone the repository ..................................... 49 Next steps ....................................................................................................................... 50 Getting started ................................................................................................................................ 51 Getting started with CodeCommit .............................................................................................. 51 Prerequisites .................................................................................................................... 52 Step 1: Create a CodeCommit repository ............................................................................. 53 Step 2: Add files to your repository .................................................................................... 54 Step 3: Browse the contents of your repository .................................................................... 56 Step 4: Create and collaborate on a pull request .................................................................. 59 Step 5: Clean up .............................................................................................................. 63 Step 6: Next steps ............................................................................................................ 64 Getting started with Git and CodeCommit ................................................................................... 64 Step 1: Create a CodeCommit repository ............................................................................. 65 Step 2: Create a local repo ................................................................................................ 66 Step 3: Create your first commit ........................................................................................ 67 Step 4: Push your first commit ........................................................................................... 68 Step 5: Share the CodeCommit repository and push and pull another commit .......................... 68 Step 6: Create and share a branch ...................................................................................... 70 Step 7: Create and share a tag ........................................................................................... 71 Step 8: Set up access permissions ...................................................................................... 72 Step 9: Clean up .............................................................................................................. 74 Product and service integrations .......................................................................................................