0단계: git-remote-codecommit에 대한 사전 조건 설치 1단계: CodeCommit에 대한 초기 구성 2단계: git-remote-codecommit 설치 3단계: CodeCommit 콘솔 연결 및 리포지토리 복제 다음 단계

git-remote-codecommit을 사용하여 AWS CodeCommit에 대한 HTTPS 연결을 위한 설정 단계

루트 계정, 페더레이션 액세스 또는 임시 보안 인증 정보를 사용하여 CodeCommit에 연결하려는 경우, git-remote-codecommit을 사용하여 액세스를 설정해야 합니다. 이 유틸리티는 Git를 확장하여 CodeCommit 리포지토리에서 코드를 푸시하고 풀하는 간단한 방법을 제공합니다. 페더레이션 액세스, 자격 증명 공급자 및 임시 보안 인증 정보로 이루어진 연결을 지원하는 데 권장되는 방법입니다. 페더레이션 자격 증명 권한을 부여하려면 역할을 생성하고 해당 역할의 권한을 정의합니다. 페더레이션 자격 증명이 인증되면 역할이 연결되고 역할에 정의된 권한이 부여됩니다. 페더레이션 역할에 대한 자세한 내용은 IAM 사용 설명서의 타사 자격 증명 공급자의 역할 만들기를 참조하세요. IAM Identity Center를 사용하는 경우 권한 집합을 구성합니다. 인증 후 아이덴티티가 액세스할 수 있는 항목을 제어하기 위해 IAM Identity Center는 권한 세트를 IAM의 역할과 연관짓습니다. 권한 세트에 대한 자세한 내용은 AWS IAM Identity Center 사용 설명서의 권한 세트를 참조하세요.

git-remote-codecommit을 IAM 사용자와 함께 사용할 수도 있습니다. 다른 HTTPS 연결 방법과 달리 git-remote-codecommit에서는 사용자에 대한 Git 보인 인증 정보를 설정할 필요가 없습니다.

참고

일부 IDE는 git-remote-codecommit에서 사용하는 복제 URL 형식을 지원하지 않습니다. 원하는 IDE에서 리포지토리를 사용하려면 먼저 로컬 컴퓨터에 리포지토리를 수동으로 복제해야 할 수 있습니다. 자세한 내용은 git-remote-codecommit 및 AWS CodeCommit 문제 해결 섹션을 참조하세요.

이 절차들은 Amazon Web Services 계정이 있고 CodeCommit에 리포지토리를 하나 이상 생성했으며 CodeCommit 리포지토리에 연결할 때 관리형 정책이 있는 IAM 사용자를 사용한다는 가정 하에 작성되었습니다. 연합된 사용자 및 기타 교체 자격 증명 유형에 대한 액세스를 구성하는 방법에 대한 자세한 내용은 교체 보안 인증 정보를 사용하여 AWS CodeCommit 리포지토리에 연결 단원을 참조하십시오.

0단계: git-remote-codecommit에 대한 사전 조건 설치

git-remote-codecommit를 사용하려면 먼저 로컬 컴퓨터에 몇 가지 사전 조건을 설치해야 합니다. 다음이 포함됩니다.

Python(버전 3 이상) 및 해당 패키지 관리자인 pip(아직 설치되지 않은 경우). Python의 최신 버전을 다운로드하고 설치하려면 Python 웹사이트를 방문하십시오.
Git

참고

Windows에서 Python을 설치할 때 경로에 Python을 추가하는 옵션을 선택해야 합니다.

git-remote-codecommit에는 pip 버전 9.0.3 이상이 필요합니다. pip 버전을 확인하려면 터미널 또는 명령줄을 열고 다음 명령을 실행합니다.


pip --version

다음 두 명령을 실행하여 pip 버전을 최신 버전으로 업데이트할 수 있습니다.


curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user

CodeCommit 리포지토리에서 파일과 커및 및 기타 정보를 사용하려면 로컬 시스템에 Git를 설치해야 합니다. CodeCommit은 Git 버전 1.7.9 이상을 지원합니다. Git 버전 2.28에서는 초기 커밋을 위한 브랜드 이름을 구성할 수 있습니다. 최신 버전의 Git를 사용하는 것이 좋습니다.

Git 설치를 위해서는 Git 다운로드와 같은 웹 사이트를 권장합니다.

참고

Git은 계속 개선되며 정기적으로 업데이트되는 플랫폼입니다. 기능 변경에 따라 CodeCommit 사용 방식이 달라지는 경우가 있습니다. Git과 CodeCommit의 특정 버전에서 문제가 발생할 경우 문제 해결의 내용을 검토하세요.

1단계: CodeCommit에 대한 초기 구성

다음 단계에 따라 IAM 사용자를 생성하고, 적절한 정책으로 구성하고, 액세스 키와 보안 키를 얻고, AWS CLI를 설치 및 구성합니다.

CodeCommit에 액세스할 IAM 사용자를 생성 및 구성하려면

