Jira manual

서울시 마포구 상암동 누리꿈스퀘어 연구개발타워 1111 호 _ 070.7450.6572 _ [email protected]

JIRAIssue Tracker

Jellycoaster Inc.Dev.team

목차

I. INDEX

II. ADMINISTRATOR

III. USER

1. 이슈 발견자

2. 이슈 할당자 (PM)

3. 이슈 해결자


Index- 계정 관리

I

2013 Jira Manual by Jellycoaster Inc. Dev.team

Index- 구조

I


OnDemand

( 클라우드 서비스 제공 )

Atlassian 내 컴퓨터

Jira Bitbucket

이슈에 관한 코드 수정

업로드

이슈 관리

이슈와 버젼관리시스템 ( Git )

연결

Workflow

상태

클릭 !


Administrator

II

1. 프로젝트 생성

2. 프로젝트 관리


프로젝트 생성

- Key 란 무엇인가 - JIRA 내에서 프로젝트 구분할 때 , 빠른 검색을 위해 사용되는 값

※ 영어 대문자만 가능 !

클릭 !


프로젝트 관리

원하는 프로젝트 선택

관리자 모드로 전환


Issue Types

★ 정의

'Issue Type' 이란 , 프로젝트를 진행하면서 생긴 이슈의 종류를 의미하며 , 아래 그림과 같이 이슈 생성시

이슈 타입을 설정해야 한다 . 기본적으로 , 버그 , 기능 추가 , 과제 , 개선 등의 필드가 제공된다 .

Sub-Task 란 , 특정 이슈와 관련되어 부가적으로 생겨날 수 있는 이슈들을 의미한다 .

★ 변경이 가능한 부분

- 'Issue Type' 의 추가 및 삭제

- 'Issue Type' 의 아이콘 변경

- 'Issue Type' 필드 ( 위의 그림에서 Issue Type 종류들이 있는 부분 ) 에서 순서 조정 : 'Issue Type

Scheme' 메뉴 이용

- 'Issue Type' 중 , sub task 의 추가 및 삭제2013 Jira Manual by Jellycoaster Inc. Dev.team

Workflow

★ 정의

'Workflow' 란 , 프로젝트의 전체적인 흐름을 의미하며 , JIRA 에서는 각 Issue 들을 Workflow 와 연결을

시킬 수 있다 . 즉 , 모든 Issue 는 선택한 Workflow 의 특정 단계 (Status) 에 속하게 되며 , default 는 순서도

그림과 같이 , Open → progressing → In Progress → Resolved → Closed 로 설정되어 있다 .


- 새로운 'Workflow' 와 'Status' 의 추가 (JIRA 에서 default 로 제공하는 'Workflow' 는 수정불가 )

- 해당 'Workflow' 과 관계 있는 'Project' 및 'Issue Type' 의 연결 ('Workflow Schemes' 메뉴 이용 )

JIRA's system workflow


Screens

★ 정의

'Screen' 이란 , 'Workflow' 와 관계된 이슈를 생성하거나 수정 및 보기를 할 때 나오는 화면 자체를 의미한다 .

예를 들어 , 왼쪽 그림은 이슈의 상태를 'Resolve Issue' 로 바꿀 때 실제로 보여지는 나타나는 필드의 목록이

며 , 오른쪽 그림은 해당 'Resolve Issue Screen' 을 'Configure' 시 나타나는 화면이다 . 'Screens' 의 수정

시 , 'Field' 와 'Screen' 의 수정을 함께 하는 것을 추천한다 .


- 해당 'Screen' 에 해당하는 목록 변경 ('Screens' 메뉴 이용 )

- 'Issue' 가 생성되고 수정될 때 보여지는 'Screen' 지정 ('Screen Schemes' 메뉴 이용 )

- 특정 'Issue Type' 에 'Screen Scheme' 지정 ('Issue Type Screen Schemes' 메뉴에서 'Configure')


Fields

★ 정의

'Fields' 란 , JIRA 내의 여러 'Screen' 에 나타나는 목록의 정보들을 의미하며 , 아래의 왼쪽 그림과 같이

