시작하기 AWS CodeCommit

이 자습서에서는 몇 가지 주요 CodeCommit 기능을 사용하는 방법을 보여줍니다. 먼저 리포지토리를 생성하고 몇 가지 변경 사항을 커밋합니다. 그런 다음 파일을 검색하고 해당 변경 사항을 확인합니다. 다른 사용자에게 코드 변경 내용을 검토하고 의견을 제시할 수 있게 풀 요청을 생성할 수도 있습니다.

기존 코드를 로 CodeCommit 마이그레이션하려면 을 참조하십시오AWS CodeCommit으로 마이그레이션.

Git에 익숙하지 않다면 Git 및 CodeCommit 시작하기 섹션도 완료하는 것이 좋습니다. 이 튜토리얼을 완료한 후에는 충분한 연습을 통해 자신의 프로젝트와 팀 환경에서 사용을 CodeCommit 시작할 수 있을 것입니다.

CodeCommit 콘솔에는 정보 아이콘 ( ) 또는 페이지의 정보 링크를 통해 열 수 있는 접을 수 있는 패널에 유용한 정보가 들어 있습니다. 사용자는 이 패널을 언제든 닫을 수 있습니다.

또한 CodeCommit 콘솔에서는 리포지토리, 빌드 프로젝트, 배포 애플리케이션, 파이프라인과 같은 리소스를 빠르게 검색할 수 있는 방법을 제공합니다. 리소스로 이동을 선택하거나 / 키를 누른 후 리소스 이름을 입력하세요. 목록에 일치 항목이 나타납니다. 검색은 대/소문자를 구분하지 않습니다. 보기 권한이 있는 리소스만 표시됩니다. 자세한 내용은 콘솔에서 리소스 보기 섹션을 참조하세요.

사전 조건

시작에 앞서 다음과 같은 사전 조건 및 설정 절차를 완료합니다.

• IAM 사용자에게 권한 할당

• 본 자습서에 사용되는 로컬 시스템에서 HTTPS 또는 SSH 접속에 필요한 보안 인증 정보 관리 설정하기.

• 리포지토리 생성을 포함한 모든 작업에 명령줄 또는 터미널을 사용할지 AWS CLI 여부를 구성합니다.

1단계: CodeCommit 리포지토리 생성

CodeCommit 콘솔을 사용하여 CodeCommit 리포지토리를 생성할 수 있습니다. 본 자습서에 활용활 리포지토리를 이미 보유하고 있으면 이 단계를 건너뛰어도 됩니다.

참고

사용자는 사용량에 따라 리포지토리 생성 또는 액세스에 대한 비용이 부과될 수 있습니다. 자세한 내용은 CodeCommit 제품 정보 페이지의 가격을 참조하십시오.

CodeCommit 리포지토리를 만들려면

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

2. 지역 선택기를 사용하여 저장소를 생성할 AWS 리전 위치를 선택합니다. 자세한 정보는 리전 및 Git 연결 엔드포인트을 참조하세요.

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

4. 리포지토리 생성 페이지에서 리포지토리 이름에 해당 리포지토리의 이름(예: MyDemoRepo)을 입력합니다.

   참고

   리포지토리 이름은 대/소문자를 구분하며 100자를 초과할 수 없습니다. 자세한 내용은 제한을 참조하세요.

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

6. (선택 사항) 하나 이상의 저장소 태그 ( AWS 리소스를 구성하고 관리하는 데 도움이 되는 사용자 지정 속성 레이블) 를 저장소에 추가하려면 태그 추가를 선택합니다. 자세한 정보는 리포지토리에 태그 지정 AWS CodeCommit을 참조하세요.

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

8. (선택 사항) 이 리포지토리에 Java 또는 Python 코드가 포함되어 있고 검토자가 해당 코드를 분석하도록 하려면 Java 및 Python용 Amazon CodeGuru CodeGuru Reviewer 활성화를 선택합니다. CodeGuru 리뷰어는 여러 기계 학습 모델을 사용하여 코드 결함을 찾아내고 풀 요청의 개선 및 수정 사항을 자동으로 제안합니다. 자세한 내용은 Amazon CodeGuru 리뷰어 사용 설명서를 참조하십시오.

9. 생성을 선택합니다.

참고

해당 리포지토리에 MyDemoRepo이 아닌 다른 이름을 사용하는 경우, 나머지 단계에서 그 이름을 사용해야 합니다.

