Переезд с Jira на Жирус

Модель у Жируса та же, что у Jira, а REST API совместим с Jira Cloud. Поэтому переезд — это не конвертация форматов, а перенос данных тем же клиентом, которым вы уже пользуетесь.

1. Заведите пространство

Регистрация занимает минуту: почта, пароль и название команды. Подтвердите адрес почты из письма — без этого нельзя приглашать коллег.

2. Создайте проекты с теми же ключами

Ключ проекта — префикс в ключах задач. Если оставить его прежним, ссылки вида DEMO-42 в коммитах, документах и чатах останутся понятными. Тип проекта — Scrum или Kanban, как в Jira.

3. Перенесите задачи скриптом

Выпустите токен в Жирусе на странице «Токены API» и прогоните скрипт на jira.js или любом другом клиенте Jira. Пример переносит сводку, описание, тип и метки; так же переносятся комментарии, связи и журнал работ.

import { Version3Client } from 'jira.js';

// Один и тот же клиент читает из Jira и пишет в Жирус —
// отличаются только адрес и учётные данные.
const jira = new Version3Client({
  host: 'https://ваша-компания.atlassian.net',
  authentication: { basic: { email: 'you@example.com', apiToken: process.env.JIRA_TOKEN } },
});
const jirus = new Version3Client({
  host: 'https://jirus.ru',
  authentication: { basic: { email: 'you@example.com', apiToken: process.env.JIRUS_TOKEN } },
});

const { issues } = await jira.issueSearch.searchForIssuesUsingJqlEnhancedSearchPost({
  jql: 'project = DEMO ORDER BY created ASC',
  fields: ['summary', 'description', 'issuetype', 'labels'],
});

for (const issue of issues ?? []) {
  await jirus.issues.createIssue({
    fields: {
      project: { key: 'DEMO' },
      issuetype: { name: issue.fields.issuetype?.name ?? 'Task' },
      summary: issue.fields.summary,
      description: issue.fields.description,
      labels: issue.fields.labels,
    },
  });
}

Массовое создание — до 50 задач за вызов, не больше 10 массовых вызовов в минуту. Подробности о лимитах — в описании REST API.

4. Переключите интеграции

• Скриптам и CI достаточно сменить базовый адрес и токен.
• Вебхуки зарегистрируйте заново: адрес доставки должен быть публичным https. Жирус подписывает тело HMAC, если задан секрет.
• Экспорт выдачи поиска в CSV совместим с импортом Jira — путь обратно тоже есть.

5. Что останется в Jira

• Приложения Marketplace, Connect и Forge.
• Схемы разрешений: в Жирусе вместо них три роли в проекте и уровень доступа к проекту.
• Advanced Roadmaps.

Если что-то из этого критично, сравните продукты подробнее на странице «Жирус и Jira».