[REDMINE] 사용 방법

 

 

Redmine Cookbook

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

🗂 목차

● [INFRA] Ubuntu 22.04 LTS Redmine 설치  
● [INFRA] Redmine과 Git 연동  
● [REDMINE] 사용 방법  

 

이 글은 인프런 - Git과 Redmine으로 하는 프로젝트 강의와 생활코딩 - 레드마인 강의를 듣고 정리한 내용 입니다.

 

 

🚀 Redmine으로 협업하기

 

    🔽  주요 기능

        📦 주요 기능 정리

∙ 프로젝트 : 프로젝트를 구분하는 단위로 이 단위에 따라 업무, 뉴스, 저장소 등 구분.
∙ 일감 : 업무 기록, 담당자 지정, 일정 산출 등이 이뤄지는 글 단위 (Blog의 Post, 게시판의 게시물과 같은 단위).
∙ Wiki(위키) : 위키는 링크를 통해 연관된 지식을 그물망처럼 연결 시킨 지식 저장의 형태로 프로젝트를 위해 필요한 정보, 프로젝트를 통해 산출되는 지식 저장소.
∙ 간트 챠트 : 일감에 따른 진행 상황을 시간의 흐름에 따라 보여주는 시각화 방법.
∙ 달력 : 달력 형식으로 일감들의 기간 확인.
∙ 문서 : 게시판 형식으로 정보 저장.
∙ 파일 : 공유해야 할 File 저장.
∙ 저장소 : Version 관리 System(Git Hub, Git Lap 등)과 연동하여 Source Code, 문서의 내용을 열람하거나, 역사를 추적.

        📦 Project

Redmine에 Project는 부모 - 자식 관계로 나열할 수 있어요. 즉, 상위 Project 아래 하위 Project를 만들 수 있는 개념이에요.

하위 Project로 만들 Project에 '설정'에서 위와 같이 상위 프로젝트를 선택해 주면 되요.

        📦 로드맵

 

로그맵을 통해서 현재 진행중인 일감에 대해서 확인할 수 있어요.

일감이 모두 완료가 되어야 해당 Project가 끝났다고 선언하고, 출시 할 수 있을거에요.

한마디로 정리하면 일감을 묶어 놓은 것이라고 할 수 있겠어요.

        📦 WiKi

위키는 해당 Project 참여 인원들이 필수로 알아야 하는 지식들이나, Project를 통해 만들어지는 여러가지 정보, 지식들을 정리해 두는 백과사전이라고 생각하면 되요.

WiKi는 단어와 단어들을 링크로 연결 시켜 거대한 백과사전을 만드는 System이에요.

가장 적절한 예시는 위키백과가 있어요!

먼저 Project 내에 '위키' Tab을 눌러 위와 같이 WiKi 문법으로 글씨를 작성해 주었어요.

미리 보기를 해서 보면 위와 같이 빨간색으로 표시가 되는데, 이는 해당 단어와 연결될 문서가 없기 때문이에요.
저 상태에서 해당 글자를 클릭하게 되면 저 내용에 대해 글을 작성할 수 있는 Editor 창으로 넘어가게 된답니다.

 

저장을 해주면 위와 같이 만들어 진 것을 확인할 수 있어요.
그럼 '컨텐츠'라는 글자를 눌러볼게요.

그럼 이렇게 컨텐츠에 대한 내용을 작성할 수 있게 Editor로 넘어가는 것을 확인할 수 있어요.

위와 같이 작성을 하고 저장을 해 볼게요.

컨텐츠의 글자가 파란색으로 변경된 것을 확인할 수 있어요.

컨텐츠를 클릭하면 위와 같이 이동하는 것을 확인할 수 있답니다.

위와 같이 '이력'을 클릭하면 해당 문서에 대해 변경 사항을 확인할 수 있어요.

이렇게 변경사항을 확인할 수 있답니다.



WiKi 문법에 대한 내용은 이 곳에 준비해 두었어요.

 

    🔽  Redmine으로 하는 Project 관리

        📦 Version

Version은 크게 세가지 번호로 되어 있는 경우가 많아요.
즉, Version 관리를 위해 숫자를 입력하는 것에 대한 약속이라고 생각하면 좋아요.
대부분 Version을 나타낼 때 3가지 숫자를 .을 기준으로 작성하게 되는데, 앞 자리는 major, 가운데는 minor, 마지막은 etc 내용이라고 생각하면 되요.

예를 들어 3.0.1 이라는 Version 숫자가 보인다면 major 번호는 3이고, minor 번호는 0이고, etc 번호는 1이라는 것을 알 수 있어요.