http://aws.amazon.com에서 가입을 선택하여 Amazon Web Services 계정을 만드세요.
Amazon Web Services 계정에서 IAM 사용자를 생성하거나 기존 사용자를 사용합니다. 액세스 키 ID가 있고 해당 IAM 사용자와 연결된 비밀 액세스 키가 있는지 확인합니다. 자세한 내용은 Amazon Web Services 계정에서 IAM 사용자 생성하기를 참조하세요.
참고
CodeCommit에는 AWS Key Management Service가 필요합니다. 기존 IAM 사용자를 사용할 경우, CodeCommit에 필요한 AWS KMS 작업을 명시적으로 거부하는 정책이 해당 사용자에게 연결되어 있지 않은지 확인하세요. 자세한 내용은 AWS KMS 및 암호화 섹션을 참조하세요.
AWS Management Console에 로그인하여 https://console.aws.amazon.com/iam/에서 IAM 콘솔을 엽니다.
IAM 콘솔의 탐색 창에서 사용자를 선택한 다음 CodeCommit 액세스에 대해 구성할 IAM 사용자를 선택합니다.
권한 탭에서 권한 추가를 선택합니다.
권한 부여에서 기존 정책 직접 연결을 선택합니다.
정책 목록에서, CodeCommit 액세스에 대한 AWSCodeCommitPowerUser 또는 다른 관리형 정책을 선택합니다. 자세한 내용은 AWS 관리형 정책은 다음과 같습니다. CodeCommit 섹션을 참조하세요.

연결할 정책을 선택한 후 다음: 검토를 선택하여 IAM 사용자에게 연결할 정책의 목록을 검토합니다. 목록이 올바르면 권한 추가를 선택합니다.

CodeCommit 관리형 정책, 그리고 리포지토리에 대한 액세스를 다른 그룹 및 사용자와 공유하는 방법에 대해 자세히 알아보려면 리포지토리 공유, AWS CodeCommit에 대한 인증 및 액세스 제어 섹션을 참조하세요.

AWS CLI를 설치 및 구성하는 방법은 다음과 같습니다.

로컬 컴퓨터에서 AWS CLI를 다운로드하고 설치합니다. 이는 명령줄에서 CodeCommit과 상호 작용하기 위한 사전 조건입니다. AWS CLI 버전 2를 설치하는 것이 좋습니다. 이는 AWS CLI의 최신 메이저 버전이며 모든 최신 기능을 지원합니다. 또한 git-remote-codecommit으로 루트 계정, 페더레이션 액세스 또는 임시 보안 인증 정보 사용하는 것을 지원하는 유일한 AWS CLI 버전입니다.

자세한 내용은 AWS 명령줄 인터페이스로 설정 단원을 참조하십시오.

참고
CodeCommit은 AWS CLI 버전 1.7.38 이상에서만 작동합니다. AWS CLI를 설치하거나 최신 버전으로 업그레이드하는 것이 가장 좋습니다. 설치한 AWS CLI의 버전을 확인하려면 aws --version 명령을 실행합니다.
이전 버전의 AWS CLI를 최신 버전으로 업그레이드하려면 AWS Command Line Interface 설치를 참조하십시오.
이 명령을 실행하여 AWS CLI용 CodeCommit 명령이 설치되었는지 확인합니다.
```
aws codecommit help
```
이 명령은 CodeCommit 명령 목록을 반환합니다.
다음과 같이 configure 명령을 사용하여 AWS CLI를 프로파일로 구성합니다.
```
aws configure
```
메시지가 표시되면, CodeCommit에서 사용할 IAM 사용자의 AWS 액세스 키 및 AWS 비밀 액세스 키를 지정합니다. 또한 리포지토리가 존재하는 AWS 리전(예: us-east-2)도 반드시 지정해야 합니다. 기본 출력 형식을 묻는 메시지가 표시되면 json을 지정합니다. 예를 들어, IAM 사용자의 프로필을 구성하는 경우에는 다음과 같이 합니다.
```
AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter
```
AWS CLI에서 사용할 프로파일 생성 및 구성에 대한 자세한 내용은 다음을 참조하십시오.
다른 AWS 리전에 있는 리포지토리 또는 리소스에 연결하려면 기본 리전 이름을 사용하여 AWS CLI를 다시 구성해야 합니다. CodeCommit에서 지원되는 기본 리전 이름은 다음과 같습니다.
- us-east-2
- us-east-1
- eu-west-1
- us-west-2
- ap-northeast-1
- ap-southeast-1
- ap-southeast-2
- ap-southeast-3
- me-central-1
- eu-central-1
- ap-northeast-2
- sa-east-1
- us-west-1
- eu-west-2
- ap-south-1
- ap-south-1
- ca-central-1
- us-gov-west-1
- us-gov-east-1
- eu-north-1
- ap-east-1
- me-south-1
- cn-north-1
- cn-northwest-1
- eu-south-1
- ap-northeast-3
- af-south-1
- il-central-1
CodeCommit 및 AWS 리전에 대한 자세한 내용은 리전 및 Git 연결 엔드포인트 섹션을 참조하세요. IAM, 액세스 키, 비밀 키에 대한 자세한 내용을 확인하려면 보안 인증 정보 얻는 방법 및 IAM 사용자의 액세스 키 관리를 참조하세요. AWS CLI 및 프로필에 대한 자세한 내용은 명명된 프로필을 참조하세요.

