기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# git-remote-codecommit을 AWS CodeCommit 사용하여에 대한 HTTPS 연결을 위한 설정 단계
<a name="setting-up-git-remote-codecommit"></a>

루트 계정, 페더레이션 액세스 또는 임시 보안 인증 정보를 사용하여 CodeCommit에 연결하려는 경우, **git-remote-codecommit**을 사용하여 액세스를 설정해야 합니다. 이 유틸리티는 Git를 확장하여 CodeCommit 리포지토리에서 코드를 푸시하고 풀하는 간단한 방법을 제공합니다. 페더레이션 액세스, 자격 증명 공급자 및 임시 보안 인증 정보로 이루어진 연결을 지원하는 데 권장되는 방법입니다. 페더레이션 자격 증명 권한을 부여하려면 역할을 생성하고 해당 역할의 권한을 정의합니다. 페더레이션 자격 증명이 인증되면 역할이 연결되고 역할에 정의된 권한이 부여됩니다. 페더레이션 관련 역할에 대한 자세한 내용은 *IAM 사용 설명서*의 [Create a role for a third-party identity provider (federation)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html)를 참조하세요. IAM Identity Center를 사용하는 경우, 권한 집합을 구성합니다. 인증 후 ID가 액세스할 수 있는 항목을 제어하기 위해 IAM Identity Center는 권한 집합을 IAM의 역할과 연관짓습니다. 권한 세트에 대한 자세한 내용은 *AWS IAM Identity Center 사용 설명서*의 [권한 세트](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)를 참조하세요.

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

**참고**  
일부 IDE는 `git-remote-codecommit`에서 사용하는 복제 URL 형식을 지원하지 않습니다. 원하는 IDE에서 리포지토리를 사용하려면 먼저 로컬 컴퓨터에 리포지토리를 수동으로 복제해야 할 수 있습니다. 자세한 내용은 [git-remote-codecommit 및 문제 해결 AWS CodeCommit](troubleshooting-grc.md) 단원을 참조하십시오.

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

