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

AWS CodeCommit 는 더 이상 신규 고객이 사용할 수 없습니다. AWS CodeCommit 의 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세히 알아보기

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

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

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

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

참고

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

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

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

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

참고

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 and CodeCommit에서 문제가 발생하면의 정보를 검토하세요문제 해결.

1단계: CodeCommit의 초기 구성

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

CodeCommit에 액세스하기 위한 IAM 사용자를 생성하고 구성하려면
  1. http://aws.amazon.com에서 가입을 선택하여 Amazon Web Services 계정을 만듭니다.

  2. Amazon Web Services 계정에서 IAM 사용자를 생성하거나 기존 사용자를 사용합니다. 액세스 키 ID와 해당 IAM 사용자와 연결된 보안 액세스 키가 있는지 확인합니다. 자세한 내용은 Amazon Web Services 계정에서 IAM 사용자 생성을 참조하세요.

    참고

    CodeCommit 는 필수입니다 AWS Key Management Service. 기존 IAM 사용자를 사용하는 경우 CodeCommit에서 요구하는 AWS KMS 작업을 명시적으로 거부하는 정책이 사용자에게 연결되어 있지 않은지 확인합니다. 자세한 내용은 AWS KMS 및 암호화 단원을 참조하십시오.

  3. 에 로그인 AWS Management Console 하고 IAM에서 https://console.aws.amazon.com/iam/ 콘솔을 엽니다.

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

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

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

  7. 정책 목록에서 AWSCodeCommitPowerUser 액세스에 대한 Word 또는 다른 관리 CodeCommit 정책을 선택합니다. 자세한 내용은 AWS CodeCommit 관리형 정책 단원을 참조하십시오.

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

    CodeCommit 관리형 정책 및 다른 그룹 및 사용자와 리포지토리에 대한 액세스 공유에 대한 자세한 내용은 리포지토리 공유 및 섹션을 참조하세요AWS CodeCommit에 대한 인증 및 액세스 제어.

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

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

    참고

    CodeCommit 는 AWS CLI 버전 1.7.38 이상에서만 작동합니다. 가장 좋은 방법은를 설치하거나 사용 가능한 최신 버전으로 업그레이드 AWS CLI 하는 것입니다. 설치 AWS CLI 한 버전을 확인하려면 aws --version 명령을 실행합니다.

    이전 버전의 AWS CLI 를 최신 버전으로 업그레이드하려면 설치를 참조하세요 AWS Command Line Interface.

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

    aws codecommit help

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

  3. 다음과 같이 configure 명령을 사용하여 프로필 AWS CLI 로를 구성합니다.

    aws configure

    메시지가 표시되면 Word와 함께 사용할 IAM 사용자의 액세스 AWS 키와 AWS 보안 액세스 키를 지정합니다 CodeCommit. 또한와 같이 리포지토리가 있는 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 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 연결 엔드포인트. IAM, 액세스 키 및 보안 키에 대한 자세한 내용은 자격 증명을 어떻게 얻나요? IAM 사용자용 액세스 키 관리를 참조하세요. AWS CLI 및 프로파일에 대한 자세한 내용은 명명된 프로파일을 참조하세요.

2단계: Install git-remote-codecommit

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

Install 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
  2. 성공 메시지가 나타날 때까지 설치 프로세스를 모니터링합니다.

3단계: CodeCommit 콘솔에 연결하고 리포지토리 복제

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

a CodeCommit 리포지토리에 연결하려면
  1. https://console.aws.amazon.com/codesuite/ codecommit/home에서 CodeCommit 콘솔을 엽니다.

  2. 리전 선택기에서 리포지토리가 생성된 AWS 리전 를 선택합니다. 리포지토리는에 따라 다릅니다 AWS 리전. 자세한 내용은 리전 및 Git 연결 엔드포인트 단원을 참조하십시오.

  3. 목록에서 연결하려는 리포지토리를 찾아서 선택합니다. URL 복제를 선택한 다음 리포지토리를 복제하거나 리포지토리에 연결할 때 사용할 프로토콜을 선택합니다. 이렇게 하면 복제본 URL가 복사됩니다.

    • URL HTTPS 사용자 또는에 포함된 보안 인증 도우미와 함께 Git 보안 인증을 사용하는 경우 IAM를 복사합니다 AWS CLI.

    • 로컬 컴퓨터에서 git-remote-codecommit 명령을 사용하는 경우 HTTPS(GRC) URL를 복사합니다.

    • SSH 사용자와 함께 URL SSH 퍼블릭/프라이빗 키 페어를 사용하는 경우 IAM 복사합니다.

    참고

    리포지토리 목록 대신 시작 페이지가 표시되면 로그인 AWS 리전 한에 AWS 계정과 연결된 리포지토리가 없는 것입니다. 리포지토리를 만들려면 AWS CodeCommit 리포지토리 생성을(를) 참조하거나 Git 및 CodeCommit 시작하기 자습서의 다음 단계를 따릅니다.

  4. 터미널 또는 명령 프롬프트에서 git clone 명령을 사용하여 리포지토리를 복제합니다. 명명된 AWS CLI 프로필을 생성한 경우 복사한 HTTPS git-remote-codecommitWord 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

다음 단계

사전 필수 단계를 완료했습니다. 의 단계에 따라 use CodeCommit시작하기: CodeCommit 를 시작합니다.

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