리포지토리 생성 및 관리

Codeflow에서 리포지토리를 생성하고, 코드와 설정을 관리하는 방법을 설명합니다.

리포지토리 생성

리포지토리는 소스 코드를 저장하고 이력을 관리하는 공간입니다.

카카오클라우드 콘솔 > Developer Tools > Codeflow 메뉴로 이동합니다.
리포지토리 메뉴에서 [리포지토리 생성] 버튼을 클릭합니다.

필요한 정보를 입력한 후, [생성] 버튼을 클릭합니다.

구분	설명
이름	리포지토리 이름
설명	리포지토리 설명 (100자 이내)
기본 브랜치 이름	기본값은 `main`이며, 필요에 따라 변경할 수 있습니다.
승인 규칙	풀 리퀘스트 병합 조건을 설정합니다. - 단일 승인: 지정한 리뷰어 중 1명이 승인하면 병합할 수 있습니다. - 전체 합의: 지정한 리뷰어 전원이 승인해야 병합할 수 있습니다.

리포지토리 메뉴에서 생성된 리포지토리를 확인합니다.

외부 리포지토리 가져오기

GitHub, GitLab 등 다른 Git 저장소의 리포지토리는 미러 푸시(mirror push)를 통해 Codeflow 리포지토리로 가져올 수 있습니다.

코드를 가져올 리포지토리를 생성합니다.
원본 리포지토리를 복제(bare clone)한 후, Codeflow 리포지토리로 미러 푸시합니다.

   git clone --bare ${SOURCE_REPOSITORY_URL}
   cd ${REPOSITORY_NAME}.git
   git push --mirror ${CODEFLOW_REPOSITORY_URL}

파라미터	설명
SOURCE_REPOSITORY_URL	원본 리포지토리 URL
REPOSITORY_NAME	원본 리포지토리 이름
CODEFLOW_REPOSITORY_URL	Codeflow 리포지토리 URL - 리포지토리 메뉴의 목록에서 확인 가능

푸시 완료 후 리포지토리의 코드, 커밋 탭에서 브랜치, 태그, 커밋 이력이 정상적으로 반영되었는지 확인합니다.

안내

Codeflow 리포지토리로 푸시 시 IAM 액세스 키 인증이 필요합니다. 자세한 설명은 액세스 키 생성하기를 참고하세요.
리포지토리 용량이 큰 경우 가져오기에 시간이 소요될 수 있습니다.
브랜치, 태그 등 참조가 매우 많은 리포지토리는 일부 참조가 반영되지 않을 수 있습니다. 이 경우 브랜치와 태그를 나누어 단계적으로 푸시한 후, 원본과 브랜치·태그 개수가 일치하는지 확인해 주세요.
전체 커밋 이력이 필요하지 않은 경우, 최근 이력만 복제하여 가져오면 소요 시간을 줄일 수 있습니다.

리포지토리 조회

카카오클라우드 콘솔 > Developer Tools > Codeflow 메뉴로 이동합니다.
리포지토리 메뉴에서 리포지토리 목록을 확인합니다.

목록에서는 리포지토리별 이름, 설명, URL, 마지막 커밋 일시, 생성 일시를 확인할 수 있습니다.
Git 인증
리포지토리 URL을 통해 소스 코드를 클론(Clone)하거나 원격 리포지토리로 연결할 수 있습니다. Git 클론 시 IAM 액세스 키 인증이 필요합니다.
- Username: IAM 액세스 키 ID
- Password: 보안 액세스 키
- 자세한 설명은 액세스 키 생성하기를 참고하세요.

리포지토리를 선택하면 상세 페이지로 이동합니다. 상세 페이지는 다음 탭으로 구성됩니다.

탭	내용
세부 정보	이름, 설명, URL, 승인 규칙, 사용 언어, 생성 일시 등 기본 정보
코드	파일·폴더 목록 탐색, 수정 일시, 크기 등 기본 정보
커밋	커밋 목록 및 ID, 메시지, 작성자 등 기본 정보
풀 리퀘스트	풀 리퀘스트 목록, 상태 및 승인 상태 확인
워크플로우	워크플로우 파일·실행 이력 확인 및 관리
액션 설정	리포지토리 토큰, 러너, 리포지토리 변수 관리

정보

리포지토리 화면 우측 상단의 드롭다운에서 브랜치나 태그를 선택하면 선택한 기준에 따른 코드와 커밋 정보를 확인할 수 있습니다.

코드

리포지토리의 폴더와 파일을 탐색하며 각 항목의 경로, 최종 수정 일시, 크기, 유형을 확인할 수 있습니다.