'Screen' 에 나타나는 'Resolution', 'Fix Version/s', 'Assignee' 등의 개체 등이 예이다 . 'Fields' 의 수정 시 ,

'Field' 와 'Screen' 의 수정을 함께 하는 것을 추천한다 .


- 'Issue' 가 'Edit' 될 때 , 각 'Field' 밑의 설명 수정

- 'Field' 의 숨김 기능

- 특정 'Field' 가 의무적으로 반드시 기입해야 하는 사항인지 아닌지 ('Required'/'Optional') 에 대한 설정

- 새로운 field configuration scheme 정의 ('Action' 버튼 → 'Use a different Scheme')

원하는 필드가 없을 때 , 필드 활성화하는 방법 제공


Project Mappings

★ 정의

'Project Mappings' 는 원하는 mapping 들을 프로젝트와 이슈에 연결시킬 수 있게 하는 기능으로 ,

일반적으로 Zendesk 와 연결하여 고객관리 서비스를 같이 제공받는다 . 아래 그림에서 알 수 있듯이 , JIRA

Admin 으로 들어간 후 , Cloud Connectors 를 통해 Zendesk 를 이용할 수 있다 . ( 부가적인 기능이므로

자세한 기능은 아래 사이트 참고 )

참고 : http://wiki.customware.net/repository/display/ZDJIRA/Configure+Mapping+Scheme


Components

★ 정의

'Components' 란 , 프로젝트를 세분화시킬 수 있는 단위로서 , 데이터 베이스 , 유저 인터페이스와 같은

'Component' 들을 정의하고 , 이에 따라 이슈들을 분류하는 데에 쓰인다 .


- 각 'Component' 를 정의하여 특정 이슈들을 해당 'Component' 에 대하여 분류

- 'Component' 에 속하는 이슈들을 처리할 'Assignee' 설정


Roles

★ 정의

'Roles' 란 , JIRA 내의 여러 유저들의 역할을 부여하여 접근 권한 등을 제어할 수 있는 기능이다 .


- 각 'Project Roles' 에 해당하는 유저 또는 그룹 전체 지정 가능


Permissions

★ 정의

'Permissions' 란 , 프로젝트와 관련하여 권한을 부여하는 기능으로 , ‘Issue’ 등의 생성 / 수정 / 해결 / 삭제

등의 기능을 각각 어떤 유저가 사용할 수 있는지 정의할 수 있어 용이하다 . 이 중에 'Issue' 에 관한 권한은 다음

장의 'Issue Security' 메뉴과 연결된다 . 다음은 'Permission' 메뉴를 통해 부여할 수 있는 접근 권한의

종류이다 .


- 기존 'Default Permission' 수정

- 위의 'Permissions' 의 종류에서 생성 / 수정 / 삭제 등의 각기 다른 기능에 대해서도 접근 권한을 세분화

- 새 'Permission Scheme' 의 정의 ( 새로운 'Permission Scheme' 을 이용하면 프로젝트마다 다른 접근

권한 부여 가능 )

• Permissions 의 종류- Project - Issue- Voters & Watchers- Comments- Attachments- Time Tracking


Issue Security

★ 정의

'Issue Security' 란 , 유저마다 볼 수 있는 이슈를 다르게 할 수 있는 보안 기능을 의미하며 , 이전 장의

'Permissions' 메뉴와 연결된다 . 아래의 첫 번째 그림과 같이 ' 프로젝트 _1' 내에서 ' 이슈 scheme1' 에

해당하는 이슈들을 'test' 라는 유저가 ' 보안 등급 1' 로 해당 이슈들을 볼 수 있게 된다 . 'Scheme' 을

정의하여 'Issue' 들을 분류하는 일은 'Issue Type Schemes' 메뉴에서 다룬다 .


- 현 프로젝트의 'Issue Scheme' 마다 다른 접근 권한을 부여

- 기존 보안 등급 수정 및 새로운 보안 등급 정의


Notifications

★ 정의

'Notifications' 란 , 프로젝트 내에서 특정 유저에게 다른 기능에 관한 공지를 할 수 있는 기능을 의미한다 .

