README
¶
git-remote-codecommit
A git-remote-helper that supports basic push and pull functionality when working with CodeCommit repositories using the AWS codecommit protocol. When installed the helper acts as a transparent proxy, converting the codecommit protocol into AWS V4 authenticated HTTPS requests. Removing the need for dedicated AWS HTTPS credentials.
Install
Binary downloads can be found on the Releases page. Unpack the git-remote-codecommit binary and add it to your PATH.
Homebrew
To use Homebrew:
brew tap gembaadvantage/tap
brew install git-remote-codecommit
Scoop
To use Scoop:
scoop install git-remote-codecommit
Quick Start
Clone the repository using your standard git syntax, but provide the clone URL using the codecommit protocol format of:
codecommit::<REGION>://<PROFILE>@<REPOSITORY>
$ git clone codecommit::eu-west-1://repository
Cloning into 'repository'...
remote: Counting objects: 167, done.
Receiving objects: 100% (167/167), 96.07 KiB | 634.00 KiB/s, done.
Resolving deltas: 100% (31/31), done.
Both git pull and git push operations will behave as normal.
AWS Named Profile
Depending on your chosen authentication mechansim, you may need to provide an AWS named profile to authenticate with CodeCommit. To do this, provide the named profile, suffixed with an @, before the repository name.
git clone codecommit::eu-west-1://profile@repository
Directories