AWS CodeCommit 리포지토리에 연결 - AWS CodeCommit
CodeCommit 리포지토리에 연결하기 위한 사전 조건리포지토리를 복제하여 CodeCommit 리포지토리에 연결로컬 리포지토리를 CodeCommit 리포지토리에 연결

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

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

AWS CodeCommit 리포지토리에 연결

CodeCommit 리포지토리에 처음으로 연결하는 경우 일반적으로 리포지토리의 콘텐츠를 로컬 시스템에 복제합니다. CodeCommit 콘솔에서 직접 리포지토리에 파일을 추가하고 편집할 수도 있습니다. 또는 로컬 리포지토리가 이미 있는 경우 CodeCommit 리포지토리를 원격으로 추가할 수 있습니다. 이 주제에서는 CodeCommit 리포지토리에 대한 연결 지침을 제공합니다. 기존 리포지토리를 CodeCommit으로 마이그레이션하려면 CodeCommit으로 마이그레이션 단원을 참조하세요.

참고

사용량에 따라, 리포지토리를 생성하거나 액세스하는 것에 대한 비용이 부과될 수 있습니다. 자세한 내용은 CodeCommit 제품 정보 페이지에서 요금을 참조하세요.

CodeCommit 리포지토리에 연결하기 위한 사전 조건

CodeCommit 리포지토리를 복제하거나 로컬 리포지토리를 CodeCommit 리포지토리에 연결하기 전에 다음을 수행합니다.

  • CodeCommit에 연결하는 데 필요한 소프트웨어 및 설정을 사용하여 로컬 컴퓨터를 구성해야 합니다. 여기에는 Git의 설치 및 구성이 포함됩니다. 자세한 내용은 설정 및 Git 및 시작하기 AWS CodeCommit 단원을 참조하세요.

  • 연결하고 싶은 CodeCommit 리포지토리의 복제 URL이 있어야 합니다. 자세한 내용은 리포지토리 세부 정보 보기 단원을 참조하십시오.

    CodeCommit 리포지토리를 아직 생성하지 않은 경우에는 리포지토리 생성의 지침을 따르고 CodeCommit 리포지토리의 복제 URL을 복사한 다음 이 페이지로 돌아옵니다.

    CodeCommit 리포지토리가 있지만 이름을 모르는 경우에는 리포지토리 세부 정보 보기의 지침을 따릅니다.

  • 연결을 원하는 CodeCommit 리포지토리의 로컬 복사본을 저장하려면 로컬 시스템에 저장 공간이 있어야 합니다. (CodeCommit 리포지토리의 이 로컬 복사본을 로컬 리포지토리라고 합니다.) 해당 위치로 전환하여 그 곳에서 Git 명령을 실행합니다. 예를 들어, 테스트 목적으로 임시 복제를 만들려면 /tmp(Linux, macOS, Unix) 또는 c:\temp(Windows)를 사용할 수 있습니다. 이는 이러한 예에서 사용되는 디렉터리 경로입니다.

    참고

    원하는 디렉터리를 사용할 수 있습니다. 장기적인 용도로 리포지토리를 복제하는 경우 작업 디렉터리에서 복제물을 생성해 보되 임시 파일용으로는 생성하지 마시기 바랍니다. /tmp 또는 c:\temp와 다른 디렉터리를 사용하는 경우 다음 지침을 따를 때 여기의 디렉터리 대신에 해당 디렉터리를 사용해야 합니다.

리포지토리를 복제하여 CodeCommit 리포지토리에 연결