공지의 종류에는 기본적으로 이슈 / 작업 / 로그 등이 있으며 , 이에 대한 생성 / 수정이 이루어졌을 때 알림이

가능하다 .

이 외에 오른편 그림과 같이 JIRA 홈페이지 내에서 'Announcement Banner' 를 이용할 수 있는데 , 이는

'JIRA Admin' 탭에서 'System' 메뉴를 이용한다 .


- 크게 나누어서 , 'Issue'/'Work'/'Issue Worklog'/'Generic Event' 에 관한 공지들을 볼 수 있는 유저 선택

- 'Notification Scheme' 을 이용하여 , 프로젝트마다 'Notification' 설정을 다르게 할 수 있다 .


Team Shortcuts

★ 정의

'Team Shortcuts' 란 , 프로젝트 아바타를 클릭했을 때 , 바로 연결할 수 있는 링크를 정의하는 기능으로 ,

왼쪽 그림의 프로젝트 아바타를 클릭하면 , 오른쪽의 화면이 뜨면서 정의한 'RELATED LINKS' 로 바로가기가

가능하다 .


- 'RELATED LINKS' 아래 나열될 링크의 이름 및 해당 URL 정의

- URL 제한 없음

Project Avatar 클릭 !


Issue Collectors

★ 정의

'Issue Collectors' 란 , JIRA 유저가 아니어도 웹사이트 또는 웹 어플리케이션에 왼쪽 그림과 같이 'Provide

Feedback' 버튼을 활성화하여 , 오른쪽 화면과 같이 피드백 / 버그 등을 알리는 기능이다 . 즉 , 외부에서

제기한 이슈들을 JIRA 내에서 관리할 수 있다 .


- 웹에서의 'Trigger Text'( 위 그림에서 Provide Feedback 메시지 ) 의 위치 설정

- Javascript 를 이용하여 웹 상에서 'Trigger Text' 의 trigger 방법 변경

- 'Trigger Text' 를 누른 후에 뜨는 창의 'Issue Collector Form' 과 'Template' 에 들어갈 'Field' 의 정의


Backup

화면 가장 오른쪽

위의 탭 →

왼편의 메뉴 중

'Backup Manager'

클릭

Backup 된 zip 파일은

https://jellypredev.atlassian.net/

webdav

에서 확인되며 , 디렉토리 접근 및 파일 관리는

다음 장에서 살펴보도록 하자 .

클릭 !


WebDAV Access

'WebDAV' 란 , Web Distributed Authoring and Versioning 의 약자이며 , World Wide Web

서버들에 저장된 파일들을 관리하는 데에 있어 , user 들간의 협업을 가능하게 하는 HTTP 의 확장이다 .

따라서 , JIRA 의 WebDAV 디렉토리에 접근하기 위해 , 가장 많이 쓰이는 Mac OSX 에서의 디렉토리

접근 방법의 설명은 다음 장에서 설명되며 , 다른 OS 에서는 다음 하이퍼링크를 참조하도록 한다 .

https://confluence.atlassian.com/display/JIRASTUDIO/Uploading+Data+via+WebDAV#UploadingDataviaWebDAV-AccessingyourWebDAVdirectoryinOSX

★ 단 , 위 링크의 Atlassian Guide 문서에서 제시된 WebDAV 서버 주소인

'https://<account>.jira.com/webdav' 는 업데이트 전의 주소이므로 , 반드시 아래 주소를 이용해야

한다 .

올바른 Server Address : https://jellypredev.atlassian.net/webdav/


Backup Process 1/2

3. 올바른 서버 주소 입력

1. Finder 를 연다 .

2. 위쪽 메뉴에서Go → Connect to Server...

4. JIRA 로그인 시 사용되는 관리자 계정 정보 입력


Backup Process 2/2

①

② ③

① : WebDAV root directory 로서 , JIRA 내에서 Backup Manager 를 통해 import 할 때는 ③의 파일을 본 디렉토리 (② 가 존재하는 영역 ) 로 옮겨야 한다 .

② : JIRA 업데이트 후에 새로 생긴 디렉토리이며 , Backup Manager 를 통해 백업된 파일을 가진다 .

③ : Backup Manager 를 통해 백업된 파일

