Git 리포지토리를 AWS CodeCommit으로 마이그레이션

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에 로그인하고 https://console.aws.amazon.com/iam/에서 IAM 콘솔을 엽니다.

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

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

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

7. 정책 목록에서, CodeCommit 액세스에 대한 AWSCodeCommitPowerUser 또는 다른 관리형 정책을 선택합니다. 자세한 내용은 AWS 에 대한 관리형 정책 CodeCommit 섹션을 참조하세요.

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

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

AWS CLI 설치 및 구성

1. 로컬 컴퓨터에서 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 설치를 참조하세요.

2. 이 명령을 실행하여 AWS CLI용 CodeCommit 명령이 설치되었는지 확인합니다.

   aws codecommit help

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

3. 다음과 같이 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 CLI에서 IAM 역할 사용

   • 설정 명령

   • 교체 보안 인증 정보를 사용하여 AWS CodeCommit 리포지토리에 연결

   다른 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 및 프로필에 대한 자세한 내용은 명명된 프로필을 참조하세요.

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

2. 리전 선택기에서, 리포지토리를 만들 AWS 리전을 선택합니다. 자세한 내용은 리전 및 Git 연결 엔드포인트 섹션을 참조하세요.

3. 리포지토리 페이지에서 리포지토리 생성을 선택합니다.

4. 리포지토리 생성 페이지의 리포지토리 이름에 리포지토리 이름을 입력합니다.

   참고

   리포지토리 이름은 대소문자를 구분합니다. 이 이름은 Amazon Web Services 계정이 속한 AWS 리전에서 고유해야 합니다.

5. (선택 사항) 설명에 리포지토리에 대한 설명을 입력합니다. 그러면 사용자들이 리포지토리의 용도를 식별하는 데 도움이 됩니다.

   참고

   설명 필드에는 콘솔의 마크다운이 표시되며, 모든 HTML 문자와 유효한 Unicode 문자를 모두 사용할 수 있습니다. GetRepository 또는 BatchGetRepositories API를 사용하는 애플리케이션 개발자인 경우 웹 브라우저에 리포지토리 설명 필드를 표시하려면 CodeCommit API 참조를 참조하십시오.

6. (선택 사항) 태그 추가를 선택하여 하나 이상의 리포지토리 태그(AWS 리소스를 구성하고 관리하는 것을 도와주는 사용자 지정 속성 레이블)를 리포지토리에 추가합니다. 자세한 내용은 에서 리포지토리 태그 지정 AWS CodeCommit 섹션을 참조하세요.

7. (선택 사항) 추가 구성을 확장하여 이 리포지토리의 데이터를 암호화하고 복호화하는 데 기본 AWS 관리형 키를 사용할지 또는 자체 고객 관리형 키를 사용할지 지정합니다. 자체 고객 관리형 키를 사용하기로 선택한 경우, 리포지토리를 만드는 AWS 리전에서 해당 키를 사용할 수 있는지 그리고 해당 키가 활성 상태인지 확인해야 합니다. 자세한 내용은 AWS CodeCommit 리포지토리에 대한 AWS Key Management Service 및 암호화 섹션을 참조하세요.

8. (선택 사항) 이 리포지토리에 Java나 Python 코드가 들어가고 CodeGuru Reviewer로 해당 코드를 분석하려 한다면, Java 및 Python용 Amazon CodeGuru Reviewer 활성화를 선택합니다. CodeGuru Reviewer는 다양한 기계 학습 모델을 사용하여 풀 요청의 코드 결함을 찾아내고 개선점과 해결책을 제안합니다. 자세한 내용은 Amazon CodeGuru Reviewer 사용 안내서를 참조하세요.

9. Create(생성)를 선택합니다.

