11
документация JIRA коммерческая система отслеживания ошибок, предназначена для организации общения с пользователями, хотя в некоторых случаях систему можно использовать для управления проектами. Разработана компанией Atlassian Software Systems. Оглавление 1.Описание 2. Установить 3. Учимся шагать Cоздание проекта Управление проектом Создание описания (Issue) Работа с описанием (Issue) 0. Полезные ссылки Автор: Сергей Карашевич e-mail: [email protected] дата: 21/10/2012 def

JIRA documentation

Embed Size (px)

DESCRIPTION

How to install JIRA to your computer. First steps at bug-tracker

Citation preview

Page 1: JIRA documentation

документация

JIRA — коммерческая система отслеживания ошибок, предназначена для организации

общения с пользователями, хотя в некоторых случаях систему можно использовать

для управления проектами. Разработана компанией Atlassian Software Systems.

Оглавление

1.Описание

2. Установить

3. Учимся шагать

Cоздание проекта

Управление проектом

Создание описания (Issue)

Работа с описанием (Issue)

0. Полезные ссылки

Автор: Сергей Карашевич

e-mail: [email protected]

дата: 21/10/2012

def

Page 2: JIRA documentation

1. Описание.

Как описано в определении JIRA подходит не только для отслеживание ошибок, но и для

управления проектом в целом. На самом деле JIRA является реализацией ALM (Appication

Lifecycle Management), однако это достигается путем добавления прочих инструментов

для работы с проектом, таких как GreenHopper, BonFire, Gliffy, Bitbucket, Bamboo. Однако в

данном случае мы остановимся именно на функции bugtracking.

JIRA имеет веб-интерфейс, при этом серверная часть может располагаться на локальном

сервере, либо в облаке Atlassian. В последнем случае возможно интегрировать работу с

Google документами, календарем и почтой через Google Apps. Однако для этого

необходимо привязывать аккаунт к кредитной карточке, что не очень-то и хорошо,

поэтому ограничимся версией, которую нужно устанавливать локально.

Итак, для изучения возможностей JIRA давайте установим ее локально на свой компьютер

и попробуем базовые действия. Для этого идем на сайт разработчика и переходим в

область продуктов: http://www.atlassian.com/software/jira/overview. Скачиваем JIRA и

ставим ее локально.

2. Установить. Итак, выбираем соответствующий нашей операционной системе дистрибутив и

выполняем процесс установки:

Рисунок 1

Page 3: JIRA documentation

Следуем всем советам установщика. Везде жмем next, так как установщик плохого не

пожелает. Нам предложат использовать JIRA как сервис (SaaS), это означает всего лишь,

что сервер на локальной машине будет запускаться при перезагрузке компьютера

автоматически.

Из важного : необходимо создать базового пользователя-администратора для управления

JIRA.

3. Учимся шагать. Давайте теперь поймем, что же мы поставили и как с этим работать. Вся работа будет

происходить в браузере. Данные примеры взаимодествуют с локальным сервером,

однако в случае с удаленным сервером все аналогично.

Первым делом нам необходимо создать свой проект. Хотя при первом запуске JIRA может

и спросить заботливо про создание проекта - давайте смело отказываться.

Создание проекта

Первым делом открываем наш сервис, в данном случае просто переходим в браузере по

следующему URL: http://localhost:8080/secure/Dashboard.jspa

Рисунок 2

Page 4: JIRA documentation

Выбираем в правом верхнем углу Administration. И теперь появляется страница

администрирования JIRA. Здесь нам как раз и предлагают создать проект от чего мы

отказываться и не будем:

Рисунок 3

появляется окно, где указываем название проекта. Для демонстрации возможностей

проект было решено назвать ”TestProject”:

Рисунок 4

жмем Add и получаем наш первый проект “TestProject”.

Теперь мы оказываемся на странице проектов. Отсюда можно просматривать общую

сводную информацию относительно состояния проектов (Рисунок 5). Давайте

познакомимся с этой страницей более подробно, так как она несет в себе всю мощь

продукта JIRA.

Page 5: JIRA documentation

Рисунок 5

Page 6: JIRA documentation

Менеджмент проекта

Давайте пробежимся по вкладкам, которые отображаются слева, чтобы понимать, что

именно они означают:

Рисунок 6

Summary на этой вкладке отображаются все функции и инструменты по работе с проектом.

Issue1 types (типы описаний) на этой вкладке отображаются все доступные типы описаний,

которые можно указывать в данном проекте. Вы можете отредактироовать уже существующие

типы или добавить свой собственный тип.

Workflows2 (техпроцессы) на этой вкладке отображаются описание всех техпроцессов. Вы

можете отредактироовать уже существующие техпроцессы или добавить свой собственный

техпроцесс.

Screens на этой вкладке можно редактировать схему типов описаний. (! лучше здесь ничего не

трогать!)

Fields (поля) на этой вкладке можно настроить поля для различных типов описаний.

Рисунок 7

People это очень важная вкладка для менеджмента всех людей, которые могут работать с

проектом. Здесь можно добавить пользователей, удалить пользователей.

1 Issue в данной документации будет переводитьтся на русский язык, как “описание”.

2 Workflow в данной документации будет переводитьтся на русский язык, как “техпроцесс”.