**Topics**
+ [0단계: git-remote-codecommit에 대한 사전 조건 설치](#setting-up-git-remote-codecommit-prereq)
+ [1단계: CodeCommit에 대한 초기 구성](#setting-up-git-remote-codecommit-account)
+ [2단계: git-remote-codecommit 설치](#setting-up-git-remote-codecommit-install)
+ [3단계: CodeCommit 콘솔 연결 및 리포지토리 복제](#setting-up-git-remote-codecommit-connect-console)
+ [다음 단계](#setting-up-git-remote-codecommit-next-step)

## 0단계: git-remote-codecommit에 대한 사전 조건 설치
<a name="setting-up-git-remote-codecommit-prereq"></a>

**git-remote-codecommit**를 사용하려면 먼저 로컬 컴퓨터에 몇 가지 사전 조건을 설치해야 합니다. 다음이 포함됩니다.
+ 지원되는 Python 버전 지원되는 Python 버전에 대한 자세한 내용은 [git-remote-codecommit](https://pypi.org/project/git-remote-codecommit/)을 참조하세요.

  git-remote-codecommit 설정 및 사용에 대한 자세한 내용은 [git-remote-codecommit을 AWS CodeCommit 사용하여에 대한 HTTPS 연결을 위한 설정 단계](#setting-up-git-remote-codecommit) 단원을 참조하세요.
+ 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 다운로드](http://git-scm.com/downloads)와 같은 웹 사이트를 권장합니다.

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

## 1단계: CodeCommit에 대한 초기 구성
<a name="setting-up-git-remote-codecommit-account"></a>

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

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

1. [http://aws.amazon.com](https://aws.amazon.com/)에서 **가입**을 선택하여 Amazon Web Services 계정을 만듭니다.

1. Amazon Web Services 계정에서 IAM 사용자를 생성하거나 기존 사용자를 사용합니다. 액세스 키 ID가 있고 해당 IAM 사용자와 연결된 비밀 액세스 키가 있는지 확인합니다. 자세한 내용은 [Amazon Web Services 계정에서 IAM 사용자 생성하기](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html)를 참조하세요.
**참고**  
CodeCommit에는가 필요합니다 AWS Key Management Service. 기존 IAM 사용자를 사용하는 경우 CodeCommit에 필요한 AWS KMS 작업을 명시적으로 거부하는 사용자에게 연결된 정책이 없는지 확인합니다. 자세한 내용은 [AWS KMS 및 암호화](encryption.md) 단원을 참조하십시오.

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) IAM 콘솔을 엽니다.

1. IAM 콘솔의 탐색 창에서 **사용자**를 선택한 다음 CodeCommit 액세스에 대해 구성할 IAM 사용자를 선택합니다.

1. **권한** 탭에서 **권한 추가**를 선택합니다.

1. **권한 부여**에서 **기존 정책 직접 연결**을 선택합니다.

1. 정책 목록에서, CodeCommit 액세스에 대한 **AWSCodeCommitPowerUser** 또는 다른 관리형 정책을 선택합니다. 자세한 내용은 [AWS CodeCommit에 대한 관리형 정책](security-iam-awsmanpol.md) 단원을 참조하십시오.

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

    CodeCommit 관리형 정책, 그리고 리포지토리에 대한 액세스를 다른 그룹 및 사용자와 공유하는 방법에 대해 자세히 알아보려면 [리포지토리 공유](how-to-share-repository.md), [에 대한 인증 및 액세스 제어 AWS CodeCommit](auth-and-access-control.md) 섹션을 참조하세요.

**를 설치하고 구성하려면 AWS CLI**

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

   자세한 내용은 [AWS 명령줄 인터페이스 설정 단원을](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) 참조하십시오.
**참고**  
CodeCommit은 AWS CLI 버전 1.7.38 이상에서만 작동합니다. 가장 좋은 방법은를 설치하거나 사용 가능한 최신 버전으로 업그레이드 AWS CLI 하는 것입니다. 설치 AWS CLI 한 버전을 확인하려면 **aws --version** 명령을 실행합니다.  
의 이전 버전을 AWS CLI 최신 버전으로 업그레이드하려면 [설치를 참조하세요 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).

1. 이 명령을 실행하여에 대한 CodeCommit 명령 AWS CLI 이 설치되어 있는지 확인합니다.

   ```
   aws codecommit help
   ```

   이 명령은 CodeCommit 명령 목록을 반환합니다.

1. 다음과 같이 **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참조하세요.
   + [명명된 프로파일](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
   + [에서 IAM 역할 사용 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html)
   + [설정 명령](https://docs.aws.amazon.com/cli/latest/reference/set.html)
   + [교체 자격 증명을 사용하여 AWS CodeCommit 리포지토리에 연결](temporary-access.md)

   리포지토리 또는 다른의 리소스에 연결하려면 기본 리전 이름으로 AWS CLI 를 재구성 AWS 리전해야 합니다. 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 연결 엔드포인트](regions.md). IAM, 액세스 키, 비밀 키에 대한 자세한 내용을 확인하려면 [보안 인증 정보 얻는 방법](https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html#IAM_SecurityCredentials) 및 [IAM 사용자의 액세스 키 관리](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html)를 참조하세요. AWS CLI 및 프로파일에 대한 자세한 내용은 [명명된 프로파일을 참조하세요](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).

## 2단계: git-remote-codecommit 설치
<a name="setting-up-git-remote-codecommit-install"></a>

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

**git-remote-codecommit를 설치하려면**

1. 터미널 또는 명령줄에서 다음 명령을 실행합니다.

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

   ```
   sudo pip install git-remote-codecommit
   ```
Windows를 실행하는 컴퓨터는 다음과 같습니다.  

   ```
   pip install --user git-remote-codecommit
   ```

1. 성공 메시지가 나타날 때까지 설치 프로세스를 모니터링합니다.

## 3단계: CodeCommit 콘솔 연결 및 리포지토리 복제
<a name="setting-up-git-remote-codecommit-connect-console"></a>

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

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

1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.

1. 리전 선택기에서 리포지토리가 생성된 AWS 리전 를 선택합니다. 리포지토리는에 고유합니다 AWS 리전. 자세한 내용은 [리전 및 Git 연결 엔드포인트](regions.md) 단원을 참조하십시오.

1. 목록에서 연결하려는 리포지토리를 찾아서 선택합니다. **URL 복제**를 선택한 다음 리포지토리를 복제하거나 연결할 때 사용할 프로토콜을 선택합니다. 이것으로 복제 URL가 복사됩니다.
   + IAM 사용자를 통한 Git 보안 인증 정보를 활용하거나 AWS CLI에 포함된 보안 인증 도우미를 사용하는 경우 HTTPS URL을 복사합니다.
   + 로컬 컴퓨터에서 **git-remote-codecommit** 명령을 사용하는 경우 HTTPS(GRC) URL을 복사합니다.
   + IAM 사용자와 SSH 퍼블릭/프라이빗 키 페어를 사용하는 경우 SSH URL을 복사합니다.
**참고**  
 리포지토리 목록 대신 **시작** 페이지가 표시되면 로그인한에 AWS 계정과 연결된 AWS 리전 리포지토리가 없는 것입니다. 리포지토리를 만들려면 [AWS CodeCommit 리포지토리 생성](how-to-create-repository.md)을(를) 참조하거나 [Git 및 CodeCommit 시작하기](getting-started.md) 자습서의 다음 단계를 따릅니다.

1. 터미널 또는 명령 프롬프트에서 **git clone** 명령을 사용하여 리포지토리를 복제합니다. 명명된 AWS CLI 프로필을 생성한 경우 복사한 HTTPS git-remote-codecommit URL과 프로필 이름을 사용합니다. 프로파일을 지정하지 않으면 명령이 기본 프로파일을 가정합니다. 그러면 명령을 실행한 디렉터리의 하위 디렉터리에 로컬 리포지토리가 생성됩니다. 예를 들어, *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
   ```

## 다음 단계
<a name="setting-up-git-remote-codecommit-next-step"></a>

사전 필수 단계를 완료했습니다. [CodeCommit 시작하기 ](getting-started-cc.md)에 나와 있는 단계에 따라 CodeCommit의 사용을 시작합니다.

첫 커밋을 생성하고 푸시하는 방법에 대해 알아보려면 [에서 커밋 생성 AWS CodeCommit](how-to-create-commit.md) 단원을 참조하세요. Git를 처음 사용하는 경우, [Git에 대해 더 학습하려면 어떻게 해야 하나요?](welcome.md#welcome-get-started-with-git) 및 [Git 및 시작하기 AWS CodeCommit](getting-started.md)의 정보 또한 검토하는 것이 좋습니다.