이  름	내   용
major	호환이 안되는 변경, Framework 변경, Method(함수) 삭제, 이름 변경 등
minor	호환 가능한 변경, Function 추가, Component 추가, Class 추가, Method 추가 등
etc	Bug Fix (버그 수정) 등

728x90

호환이 안되는 변경이라는 말은 해당 Project를 사용하는 다른 Project나, Library가 1 Version과 2 Version이 있다고 했을 때, 서로 호환이 안되는 것을 말해요.

호환이 된다는 것은 예를 들어 1.1 Version, 1.2 Version, 1.3 Version이 있다고 가정할 때, 서로 호환이 가능하다는 이야기에요.

1.1 Version은 1.2 Version보다 많은 함수를 제공하지 않기 때문에 1.1 Version을 사용하다가 1.2 Version이 나오면 1.2 Version을 써야 더 많은 기능을 사용할 수 있을거에요.

 

Version 예시

Version 예시	내      용
1.0.0	Version 1로 Release 되고, Bug Fix 등이 한번도 되지 않은 Version
1.0.3	Version 1로 Release 되고, Bug Fix 등이 3번 있었던 Version
1.3.0	Version 1에서 새로운 기능 추가, 1.0.*, 1.1.*, 1.2.* Version을 사용하던 Project 호환 가능. 한번도 Bug Fix 등이 없었던 Version
2.1.11	Version 2로 Release 되고, Bug Fix 등이 11번 있었던 Version, 2.0.* Version과 호환 가능.

        📦 Version / 일감 만들기

먼저 Redmine을 본격적으로 사용하기 위해 프로젝트를 만들어 볼게요.

최초 초기 화면에서 '프로젝트'를 클릭하여 줍니다.

'새 프로젝트'를 눌러 프로젝트를 만들어 줄게요.

blog 라는 새 프로젝트를 만들어 줄게요.

참고로 식별자는 URI를 어떻게 만들 것인가에 대한 내용이에요.

위와 같이 blog라고 식별자를 주게 되면 http://xxx.redmine.com/blog와 같이 URI가 설정 될 것이에요.

다시 상단에 '프로젝트'를 누르면 위와 같이 프로젝트가 만들어 진 걸 확인할 수 있어요.


이 프로젝트에서 요구 사항은 아래와 같아요.

∙ Login Page
∙ Welcome Page
∙ JavaScript - Authenticate(인증)


최초 Version 관련한 작업을 해볼게요.

위와 같이 '설정'으로 들어가 줄게요.

그런 뒤 '버전'을 눌러줍니다.

'새 버전'을 눌러주세요.

위와 같이 이름에는 Version을 적어주고, 숫자에 어떤 기능에 대한 Version인지에 대해 적어주었어요.
그런 뒤 날짜에 해당 기능 작업 시작일을 눌러주었어요.

'만들기'를 눌러주세요.

위와 같이 버전이 하나 생긴것을 확인할 수 있어요.



이번에는 '일감'을 한번 만들어 볼게요.

참고로 현업에서는 이 일감을 Ticket(티켓)이라고 많이 불러요.

'일감'을 눌러 들어가 줄게요.

'새 일감 만들기'를 눌러주세요.

위와 같이 유형에는 새 기능을 만드는 작업이기 때문에 '새 기능'으로 하였고, 해당 일감의 제목은 Login Page라고 하여 주었어요.

위에서 만든 Version에 대한 내용은 목표 버전에서 선택하여 주었어요.

'만들기'를 눌러줄게요.

위와 같이 '일감'이 만들어 졌어요.

 

마찬가지로 Welcome Page, Login Authentication '일감'도 만들어 주었어요.

'개요' Tab을 보면 위와 같이 새 기능에 대해 진행중이라고 나오는 것을 확인할 수 있어요.

 

'일감' Tab에서는 위와 같이 세 개의 일감이 등록된 것을 확인 할 수 있어요.


하나 더 일감을 만들어 볼게요.

위와 같이 설명에 h1과 *와 같이 Wiki 문법을 통해 글자를 꾸며줄 수 있어요.

우측에 ? 표시를 누르면 어떤 것들을 사용할 수 있는지 Manual이 나온답니다.

위와 같이 작업하고, '미리 보기'를 눌러보면 아래와 같이 확인할 수 있어요.

 

위와 같이 글씨가 모두 커져버리는 사태를 방지하기 위해 한 칸을 띄어주었어요.

위와 같이 시작일과 완료 기한을 줄 수 있고, 시간으로 해서 완료 시간을 얼마나 줄 것인지도 정할 수 있어요.