로컬 리포지토리가 아직 없는 경우 이 절차의 단계에 따라 CodeCommit 리포지토리를 로컬 시스템에 복제합니다.

  1. 설정 을 포함한 사전 필수 단계를 완료합니다.

    중요

    설정을 완료하지 않았으면 리포지토리에 연결하거나 리포지토리를 복제할 수 없습니다.

  2. /tmp 디렉터리 또는 c:\temp 디렉터리에서 Git을 사용하여 clone 명령을 실행합니다. 다음 예제는 미국 동부(오하이오) 리전에서 MyDemoRepo라는 리포지토리를 복제하는 방법을 보여 줍니다.

    Git 보안 인증 정보 또는 AWS CLI에 포함된 보안 인증 도우미를 사용하는 HTTPS의 경우에는 다음과 같이 합니다.

    git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    기본 프로파일과 AWS 리전 이 AWS CLI에 구성되어 있다고 가정하며 git-remote-codecommit를 사용하는 HTTPS의 경우에는 다음과 같이 합니다.

    git clone codecommit://MyDemoRepo my-demo-repo

    SSH의 경우에는 다음과 같이 합니다.

    git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    이 예제에서 git-codecommit.us-east-2.amazonaws.com은 리포지토리가 있는 미국 동부(오하이오) 리전에 대한 Git 연결 지점이고, MyDemoRepo는 CodeCommit 리포지토리의 이름을 나타내며, my-demo-repo는 /tmp 디렉터리 또는 c:\temp 디렉터리에 Git이 생성하는 디렉터리의 이름을 나타냅니다. CodeCommit을 AWS 리전 지원하는와 이에 대한 Git 연결에 대한 자세한 내용은 섹션을 AWS 리전참조하세요리전 및 Git 연결 엔드포인트.

    참고

    Windows 운영 체제에서 SSH를 사용하여 리포지토리를 복제할 경우 다음과 같이 SSH 키 ID를 연결 문자열에 추가해야 할 수 있습니다.

    git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

    자세한 내용은 Windows에서 SSH 연결 및 문제 해결 단원을 참조하세요.

    Git에서 디렉터리를 생성한 후 CodeCommit 리포지토리의 복사본을 새로 생성된 디렉터리로 풀다운합니다.

    CodeCommit 리포지토리가 새 리포지토리이거나 비어 있는 경우 빈 리포지토리를 복제하고 있다는 메시지가 표시됩니다. 이는 예상된 동작입니다.

    참고

    Git에서 CodeCommit 리포지토리를 찾을 수 없거나 CodeCommit 리포지토리에 연결할 권한이 없다는 오류가 표시되는 경우, 사전 조건(IAM 사용자에게 권한 할당, 로컬 시스템에서 Git 및 CodeCommit에 대한 IAM 사용자 보안 인증 정보 설정 등)을 완료했는지 확인합니다. 또한 올바른 리포지토리 이름을 지정했는지 확인합니다.

로컬 리포지토리를 CodeCommit 리포지토리에 성공적으로 연결한 후에는 로컬 리포지토리에서 Git 명령을 실행하여 커밋, 분기 및 태그를 생성한 다음 CodeCommit 리포지토리를 대상으로 푸시하거나 풀할 수 있습니다.

로컬 리포지토리를 CodeCommit 리포지토리에 연결

로컬 리포지토리가 이미 있고 CodeCommit 리포지토리를 원격 리포지토리로 추가하려면, 다음 단계를 완료합니다. 원격 리포지토리가 이미 있고 커밋을 CodeCommit 및 다른 원격 리포지토리에 푸시하려면, 두 리포지토리로 커밋 푸시의 단계를 따릅니다.

  1. 사전 조건을 완료합니다.

  2. 명령 프롬프트 또는 터미널에서 로컬 리포지토리 디렉터리로 전환한 다음 git remote add 명령을 실행하여 CodeCommit 리포지토리를 로컬 리포지토리에 대한 원격 리포지토리로 추가합니다.

    예를 들어, 다음 명령은 origin라는 원격 리포지토리를 ‘https://git-codecommit.us-east- 2.amazonaws.com/v1/repos/MyDemoRepo:’에 추가합니다.

    HTTPS의 경우에는 다음과 같이 합니다.

    git remote add origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    SSH의 경우에는 다음과 같이 합니다.

    git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

    이 명령은 아무 것도 반환하지 않습니다.

  3. CodeCommit 리포지토리를 로컬 리포지토리에 대해 원격으로 추가했는지 확인하려면 git remote -v 명령을 실행하여 다음과 유사한 출력이 생성되어야 합니다.

    HTTPS의 경우에는 다음과 같이 합니다.

    origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)      
origin  https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

    SSH의 경우에는 다음과 같이 합니다.

    origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (fetch)       
origin  ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo (push)

로컬 리포지토리를 CodeCommit 리포지토리에 성공적으로 연결한 후에는 로컬 리포지토리에서 Git 명령을 실행하여 커밋, 분기 및 태그를 생성한 다음 CodeCommit 리포지토리를 대상으로 푸시하거나 풀할 수 있습니다.