리포지토리가 열리면 CodeCommit 콘솔에서 직접 파일을 추가하는 방법에 대한 정보가 표시됩니다.

2단계: 리포지토리에 파일 추가

리포지토리에 파일을 추가하려면 다음을 수행해야 합니다.

• CodeCommit 콘솔에서 파일 생성 콘솔에서 임의의 리포지토리에 파일을 처음으로 생성하면 main이라는 브랜치가 자동으로 생성됩니다. 이 브랜치는 해당 리포지토리의 기본 브랜치입니다.

• CodeCommit 콘솔을 사용하여 로컬 컴퓨터에서 파일 업로드 콘솔에서 리포지토리에 파일을 처음으로 업로드하면 main이라는 브랜치가 자동으로 생성됩니다. 이 브랜치는 해당 리포지토리의 기본 브랜치입니다.

• Git 클라이언트를 사용하여 리포지토리를 로컬 컴퓨터에 복제한 다음 파일을 추가하고 커밋하여 리포지토리에 푸시합니다. CodeCommit Git에서 처음 커밋할 때는 브랜치가 자동으로 생성되며 이 브랜치가 리포지토리의 기본 브랜치로 설정됩니다. 브랜치 이름은 Git 클라이언트의 기본 설정에 따라 결정됩니다. 첫 브랜치의 이름으로 main을 사용하도록 Git 클라이언트 구성합니다.

참고

사용자는 언제든 브랜치를 생성하고 리포지토리의 기본 브랜치를 변경할 수 있습니다. 자세한 정보는 리포지토리 내 브랜치 작업하기 AWS CodeCommit을 참조하세요.

시작하는 가장 간단한 방법은 CodeCommit 콘솔을 열고 파일을 추가하는 것입니다. 이렇게 하면 리포지토리에 main이라는 기본 브랜치도 생성됩니다. 파일을 추가하고 를 사용하여 저장소에 첫 번째 커밋을 만드는 방법에 대한 지침은 를 사용하여 저장소의 첫 번째 커밋 만들기를 참조하십시오 AWS CLI. AWS CLI

리포지토리에 파일을 추가하려면

1. 해당 리포지토리의 탐색 모음에서 코드를 선택합니다.

2. 파일 추가를 선택한 다음, 컴퓨터에서 파일 생성 또는 파일을 업로드를 선택합니다. 이 자습서에서는 두 작업을 수행하는 방법을 모두 보여 줍니다.

3. 파일을 추가하려면 다음을 수행합니다.

   1. 브랜치 드롭다운 목록에서 파일을 추가할 브랜치를 선택합니다. 기본 브랜치가 자동으로 선택됩니다. 여기서 소개하는 예제에서는 기본 브랜치의 명칭이 main으로 지정됩니다. 파일을 다른 브랜치에 추가하려면 다른 브랜치를 선택합니다.

   2. 파일 이름에 파일의 이름을 입력합니다. 코드 편집기에서 파일의 코드를 입력합니다.

   3. 작성자 이름에 다른 리포지토리 사용자에게 표시할 이름을 입력합니다.

   4. 이메일 주소에 이메일 주소를 입력합니다.

   5. (선택 사항) 커밋 메시지에 간단한 메시지를 입력합니다. 이것은 선택 사항이지만 이 파일을 추가한 이유를 팀원들이 이해하는 데 도움이 되므로 커밋 메시지를 추가하는 것이 좋습니다. 커밋 메시지를 입력하지 않으면 기본 메시지가 사용됩니다.

   6. 변경 사항 커밋을 선택합니다.

   파일을 업로드하려면 다음을 수행합니다.

   • 파일을 업로드하려는 경우에는 업로드할 파일을 선택합니다.

     

   • 작성자 이름에 다른 리포지토리 사용자에게 표시할 이름을 입력합니다.

   • 이메일 주소에 이메일 주소를 입력합니다.

   • (선택 사항) 커밋 메시지에 간단한 메시지를 입력합니다. 이것은 선택 사항이지만 이 파일을 추가한 이유를 팀원들이 이해하는 데 도움이 되므로 커밋 메시지를 추가하는 것이 좋습니다. 커밋 메시지를 입력하지 않으면 기본 메시지가 사용됩니다.

   • 변경 사항 커밋을 선택합니다.

자세한 정보는 AWS CodeCommit 리포지토리에서 파일 작업하기을 참조하세요.