5. Finder 에서 파일 관리

★ JIRA import

'Import' 는 'JIRA import' 메뉴를 이용하는데 , import 할 압축파일을 webdev 디렉토리로

반드시 옮긴 후 실행해야 JIRA 에서 해당 파일을 접근할 수 있다 .


User

III

1. 이슈 발견자

2. 이슈 할당자 (PM)

3. 이슈 해결자


이슈 발견자 1/5

이슈 발견 이슈 등록 이슈 할당

– 이슈 할당 –이슈를 할당할 사람을 모를 경우 ,

무조건 현 프로젝트의 Project Manager 에게 할당한다 .

이슈 흐름



클릭 !

OR

Keyboard Shortcut

알파벳 c 를 누른다 .

이슈 생성



해당 필드에 관한 설명으로 ,글씨체 및 기타 설정 방법 참고

미리보기

이슈 타입 설정

이슈의 우선순위

클릭 : 기한 설정

새 이슈를 해결할 사람 : PM 에게 할

당 !새 이슈를 등록한 사람

이슈 해결을 위한 예상 시간 - 표기법 : o주 o 일 o 시간

새 이슈를 해결하기 전까지 걸리는 예상 시간

- 표기법 : o주 o 일 o 시간

라벨 설정

관리자에 의해 필드는 변경될 수 있음 .

이슈 생성



클릭 !클릭 !

이슈 수정

① ②

③

이슈 수정



이슈 해결 전에 닫기

클릭 !

이슈를 취소하거나 불필요하다고 생각할 경우에는 이슈 해결 전에 이슈를 닫는다 .


이슈 할당자 1/2

이슈 흐름

나 (PM) 에게 할당된 이슈

Assign해결할 사람에게 재할당

– 이슈 할당 –

이슈를 최종적으로 해결할 사람에게 이슈를 할당한다 .



이슈 할당

클릭 !원하는 이슈 선택 !

재할당

① ②

③

④

이슈를 해결할 사람에게 재할당


이슈 해결자 1/6

이슈 흐름

– 이슈 관리 시 유의점 –1. 이슈를 재할당할 경우에만 Stop Progress 를 한 후에 재할당을 한다 .

(‘Stop Progress’ 를 누르면 Workflow 의 상태가 ‘ Open’ 으로 되는데 , 이는 이슈

를 처음 생성했을 때와 같은 상태이므로 , 재할당을 제외하고 쓰지 않는다 .)

2. 이슈를 Close 하기 전에 반드시 Resolve 를 시킨다 .

‘In Progress’

‘Start Progress’

↓‘Stop

Progress’

‘Resolve’ ‘Close’



이슈 해결하기 시작

클릭하면 , 상태 바뀜 .

이슈 해결하기

시작

다른 사람에게이슈 넘기기OR 이 경우 , ‘Stop Progress’ 를

누른다 .자세한 내용은 ‘재할당이 요구될 때’

페이지 참고 !

‘Start Progress’ 를 누른 후



이슈 해결 완료

클릭 !

해결 방법 선택

Reopen 가능해짐 .



이슈 완전히 닫기

반드시 Issue Resolve 후에 ,

( Reopen 가능한 상태 )



이슈 재할당이 요구될 때

– 이슈의 재할당 – 이슈를 해결하다가 다른 사람에게 이슈를 넘겨주거나 , 이슈가 자신에게 잘못 할당된

경우 , Issue 의 상태를 반드시 ‘ Stop Progress’ 로 바꾼 후에 , 알맞은 사람 또는

PM (PM 이 알맞은 사람에게 이슈를 맡길 수 있도록 ) 에게 이슈를 넘겨준다 .

※ ‘Open’ 상태는 이슈를 처음 생성했을 때와 같은 상태를 말한다 .

‘In Progress’

‘Start Progress’

↓‘Stop

Progress’

재할당을 통해

‘Open’ 상태로

초기화



이슈 할당

클릭 !원하는 이슈 선택 !

재할당

① ②

③

④

이슈를 해결할 사람에게 재할당



감사합니다 !

Jellycoaster Inc.Dev.team

Documents

Jira manual