또한, 작업자를 지정해 줄 수도 있죠.

관련한 File이 있다면 파일도 올릴 수 있답니다.

이 일감(Ticket) 관련해서 실제 작업자는 아니지만, 참고해야 하는 사람이 있다면 일감 관람자를 통해 추가 할 수 있어요.

위와 같이 일감을 하나 더 만들어 보았어요.

 

주요 일감 상태

∙ 신규 : 일감이 처음 발행 되었고, 해당 작업자가 작업을 진행하고 있지 않은 상태.
∙ 진행 : 해당 담당자가 해당 일감에 대한 작업을 시작 및 진행중인 상태.
∙ 완료 : 작업이 완료된 상태.


이번에는 하위 일감을 만들어 볼게요.

하위 일감의 추가를 눌러줍니다.

위와 같이 작성하고, 만들기를 눌러보았어요.

그럼 위와 같이 하위 일감이 추가된 것을 볼 수 있어요.

 

        📦 Bare Repository & Redmine과 Repository 연결

주니하랑은 여기에서 연동 관련 처리를 해 보았음으로 이 내용으로 대체할게요.

반응형

💡 참고 사항
Bare Repository란?

일반적인 깃 저장소(원격 저장소가 따로 존재하는 로컬 저장소)는 'git init'으로 생성하지만 원격(서버) 저장소라면 bare-repository로 생성해야 한다. bare-repository는 워킹 트리가 없고 변경사항만 추적하는 저장소를 말한다.

 

 

이렇게 Repository 정보를 Redmine에서 확인할 수 있어요.

        📦 작업 및 일감 완료

최초 주니하랑은 Code 작업이 진행되었다는 것을 가정하기 위해 Login 일감에 대한 Code 작성을 위와 같이 진행해 주었어요.

 

html File을 열어 잘 동작하는지 Test 해 볼게요.

 

잘 작동하는 걸 확인할 수 있어요.

(위에서 작업했던 Repository의 문제로 변경을 하였습니다.)

위와 같이 login.html을 push 하여 주었어요.

Login Page 구현이 완료 되었다고 가정했을 때, Redmine 일감에서 해당 일감에 편집을 해주어야해요.

해당 일감에서 '편집'을 눌러 주었어요.

 

위와 같이 편집에서 진척도를 완료가 되었으니 100%로 수정하고, 상태를 완료로 변경해 주었어요.

또한, 해당 작업 소요 시간은 1 시간이 걸렸다고 해 주었고, 완료 기한을 오늘로 표시해 주었어요.

'확인'을 눌러줍니다.

 

그럼 해당 작업에 대해 완료가 된 것을 확인할 수 있어요.

해당 작업이 얼마나 소요 되었는지도 볼 수 있어요.

'일감' 목록을 보면 해당 작업에 대한 내용이 사라진 것을 확인할 수 있어요.

로드맵

로드맵을 확인 해보니 한 건이 완료된 것을 나타내 주고 있어요.



나머지 일감도 처리해 볼게요.

welcome.html

 

Git에 Source Code를 올릴 때, 위와 같이 Commit Message에 ref #{Redmine 일감 번호}를 입력해 주었어요.

위와 같이 Redmine 저장소 Tab을 보면 Code 수정에 대해 확인할 수 있어요.

이번에 Push한 Commit Message에 파란색으로 #2라고 되어 있는데, 이걸 누르면 바로 해당 작업에 일감으로 이동할 수 있어요.

위와 같이 바로 이동이 된답니다.

이번엔 인증을 처리할 JavaScript 문을 만들어 보았어요.

인증과 Welcome에 대한 내용이 모두 추가 되었어요.

위에서 했던 것과 같이 해당 일감도 현재 상황에 맞게 수정을 해주면 됩니다.

실제 Side Project나, 업무를 할 때는 다른 상위 직급의 사람에게 Confirm을 받아야 할 것이에요.
그런 환경에서는 상태를 '해결'로 하고, 위와 같이 댓글을 쓰는 것이 좋은 방법인 것이에요.

그럼 일감 History가 위와 같이 나오는 것을 확인 할 수 있어요.

상위 직급자는 이 내용을 확인(해당 기능 Test)하고, 완료가 되었다면 편집을 통해 상태를 '완료'로 변경하고, 수정이 필요하다면 그것에 맞게 작업을 하면 될 것이에요.

 

Redmine Cookbook

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

🧐 참고 자료

∙ Git 과 Redmine 으로 하는 프로젝트 관리

∙ 생활코딩 - Redmine