Git 클라이언트를 사용하여 리포지토리를 복제하려면 로컬 컴퓨터에 Git을 설치한 다음 리포지토리를 복제합니다. CodeCommit 일부 파일을 로컬 리포지토리에 추가하고 리포지토리로 푸시합니다. CodeCommit 자세한 설명은 Git 및 CodeCommit 시작하기 섹션을 참조하세요. Git에 익숙하지만 CodeCommit 리포지토리에서 이 작업을 수행하는 방법을 잘 모르는 경우, 또는 에서 커밋 생성 예제와 지침을 볼 수 있습니다. 2단계: 로컬 리포지토리 생성 리포지토리에 연결

일부 파일을 CodeCommit 리포지토리에 추가한 후 콘솔에서 해당 파일을 볼 수 있습니다.

3단계: 리포지토리의 콘텐츠 검색

CodeCommit 콘솔을 사용하여 리포지토리의 파일을 검토하거나 파일의 내용을 빠르게 읽을 수 있습니다. 이렇게 하면 체크아웃할 브랜치를 결정하거나 리포지토리의 로컬 복사본 생성 여부를 결정하는 데 도움이 됩니다.

리포지토리를 검색하려면

1. 리포지토리에서 원하는 항목을 선택합니다. MyDemoRepo

2. 이 페이지에는 리포지토리의 기본 브랜치에 있는 콘텐츠가 표시됩니다. 다른 브랜치를 보거나 특정 태그의 코드를 보려면 목록에서 보려는 브랜치 또는 태그를 선택합니다. 다음 스크린샷에서 보기는 main 브랜치로 설정되어 있습니다.

   

3. 자신의 리포지토리에 있는 파일의 콘텐츠를 보려면 목록에서 해당 파일을 선택합니다. 표시된 코드의 색상을 변경하려면 설정 아이콘을 선택합니다.

   

   자세한 정보는 리포지토리에서 파일 검색을 참조하세요.

4. 리포지토리의 커밋 이력을 검색하려면 커밋을 선택합니다. 콘솔은 기본 브랜치의 커밋 이력을 시간 역순으로 표시합니다. 작성자, 날짜 등을 기준으로 커밋 세부 정보를 검토합니다.

   

5. 브랜치 또는 Git 태그별로 커밋 이력을 보려면 목록에서 보려는 브랜치 또는 태그를 선택합니다.

6. 커밋과 그 부모 커밋 간 차이를 보려면 축약된 커밋 ID를 선택하십시오. 공백 변경 사항 표시 여부와 변경을 인라인으로 표시할지(Unified 보기) 아니면 나란히 표시할지(Split 보기) 여부 등 변경 내용의 표시 방식을 선택할 수 있습니다.

   참고

   코드 및 다른 콘솔 설정 보기에 대한 기본 설정은 변경이 생길 때마다 브라우저 쿠키로 저장됩니다. 자세한 정보는 사용자 기본 설정으로 작업을 참조하세요.

   

7. 커밋에 대한 모든 주석을 보려면 해당 커밋을 선택한 후 변경 내용을 스크롤하여 인라인으로 표시합니다. 자신의 주석을 추가하고 다른 사람의 주석에 답변할 수도 있습니다.

   자세한 정보는 커밋에 대한 주석 추가을 참조하세요.

8. 탐색 창에서 태그, 브랜치, 커밋 ID 등 두 커밋 지정자 간의 차이를 보려면 커밋​을 선택한 다음 커밋 비교를 선택합니다.

   

   자세한 정보는 리포지토리의 커밋 이력 검색 및 커밋 비교 섹션을 참조하세요.

9. 커밋에서 커밋 시각화 도우미 탭을 선택합니다.

   

   그래프의 각 시점 옆에 커밋의 제목이 있는 커밋 그래프가 표시됩니다. 제목 표시는 80자로 제한됩니다.

10. 커밋에 대한 자세한 내용을 보려면 축약된 커밋 ID를 선택합니다. 특정 커밋에서 그래프를 렌더링하려면 그래프에서 해당 점을 선택합니다. 자세한 정보는 리포지토리의 커밋 이력을 그래프 형태로 보기 을 참조하세요.

4단계: 풀 요청 생성 및 협업

