Access CodeCommit/Git via AWS Identity Center
Pre-requisites
- Ensure your SSO User has CodeCommit access.
- You should have GitBash CLI installed on your machine.
- Able to install Python preferably 3.12 version.
- Able to install other software such as
git-remote-codecommit
.
Setup AWS Profile
The second main feature we want to enable is AWS SSO login from the AWS Command Line Interface (AWS CLI) on our local machine.
aws configure sso
SSO start URL [None]: https://<sso-name>.awsapps.com/start/#
SSO region [None]:us-east-1
You will be redirected to your default browser. Or copy the link provided in your browser and ensure the code provided matches what is shown in CLI.
In case you have access to more than 1 account, when you return to the CLI, you must choose your account.
There are 2 AWS accounts available to you.
> AdministratorAccess, <email> (<Account1>)
> AdministratorAccess, <email2> (Account2)
Choose the account with your CodeCommit repository.
Next, you see the permissions sets available to you in the account you just picked.
You now see the options for the profile you’re creating for these AWS SSO permissions:
CLI default client Region [None]: us-east-1<ENTER>
CLI default output format [None]: json<ENTER>
CLI profile name [<Account1>-Developer]: Dev-profile<ENTER>
Note: In GitBash, if you get an error such as:
http://aws.amazon.com/cli
http://aws.amazon.com/cli
https://asg-infra.awsapps.com/start/#/console?account_id=735360830536&role_name=AdministratorAccess
You can run the command from CMD or another WSL.
Git Bash Setup
Python Installation
To install Python on Git Bash, follow these steps:
-
Download Python:
- Visit the official Python downloads page.
- Choose the latest version of Python for your operating system (Windows) and download the installer.
-
Install Python:
- Run the Installer:
- Locate the downloaded installer file and double-click to run it.
- Customize Installation:
- Check the box that says "Add Python to PATH". This is crucial as it allows you to use Python from the command line.
- Click on "Customize installation" for more options if needed.
- Choose Optional Features:
- You can leave the default options checked. Click "Next".
- Advanced Options:
- Leave the default options or adjust as needed. Click "Install".
- Run the Installer:
-
Verify Python Installation:
- Open Git Bash:
- Type the following command and press Enter:
python --version
- You should see the version of Python that you installed.
-
Install
pip
:-
pip
usually comes bundled with Python, but if it's not available, you can install it manually.curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py -
Verify
pip
Installation:pip --version
-
Installing git-remote-codecommit
To install git-remote-codecommit
in Git Bash:
-
Install with the following code:
pip install git-remote-codecommit
-
For some operating systems, you might need to run:
sudo pip install git-remote-codecommit
-
Clone the code from one of your repositories:
git clone codecommit://<profile name>@<CodeCommit repo name>
Example:
git clone codecommit://AdministratorAccess-735360830536@asg-admin
Reconnect if Session Expired
If your SSO session expires, follow these steps to reconnect:
-
Run the following command in Git Bash or another WSL:
aws sso login --sso-session <session name>
-
If you have forgotten the session name, you can find it in
C:\Users\<UserName>\.aws\config
. -
Follow the steps where a URL will open and accept as shown.
GitHub Desktop Setup
- Ensure
git-remote-codecommit
is installed in Git Bash CLI as described above. - Follow the instructions provided to use GitHub Desktop.
Visual Studio Code Setup
- Ensure
git-remote-codecommit
is installed in Git Bash CLI as described above. - Follow the provided highlights.
Ready to take your cloud infrastructure to the next level? Please reach out to us Contact Us