Although AWS CodeCommit supports the common Git HTTPS and SSH connection protocols, the details may be a little peculiar and the Upward configuration for AWS CodeCommit will depend on which connection protocol you want to use when connecting to the AWS CodeCommit repository and the operating system used, as usual:
If you have not created AWS CodeCommit repositories, [...] then the following list may help you decide which type of connection to establish for.
Https Using HTTPS connections, you enable Git to use a cryptographically signed version of your IAM user credentials or Amazon EC2 instance role whenever Git requires AWS authentication to interact with repositories in AWS CodeCommit. To do this, you configure the credential assistant for Git on the local computer . a helper assistant is included in the AWS CLI for Linux, OS X, or Unix, and is included as part of the AWS AWS SDK for .NET for Windows systems. [...]
Ssh . Using SSH connections, you create public and private key files on your local machine that Git and AWS CodeCommit use for SSH authentication. Associate a public key with an IAM user . You store the private key on the local machine. Because SSH requires manually creating and managing public and private key files, you can find HTTPS simpler and easier to use with AWS CodeCommit.
[emphasis mine]
The two underlined snippets highlight minor but significant differences in using the connection protocol with most other hosted Git providers, such as Bitbucket or GitHub .
Unlike the AWS recommendation, I personally find setting up the mentioned credential helper for HTTPS is more active than just adding my public SSH keys to your AWS IAM user (step 5.) , after all, I use them for Git everywhere - it depends on what you are used to, and personal preference, of course.
- An important aspect to consider when using SSH on Windows (e.g. with SourceTree, see below) is that you need to insert the SSH key identifier in the cloning URL:
git clone ssh:// Your-SSH-Key-ID@git-codecommit.us-east-1.amazonaws.com /v1/repos/MyDemoRepo my-demo-repo
General GUI Client
Any sufficiently open / general client for Git that supports SSH should be able to use AWS CodeCommit one at a time (regardless of whether the client is a GUI or CLI), although usability and versatility vary.
A popular GUI client that well supports Bitbucket, GitHub, and most other public Git providers, including AWS CodeCommit, is the free Atlasian Git and the Mercurial client for Windows or Mac, SourceTree .
- Please note that unlike SourceTree, GitHub Desktop does not seem to support direct connection to any Git provider other than GitHub itself at this stage (at least it seems possible to add any local repository that has previously been cloned through some other customer, though).