리포지토리에서 다른 사용자와 함께 작업할 때 코드를 공동 작업하고 변경 내용을 검토할 수 있습니다. 다른 사용자가 브랜치의 코드 변경 사항을 검토하고 의견을 제시할 수 있도록 풀 요청을 생성할 수 있습니다. 풀 요청에 대해 하나 이상의 승인 규칙을 생성할 수도 있습니다. 예를 들어 두 명 이상의 다른 사용자가 풀 요청을 승인해야 병합할 수 있는 승인 규칙을 생성할 수 있습니다. 풀 요청이 승인되면 해당 변경 내용을 대상 브랜치에 병합할 수 있습니다. 리포지토리에 대한 알림을 설정하면, 리포지토리 사용자는 리포지토리 이벤트(예: 풀 요청 또는누군가가 코드에 주석을 다는 경우)에 대한 이메일을 받을 수 있습니다. 자세한 정보는 AWS CodeCommit 리포지토리에서 이벤트 알림 구성을 참조하세요.

중요

풀 요청을 생성하려면 먼저 검토할 코드 변경 내용을 포함하는 브랜치를 생성해야 합니다. 자세한 정보는 브랜치 생성을 참조하세요.

풀 요청을 생성하고 공동 작업하려면

1. 탐색 창에서 풀 요청을 선택합니다.

2. 풀 요청에서 풀 요청 생성을 선택합니다.

   작은 정보

   또한 브랜치 및 코드에서 풀 요청을 생성할 수도 있습니다.

   풀 요청 생성의 소스에서, 검토하려는 변경 사항이 포함된 브랜치를 선택합니다. 대상 주소에서, 풀 요청이 닫힐 때 검토한 코드를 병합할 브랜치를 선택합니다. 비교를 선택합니다.

3. 병합 세부 정보와 변경 내용을 검토하여 풀 요청에 검토를 요청할 변경 내용과 커밋이 포함되어 있는지 확인합니다. 모두 포함되었으면 제목에서 이 검토 항목의 제목을 지정합니다. 이 제목은 리포지토리의 풀 요청 목록에 표시되는 제목입니다. 설명에 이 검토 사항에 대한 세부 정보와 검토자에 대한 기타 유용한 정보를 입력합니다. 생성을 선택합니다.

   

4. 풀 요청이 리포지토리의 풀 요청 목록에 나타납니다. 보기를 필터링하여 열린 요청, 닫힌 요청, 본인이 생성한 요청 등만 표시할 수 있습니다.

   

5. 풀 요청을 병합하기 전에 특정 조건이 충족되도록 풀 요청에 승인 규칙을 추가할 수 있습니다. 풀 요청에 승인 규칙을 추가하려면 목록에서 풀 요청을 선택합니다. 승인 탭에서 승인 규칙 생성을 선택합니다.

6. 규칙 이름에서 규칙에 설명이 포함된 이름을 지정합니다. 예를 들어 풀 요청을 병합하기 전에 두 사람이 승인하도록 요구하려면 규칙 이름으로 Require two approvals before merge를 지정할 수 있습니다. 필요한 승인 수에 원하는 숫자 2를 입력합니다. 기본 값은 1입니다. 제출을 선택합니다. 승인 규칙 및 승인 풀 멤버에 대한 자세한 내용은 풀 요청에 대한 승인 규칙 생성 단원을 참조하세요.

   

7. 리포지토리에 대한 알림을 구성했고 풀 요청 이벤트를 사용자에게 알리기로 한 경우에는 새 풀 요청에 대한 이메일이 사용자에게 발송됩니다. 사용자는 변경 내용을 살펴보고 특정 코드 행, 파일, 풀 요청 자체 등에 대해 주석을 남길 수 있습니다. 주석에 텍스트와 이모티콘으로 댓글을 다는 것도 가능합니다. 필요할 경우, 변경 내용을 풀 요청 브랜치로 푸시할 수 있습니다. 이렇게 하면 풀 요청이 업데이트됩니다.

   

8. 요청에서 변경한 내용이 만족스러우면 승인을 선택합니다. 해당 풀 요청에 대해 승인 규칙이 구성되어 있지 않은 경우에도 풀 요청을 승인하도록 선택할 수 있습니다. 그러면 풀 요청을 검토한 결과와 변경 내용에 대한 승인이 명확하게 기록될 수 있습니다. 생각이 바뀔 경우 승인을 취소하도록 선택할 수도 있습니다.

   

   참고

   풀 요청을 생성한 사용자는 풀 요청을 승인할 수 없습니다.