파일은 [⋮] 버튼으로 개별 다운로드할 수 있으며, 폴더는 다운로드를 지원하지 않습니다. 코드 전체를 다운로드하려면 화면 우측의 [다운로드] 버튼을 사용합니다.

파일을 선택하면 파일 상세 페이지로 이동하며, 이름, 경로, 최신 커밋 정보, 파일 내용, 커밋 내역을 확인할 수 있습니다. 파일 내용은 미리보기 또는 코드 보기 형태로 제공되며, 파일을 다운로드할 수 있습니다.

안내

파일 형식에 따라 일부 보기 모드는 제공되지 않을 수 있습니다.
10MB를 초과하는 파일은 보기 모드가 제한되므로, 파일을 다운로드하여 확인해야 합니다.

커밋

커밋 ID, 메시지, 작성자, 커밋 일시를 확인할 수 있습니다.

커밋 ID를 선택하면 커밋 상세 페이지로 이동합니다. 변경 파일 목록, 변경 내용(diff), 변경 통계를 확인할 수 있으며, 변경 내용은 통합 보기 또는 분할 보기 방식으로 제공됩니다.

파일 보기를 클릭하면 해당 파일의 파일 상세 페이지로 이동합니다.
패치 파일(.patch)과 Diff 파일(.diff)을 다운로드할 수 있습니다.
해당 커밋을 기준으로 브랜치 생성 또는 태그 생성을 할 수 있습니다.

안내

1MB를 초과하는 diff 파일은 보기 모드가 제한되므로, 로컬 Git 클라이언트를 사용하여 변경 사항을 확인해 주세요.

풀 리퀘스트

풀 리퀘스트 목록에서 기준 브랜치(병합 대상)와 작업 브랜치(변경 사항이 담긴 브랜치), 상태와 승인 상태를 확인할 수 있습니다.

상태는 풀 리퀘스트의 진행 여부를, 승인 상태는 리뷰어의 검토 결과를 나타냅니다.

승인 상태	상태	설명
`Pending`	`OPEN`	승인 또는 검토가 진행 중인 상태
`Approved`	`OPEN`	승인 조건이 충족된 상태
`Rejected`	`OPEN`	승인되지 않고 반려된 상태
`Merged`	`CLOSED`	승인 후 기준 브랜치에 병합된 상태
`Canceled`	`CLOSED`	풀 리퀘스트가 취소된 상태

생성자는 [⋮] 버튼을 통해 풀 리퀘스트를 취소·병합·삭제할 수 있습니다.

안내

풀 리퀘스트 리뷰(승인, 리뷰 취소, 반려)는 풀 리퀘스트 상세 페이지에서 진행할 수 있습니다. 자세한 설명은 풀 리퀘스트 생성 및 관리를 참고하세요.

워크플로우 파일 목록과 실행 이력을 확인할 수 있습니다. 워크플로우 파일 실행, 실행 취소, 로그 확인, 실행 이력 삭제 방법은 워크플로우 관리를 참고하세요.

리포지토리 토큰, 러너, 리포지토리 변수를 관리할 수 있습니다. 러너 등록·실행과 리포지토리 변수 관리 방법은 액션 설정을 참고하세요.

리포지토리 설정 변경

리포지토리 이름, 설명, 기본 브랜치, 승인 규칙을 수정할 수 있습니다.

카카오클라우드 콘솔 > Developer Tools > Codeflow 메뉴로 이동합니다.
리포지토리 메뉴에서 대상 리포지토리의 [⋮] 버튼을 클릭하고, 수정할 항목에 해당하는 메뉴를 선택합니다.
- 이름, 설명: 정보 변경
- 기본 브랜치: 기본 브랜치 수정
- 승인 규칙: 승인 규칙 수정
변경 작업을 완료한 후 [저장] 또는 [수정] 버튼을 클릭합니다.

안내

리포지토리 승인 규칙을 수정한 경우, 이후 생성되는 풀 리퀘스트에만 변경된 규칙이 적용됩니다.

리포지토리 삭제

주의

삭제한 리포지토리는 복구할 수 없습니다. 저장된 코드, 커밋 이력, 풀 리퀘스트 등 모든 데이터가 영구 삭제됩니다.

카카오클라우드 콘솔 > Developer Tools > Codeflow 메뉴로 이동합니다.
리포지토리 메뉴에서 대상 리포지토리의 [⋮] 버튼 > 삭제를 선택합니다.
팝업창에서 삭제 문구를 입력 후 [삭제] 버튼을 클릭합니다.