1. 로컬 컴퓨터의 터미널 또는 명령 프롬프트에서 --mirror 옵션과 함께 git clone 명령을 실행하여 원격 리포지토리의 사본을 새 폴더 aws-codecommit-demo로 복제합니다. 이것은 마이그레션 전용 베어 리포지토리입니다. CodeCommit의 마이그레이션된 리포지토리와 상호 작용하기 위한 로컬 리포지토리가 아닙니다. 나중에 CodeCommit으로의 마이그레이션이 완료된 후에 생성할 수 있습니다.

   다음 예제는 GitHub(https://github.com/awslabs/aws-demo-php-simple-app.git)에서 호스팅되는 데모 애플리케이션을 디렉터리 aws-codecommit-demo의 로컬 리포지토리로 복제합니다.

   git clone --mirror https://github.com/awslabs/aws-demo-php-simple-app.git aws-codecommit-demo

2. 디렉터리를 복제를 생성한 디렉터리로 변경합니다.

   cd aws-codecommit-demo

3. URL과 대상 CodeCommit 리포지토리의 이름, --all 옵션을 지정하여 git push 명령을 실행합니다. (여기서 URL은 1단계: CodeCommit 리포지토리 생성에서 복사해 놓은 것입니다.)

   예를 들어 리포지토리의 이름을 MyClonedRepository로 짓고 HTTPS를 사용하도록 설정된 경우, 다음 명령을 실행합니다.

   git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --all

   참고

   --all 옵션은 리포지토리의 브랜치만을 모두 푸시합니다. 태그와 같은 다른 참조는 푸시하지 않습니다. 태그를 푸시하려면 초기 푸시가 완료될 때까지 기다렸다가 이번에는 --tags 옵션을 사용하여 다음과 같이 다시 푸시합니다.

   git push ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --tags

   자세한 내용은 Git 웹 사이트의 Git push 단원을 참조하십시오. 대용량 리포지토리를 푸시, 특히 모든 참조를 한 번에 푸시하는 방법(예: --mirror 옵션 사용)에 대한 자세한 내용은 리포지토리를 증분으로 마이그레이션하기 섹션을 참조하세요.

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

2. 리포지토리에서 해당 리포지토리의 이름을 선택합니다(예: MyClonedRepository).

3. 해당 리포지토리에 있는 파일에서 브랜치, 복제 URL, 설정 등을 조회합니다.

   

리포지토리에 대한 고객 관리형 정책 생성

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

2. 대시보드 탐색 영역에서 정책을 선택한 다음 정책 생성을 선택합니다.

3. 정책 생성 페이지에서 관리형 정책 가져오기를 선택합니다.

4. 관리형 정책 가져오기 페이지의 필터 정책에서 AWSCodeCommitPowerUser를 입력합니다. 정책 이름 옆에 있는 버튼을 선택한 다음 가져오기를 선택합니다.

5. 정책 생성 페이지에서 JSON을 선택합니다. 다음과 같이 CodeCommit 작업에 대한 Resource 라인의 ‘*’ 부분을 CodeCommit 리포지토리의 Amazon 리소스 이름(ARN)으로 바꿉니다.

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo"
    ]

   작은 정보

   CodeCommit 리포지토리의 ARN을 찾으려면, CodeCommit 콘솔로 이동하여 목록에서 리포지토리 이름을 선택한 다음 설정을 선택합니다. 자세한 내용은 리포지토리 세부 정보 보기 섹션을 참조하세요.

   이 정책을 둘 이상의 리포지토리에 적용하려면, ARN을 지정하여 각 리포지토리를 리소스로 추가합니다. 다음과 같이 각 리소스 명령문 사이에 쉼표를 넣습니다.

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
    "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo"
    ]

   편집이 완료되면 정책 검토를 선택합니다.

6. 정책 검토 페이지의 이름에 정책의 새 이름을 입력합니다(예: AWSCodeCommitPowerUser-MyDemoRepo). 선택 사항으로 이 정책에 대한 설명을 제공할 수 있습니다.

7. 정책 생성을 선택합니다.

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

2. 대시보드 탐색 영역에서 그룹을 선택한 다음 새 그룹 생성을 선택합니다.

3. 그룹 이름 설정 페이지의 그룹 이름에 그룹 이름(예: MyDemoRepoGroup)을 입력한 다음 다음 단계를 선택합니다. 그룹 이름에 리포지토리 이름을 포함시키는 것을 고려해 보세요.

   참고

   이 이름은 Amazon Web Services 계정 전체에서 고유해야 합니다.

4. 이전 섹션에서 생성한 고객 관리형 정책(예: AWSCodeCommitPowerUser-MyDemoRepo) 옆의 상자를 선택합니다.

5. 검토 페이지에서 그룹 생성을 선택합니다. IAM은 지정된 정책이 이미 연결된 상태로 이 그룹을 생성합니다. 해당 그룹이 Amazon Web Services 계정에 연결된 그룹 목록에 나타납니다.

6. 목록에서 그룹을 선택합니다.

7. 그룹 요약 페이지에서 사용자 탭을 선택한 다음 그룹에 사용자 추가를 선택합니다. Amazon Web Services 계정과 연결된 모든 사용자를 표시하는 목록에서, CodeCommit 리포지토리에 대한 액세스를 허용할 사용자 옆의 상자를 선택한 다음 사용자 추가를 선택합니다.

   작은 정보

   검색 상자를 사용하여 이름별로 사용자를 빠르게 찾을 수 있습니다.

8. 사용자를 추가했으면 IAM 콘솔을 닫습니다.

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

2. 리전 선택기에서, 해당 리포지토리를 생성한 AWS 리전을 선택합니다. 각 리포지토리는 하나의 AWS 리전에 국한됩니다. 자세한 내용은 리전 및 Git 연결 엔드포인트 섹션을 참조하세요.

3. 리포지토리 페이지에서 공유할 리포지토리를 선택합니다.

4. URL 복제에서 사용자가 사용하게 할 프로토콜을 선택합니다. 그러면 연결 프로토콜에 대한 복제 URL이 복사됩니다.

5. AWS CLI 설치, 프로파일 구성 또는 Git 설치와 같은 기타 지침과 함께 복제 URL을 사용자에게 전송합니다. 연결 프로토콜(예: HTTPS)에 대한 구성 정보를 포함해야 합니다.