9. 풀 요청에서 모든 코드 변경 내용을 검토하고 동의했다면 다음 중 하나를 수행합니다.

   • 브랜치를 병합하지 않고 풀 요청을 닫으려면 풀 요청 닫기를 선택합니다.

   • 브랜치를 병합하고 풀 요청을 종료하려면 병합을 선택합니다. 코드에 사용 가능한 병합 전략 중에서 선택할 수 있습니다. 병합 전략은 소스 브랜치와 대상 브랜치 간 차이 및 병합이 완료된 후 소스 브랜치를 자동으로 삭제할지 여부에 따라 달라집니다. 선택한 후 풀 요청 병합을 선택하여 병합을 완료합니다.

     

   • 브랜치에 자동으로 해결할 수 없는 병합 충돌이 있는 경우 CodeCommit 콘솔에서 해결하거나 로컬 Git 클라이언트를 사용하여 브랜치를 병합한 다음 병합을 푸시할 수 있습니다. 자세한 정보는 AWS CodeCommit 리포지토리에서 풀 요청의 충돌 해결을 참조하세요.

   참고

   언제라도 로컬 리포지토리에서 git merge 명령을 사용하고 변경 내용을 푸시하여 브랜치(풀 요청 브랜치 포함)를 수동으로 병합할 수 있습니다.

자세한 내용은 풀 요청 작업 및 승인 규칙 템플릿 작업 섹션을 참조하세요.

5단계: 정리

CodeCommit 리포지토리가 더 이상 필요하지 않은 경우 스토리지 공간에 대한 요금이 계속 청구되지 않도록 이 연습에서 사용한 CodeCommit 리포지토리와 기타 리소스를 삭제해야 합니다.

중요

이 작업은 실행을 취소할 수 없습니다. 이 리포지토리를 삭제한 후에는 이 리포지토리를 로컬이나 공유 리포지토리에 더 이상 복제할 수 없습니다. 또 이 리포지토리를 대상으로 데이터를 풀하거나 푸시할 수 없으며 로컬 또는 공유 리포지토리에서 어떠한 Git 연산도 수행할 수 없습니다.

리포지토리에 알림을 구성한 경우 리포지토리를 삭제하면 리포지토리에 대해 생성된 Amazon CloudWatch Events 규칙도 삭제됩니다. 단, 해당 규칙의 대상으로 사용된 Amazon SNS 주제는 삭제되지 않습니다.

리포지토리에 트리거를 구성한 경우에는 해당 리포지토리를 삭제해도 트리거의 대상으로 설정한 Amazon SNS 주제나 Lambda 함수는 삭제되지 않습니다. 필요 없는 리소스는 반드시 삭제하세요. 자세한 정보는 리포지토리에서 트리거 삭제을 참조하세요.

리포지토리를 CodeCommit 삭제하려면

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

2. 리포지토리에서 삭제할 리포지토리를 선택합니다. 이 항목의 명명 규칙을 따랐다면 이름이 MyDemoRepo지정됩니다.

3. 탐색 창에서 설정을 선택합니다.

4. 설정 페이지의 리포지토리 삭제에서 리포지토리 삭제를 선택합니다.

5. delete를 입력한 다음 삭제를 선택합니다. 이로써 리포지토리가 영구적으로 삭제됩니다.

6단계: 다음 단계

이제 몇 가지 기능에 CodeCommit 익숙해졌으니 다음 작업을 고려해 보십시오.

• Git을 처음 CodeCommit 사용하거나 Git과 함께 사용하는 CodeCommit 예제를 검토하려면 자습서를 계속 진행하세요. Git 및 CodeCommit 시작하기

• CodeCommit 리포지토리에서 다른 사용자와 함께 작업하려면 을 참조하십시오. 리포지토리 공유 (다른 Amazon Web Services 계정의 사용자와 자신의 리포지토리를 공유하고 싶다면 역할을 사용하여 AWS CodeCommit 리포지토리에 대한 계정 간 액세스를 구성합니다. 단원을 참조하세요.)

• 리포지토리를 마이그레이션하려면 의 단계를 따르십시오CodeCommit으로 마이그레이션. CodeCommit

• 지속적인 배포 파이프라인에 리포지토리를 추가하려면 간단한 파이프라인 안내 자습서의 절차를 따릅니다.

• 커뮤니티의 예를 포함하여 통합되는 제품 및 서비스에 대해 자세히 알아보려면 을 참조하십시오제품 및 서비스 통합. CodeCommit