Page 7: JIRA documentation

Permissions на этой вкладке происходит создание и редактирование ролей, изменение прав

для пользователей и задач, с которымим они могут работать. Влючает в себя (Project Permissions,

Issue Permissions, Voters & Watchers Permissions, Attachments Permissions, Time Tracking

Permissions)

Issue security управление безопасностью описаний. (Надо изучить)

Notifications управление уведомлениями.

Рисунок 8

Versions служит для управления версий, если наш проект втечение развития имел несколько

версий.

Components управление компонентами проекта, такими как база данных и прочее.

Issue collectors сборщик предложений. Полезная утилита, которая собирает предложения со

сторонних сайтов.

Создание описаний (Issue)

Давайте теперь научимся создавать собсвтенные предложения. К примеру, мы

обнаружили, что в нашей программе при нажатии на кнопку “Все хорошо” - ничего не

происходит.

Для начала следует не забыть выйти из режима администратора. Для этого жмем “Exit

Administration”, как показано на рисунке (Рисунок 9):

Рисунок 9

Далее переходим на вкладку Issues и в верхней области нажимаем кнопку + Create Issue

(как показано на Рисунок 10).

Page 8: JIRA documentation

Рисунок 10

Появляется окно создания описания (Рисунок 11). На самом деле JIRA предоставляет

возможность редактировать описания и возможно для простого проекта полей по

умолчанию даже слишком много. Однако, давайте рассмотрим основные поля

стандартного описания.

Рисунок 11

Project обязательно нужно выбрать проект, к которому добавляется описание.

Issue type теперь необходимо выбрать тип описания. В JIRA используется следующие

стандартные типы описания: Bug, Task, New Feature, Improvement.

Summary непосредственно краткое описание описания (Issue).

Priority приоритет, на сколько срочно следует выполнять данное описание.

Page 9: JIRA documentation

Due date установленный срок. До какого врмени должно выполняться задание.

Assignee назначаемое лицо или тот, кто должен решать задачу, то есть описание.

Reporter кто создает данное описание.

Environment среда, в которой выполнялся процесс. Например, операционная система,

виртуальная машина, IDE...

Description непосредственно само подробное описание.

Original estimate оценка врмени, которую вы считаете изначально для решения этого описания.

Remaining estimate оценка врмени, сколько вы считаете еще осталось для решения этого

описания.

Также вы можете присоединить к этому описанию какие-нибудь файлы. Итак вернемся к

нашей проблеме. Наша кнопка “Все хорошо” почему-то не работает. Давайте заполним

наше описание:

Project TestProject.

Issue type Bug

Summary Не рабоает кнопка “Все хорошо”

Priority приоритет поставим Minor, потому что, вроде из-за этого программа не сыпется.

Due date ставим срок до завтра, например.

Assignee выбираме нас самих.

Reporter выбираме нас самих.

Environment Windows 7, IntelliJ IDEA

Description при нажатии на кнопку “Все хорошо” ничего не происходит

Original estimate 1d

Remaining estimate 1d

А теперь нажнем кнопку Create. При хорошем исходе JIRA нас уведомит всплывающим

окном, что описание создано (Рисунок 12).

Рисунок 12

Page 10: JIRA documentation

Работа с описанием (Issue)

Отлично, теперь у нас есть описание о том, что кнопка “Все хорошо” почему-то не

работает и мы как исполнитель будем активно бороться с этой багой. В первую очередь

надо оповестить всех, что вы начали заниматься этой задачей.

Чтобы об этом все узнали, надо изменить описание (Issue). Для этого сначала его нужно

найти. Есть несколько способов. Самый простой - идем по вкладке Issues и выбираем его

среди недавних (Рисунок 13). Второй вариант это сделать поиск по всем описаниям и найти

существующее по меткам (labels), ключевым словам или типу.

Рисунок 13

Допустим мы воспользовались первым способом и хотим теперь изменить статус у

нашего описания (Issue). Для этого надо нажать на кнопку Start process на панели

управления описанием (Issue) :

Рисунок 14

Отлично, теперь все узнали, что вы занимаетесь этим процессом. Далее, например, в ходе

наших исследований оказалось, что кнопка вообще не нажимается. И тогда мы хотим об

этом сказать и перенаправить ее человеку, который ответственный за нажатие кнопок

(GUI юзабилиста), а не за их выполнение (программиста логики кнопок).

Тогда смотрим на страницу, на которой мы продолжаем оставаться (Рисунок 15). Если мы

хотим изменить исполнителя, то это можно сделать, выбрав человека из списка (отметка

1). Если хотим добавить комментарий, что не кнопка “Все хорошо” вовсе не нажимается

то необходимо нажать кнопку Comment. Наконец можно изментить приоритет и тип

соответственно.

Page 11: JIRA documentation

Рисунок 15

Наконец, если вы посчитали, что кнопка “Все хорошо” не должна нажиматься, или,

скажем, ее вовсе и не должно быть в нашем проекте. То нужно закрыть описание (Issue).

Для этого необходимо нажать кнопку Resolve Issue.

Теперь необходимо выбрать тип закрытия описания (решена, не решена, уже была,..):

Рисунок 16

0. Полезные ссылки. 1. Официальный сайт Atlassian JIRA

1 2