비트버켓 사용자 메뉴얼 작성함에 있어서 간단한 실습 가이드 문서를 작성하였습니다.

1단계 : 프로젝트 생성

image-20241014-051537.pngimage-20241014-051616.png

권한에 따라 리포지토리, 프로젝트를 생성 가능 여부가 정해집니다.

  1. Create > Project 를 클릭합니다.

  2. Name을 입력합니다.

  3. Key(고유ID)를 입력합니다.

  4. Privacy 프로젝트 공개여부를 체크합니다.

  5. 입력 칸에 내용을 기입 후에 Create project 버튼을 눌러 생성합니다.

image-20241014-043411.png

2단계 : 리포지토리 생성

  1. Create > Repository 를 클릭합니다.

  2. 리포티토리 이름을 입력합니다.

  3. 특별히 설정해서 사용할게 아니라면 나머지는 기본값으로 설정합니다.

  4. Create repository 버튼을 눌러 생성합니다.

image-20241014-043516.png

3단계 : 리포지토리 복제(Clone)

Git을 만들거나 가져온 후 Bitbucket 리포지토리에서 코드 변경에 대한 협업을 진행하려면 먼저 리포지토리를 로컬에 복제해야 합니다.

  1. 소스 코드를 공유할 리포지토리에 이동합니다.

  2. Clone 버튼을 클릭합니다.

  3. 오른쪽 상단 메뉴에서 HTTPS를 선택합니다.

  4. 복제(Clone) 명령어를 복사합니다.

  5. CLI를 통해 복제하도록 하겠습니다.
    cd명령어를 사용하여 리포지토리를 복제할 디렉터리로 이동합니다.

  6. 4번에서 복사한 명령어를 붙여넣습니다.

image-20241014-043648.png

image-20241014-043749.png

4단계 : 브랜치 만들기

브랜치를 사용하면 각 팀원이 기존 코드 또는 다른 팀원의 작업에 영향을 주지 않으면서 여러 작업을 동시에 수행할 수 있습니다. 소스 코드 변경 사항을 병합할 준비가 되면 브랜치를 Bitbucket으로 푸시하여 Pull reqeusts에서 검토할 수 있습니다.

브랜치를 만드는 방법은 크게 2가지가 있습니다.

  1. Bitbucket UI에서 만들기

  2. CLI에서 Git 명령어를 사용하여 만들기

해당 메뉴얼에서는 Bitbucket UI에서 만드는 방법을 작성하겠습니다.

  1. Create > Branch 를 클릭합니다.

  2. Type: Bugfix, Feature, Hotfix, Release, Other 중에 선택합니다.

  3. 브렌치명을 입력 후에 Create 버튼을 클릭합니다.

image-20240104-060807.pngimage-20241014-043838.png

CLI에서 복제

  1. 브랜치를 만들었으면 로컬에서 fetch(가져오기) 및 checkout(체크아웃)을 합니다.

  2. 로컬에서 변경한 내용을 브랜치에 추가, 커밋 및 푸시합니다.
    git add .
    git commit -m "feature: TEST"
    git push origin

image-20241014-044711.pngimage-20241014-045050.png

5단계 : 풀리퀘스트로 변경된 소스 코드 검토

  1. Creat > Pull request 를 선택합니다.

  2. Source Branch = 병합하려는 코드를 변경한 브랜치입니다.
    Destination Branch = 변경 사항을 병합하려는 브랜치입니다.
    Title & Description = 제목 및 설명
    Reviewer = 승인해야 하는 검토자를 선택합니다.
    Delete branch = 풀리퀘스트가 병합되었을 때 자동으로 브랜치를 닫으려는 경우 선택합니다.

image-20240104-070240.pngimage-20241014-045200.png

6단계 : 풀리퀘스트 병합

풀리퀘스트에서 코드를 검토하고 승인한 다음 Merge(병합) 버튼을 클릭하면 브랜치를 병합합니다.

image-20241014-051322.png