2단계: git-remote-codecommit 설치

다음 단계에 따라 git-remote-codecommit를 설치합니다.

git-remote-codecommit를 설치하려면

터미널 또는 명령줄에서 다음 명령을 실행합니다.
```
pip install git-remote-codecommit
```
참고
운영 체제 및 구성에 따라 사용자는 sudo와 같은 승격된 권한으로 이 명령을 실행해야 하거나, 아니면 --user 파라미터를 사용하여 현재 사용자 계정과 같이 특별한 권한이 필요하지 않은 디렉터리에 설치해야 할 수 있습니다. 예를 들어, Linux, macOS, Unix를 실행하는 컴퓨터는 다음과 같습니다.
```
sudo pip install git-remote-codecommit
```
Windows를 실행하는 컴퓨터는 다음과 같습니다.
```
pip install --user git-remote-codecommit
```
성공 메시지가 나타날 때까지 설치 프로세스를 모니터링합니다.

3단계: CodeCommit 콘솔 연결 및 리포지토리 복제

관리자가 CodeCommit 리포지토리에 git-remote-codecommit과 함께 사용할 복제 URL을 이미 전송한 경우에는 콘솔 연결을 건너뛰고 리포지토리를 직접 복제할 수 있습니다.

CodeCommit 리포지토리에 연결하려면

https://console.aws.amazon.com/codesuite/codecommit/home에서 CodeCommit 콘솔을 엽니다.
리전 선택기에서, 해당 리포지토리를 생성한 AWS 리전을 선택합니다. 각 리포지토리는 하나의 AWS 리전에 국한됩니다. 자세한 내용은 리전 및 Git 연결 엔드포인트 섹션을 참조하세요.
목록에서 연결하려는 리포지토리를 찾아서 선택합니다. URL 복제를 선택한 다음 리포지토리를 복제하거나 연결할 때 사용할 프로토콜을 선택합니다. 그러면 복제 URL을 복사합니다.
- IAM 사용자를 통한 Git 보안 인증 정보를 활용하거나 AWS CLI에 포함된 보안 인증 도우미를 사용하는 경우 HTTPS URL을 복사합니다.
- 로컬 컴퓨터에서 git-remote-codecommit 명령을 사용하는 경우 HTTPS(GRC) URL을 복사합니다.
- IAM 사용자와 SSH 퍼블릭/프라이빗 키 페어를 사용하는 경우 SSH URL을 복사합니다.
참고
리포지토리 목록 대신 시작 페이지가 표시될 경우, 사용자가 로그인한 AWS 리전에 사용자의 AWS 계정과 연결된 리포지토리가 없는 것입니다. 리포지토리를 만들려면 AWS CodeCommit 리포지토리 만들기을(를) 참조하거나 Git 및 CodeCommit 시작하기 자습서의 다음 단계를 따르십시오.
터미널 또는 명령 프롬프트에서 git clone 명령을 사용하여 리포지토리를 복제합니다. 이름이 지정된 프로파일을 생성한 경우 복사한 HTTPS git-remote-codecommit URL과 AWS CLI 프로파일 이름을 사용합니다. 프로파일을 지정하지 않으면 명령이 기본 프로파일을 가정합니다. 그러면 명령을 실행한 디렉터리의 하위 디렉터리에 로컬 리포지토리가 생성됩니다. 예를 들어, MyDemoRepo라는 리포지토리를 my-demo-repo라는 로컬 리포지토리에 복제하려면 다음과 같이 합니다.
```
git clone codecommit://MyDemoRepo my-demo-repo
```
CodeCommitProfile이라는 프로파일을 사용하여 동일한 리포지토리를 복제하려면:
```
git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo
```
프로필에 구성된 것과 다른 AWS 리전에 리포지토리를 복제하려면 AWS 리전 이름을 포함합니다. 예:
```
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
```

다음 단계

사전 필수 단계를 완료했습니다. 시작하기: CodeCommit 에 나와 있는 단계에 따라 CodeCommit의 사용을 시작합니다.

첫 커밋을 생성하고 푸시하는 방법에 대해 알아보려면 에서 커밋 만들기 AWS CodeCommit 단원을 참조하십시오. Git를 처음 사용하는 경우, Git에 대해 더 학습하려면 어떻게 해야 하나요? 및 Git 및 AWS CodeCommit 시작하기의 정보를 검토하는 것이 좋습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Git 보안 인증 정보를 사용하는 HTTPS 사용자의 경우

개발 도구에서 연결