# 마인드맵으로 Jira 릴리스 계획하기

현재 Jira 프로젝트의 미릴리스 버전을 확인하고, 할당된 이슈를 마인드맵으로 가져와 공유 릴리스 런북에서 배포 작업을 조율하세요.

## 시작하기 전에

필요한 항목은 다음과 같습니다.

- Jira 프로젝트와 이슈를 볼 수 있는 권한
- 릴리스 이슈를 추가하려는 경우 편집할 수 있는 마인드맵
- 릴리스 아래에 표시하려는 경우 Jira에서 **수정 버전**​이 이미 할당된 Jira 이슈

릴리스 패널은 현재 Jira 프로젝트를 사용합니다. Mind Map Studio에서 릴리스를 계획하기 전에 Jira에서 버전을 만들고 **수정 버전**​을 할당하세요.

## Jira 릴리스 열기

1. 마인드맵 헤더에서 **Jira 릴리스**​를 선택합니다.
2. 미릴리스 Jira 버전이 로드될 때까지 기다립니다.
3. 계획하려는 버전을 찾습니다.

각 버전 카드의 **연결된 이슈**​에는 Jira에서 해당 버전에 이미 할당된 Jira 이슈가 표시됩니다. Mind Map Studio에서 별도로 저장하는 계획 작업은 **릴리스 런북 및 메모**​에서 관리할 수 있습니다.

다음 카드는 Jira의 **수정 버전** 필드를 통해 Jira 이슈가 할당된 미릴리스 버전을 보여 줍니다.

![정리된 Jira 이슈 하나가 할당된 미릴리스 버전 3.0.0.](/api/media/mindmap-media/ko/jira/release-planning/release-overview-populated-dark.webp)

## 비어 있는 릴리스 이해하기

Jira 이슈가 아직 할당되지 않은 미릴리스 버전도 유용할 수 있습니다. 이 경우 버전에 **이 릴리스에 할당된 Jira 이슈가 없습니다**​라고 표시됩니다. 그래도 태그를 추가하고 배포 런북을 작성할 수 있습니다.

다음 스크린샷은 의도적으로 정상적인 빈 상태를 보여 줍니다. 로드에 실패한 것이 아닙니다. 버전 3.0.0에 할당된 Jira 이슈, Mind Map Studio 태그 또는 배포 단계가 아직 없을 뿐입니다.

![버전 3.0.0에 할당된 이슈가 없음을 보여 주는 미릴리스 Jira 버전 카드.](/api/media/mindmap-media/ko/jira/release-planning/release-overview-empty-dark.webp)

![할당된 Jira 이슈, 태그 또는 배포 단계가 없는 빈 릴리스 런북.](/api/media/mindmap-media/ko/jira/release-planning/release-runbook-empty-dark.webp)

## 할당된 이슈를 마인드맵에 추가하기

1. 이슈의 마인드맵 상위 항목이 될 아이디어를 선택합니다.
2. **Jira 릴리스**​에서 Jira 버전을 찾습니다.
3. **연결된 이슈**​에서 이슈를 찾습니다.
4. 이슈 위에 포인터를 놓고 더하기 버튼을 선택합니다.

Mind Map Studio가 Jira 키와 요약이 포함된 하위 카드를 추가합니다. 릴리스 패널의 이슈를 캔버스로 드래그하여 상위 항목이 될 아이디어 근처에 놓을 수도 있습니다.

카드를 추가하면 마인드맵만 변경됩니다. 이슈의 **수정 버전**​을 할당하거나 변경하지 않으며, 이슈를 편집하거나 Jira 이슈 링크를 만들지도 않습니다.

## 릴리스 목록 새로 고침하기

Jira에서 버전이나 이슈 할당이 변경되면 패널 위쪽의 **Jira 릴리스 새로 고침**​을 선택합니다.

새로 고침하면 Jira Cloud에서 현재 미릴리스 버전과 할당된 이슈를 요청합니다. **릴리스 런북 및 메모**​를 열면 해당 프로젝트와 버전에 대해 저장된 Mind Map Studio 런북을 불러옵니다. 새로 고침은 Jira의 어떤 항목도 변경하지 않습니다.

이슈가 여전히 표시되지 않으면 Jira에서 해당 이슈를 열고 **수정 버전** 필드에 현재 프로젝트의 예상 버전이 포함되어 있는지 확인하세요.

## 릴리스 런북 만들기

1. **Jira 릴리스**​에서 Jira 버전을 찾습니다.
2. **릴리스 런북 및 메모**​를 선택합니다.
3. 배포 단계를 입력한 다음 **Enter**​를 누르거나 추가 버튼을 선택합니다.
4. 팀이 완료해야 하는 순서대로 나머지 단계를 추가합니다.

“프로덕션 백업 확인”, “앱 배포”, “스모크 테스트 실행”처럼 짧고 행동 중심적인 단계를 사용하세요. 런북은 이 Jira 프로젝트와 릴리스에 속하므로 같은 릴리스에서 작업하는 다른 사용자도 동일한 순서를 따를 수 있습니다.

## 런북 정리 및 완료하기

- 확인란으로 단계를 완료 처리합니다.
- **단계를 위로 이동** 또는 **단계를 아래로 이동**​을 사용하여 배포 순서를 변경합니다.
- 더 이상 필요하지 않은 단계는 **단계 삭제**​로 제거합니다.
- 완료된 단계 수와 진행률 표시줄에서 런북의 완료 정도를 확인합니다.

진행률은 Mind Map Studio 런북 단계를 나타냅니다. Jira 릴리스 상태나 Jira 이슈 상태는 변경하지 않습니다.

## 런북 태그 추가하기

**태그 추가**​를 사용하여 `backend`, `mobile`, `approval` 같은 짧은 표식을 만듭니다. 배포 단계를 작성하는 동안 `/`를 입력하여 태그를 만들거나 삽입할 수도 있습니다.

이 태그는 릴리스 런북을 정리하기 위한 Mind Map Studio 태그입니다. Jira 라벨이 아니며 연결된 Jira 이슈에 기록되지 않습니다.

## 결과 확인하기

다음 조건을 충족하면 릴리스 계획이 준비된 것입니다.

- 예상한 미릴리스 Jira 버전이 **Jira 릴리스**​에 표시됩니다.
- **연결된 이슈**​가 Jira에서 해당 버전에 이미 할당된 이슈와 일치합니다.
- 마인드맵에 추가한 이슈가 Jira 연결 카드로 표시됩니다.
- 런북 단계가 의도한 순서로 정렬되어 있습니다.
- 단계를 완료 처리하면 완료된 단계 수가 변경됩니다.

## Jira와 Mind Map Studio에 각각 유지되는 항목 알아보기

- **Jira 릴리스**​는 Jira 버전을 만들거나 편집하지 않습니다.
- 이슈의 **수정 버전**​을 할당, 제거 또는 변경하지 않습니다.
- Jira 릴리스 날짜를 표시하지 않습니다.
- 릴리스 런북은 Mind Map Studio에서 저장하며 Jira 버전 설명으로 복사되지 않습니다.
- 런북 태그는 Jira 라벨이 아닙니다.
- 연결된 이슈를 마인드맵에 추가해도 Jira 이슈는 편집되지 않습니다.

버전을 만들거나, 릴리스 날짜 또는 릴리스 상태를 설정하거나, 설명을 편집하거나, 이슈를 버전에 할당해야 할 때는 Jira를 사용하세요. Jira에서 변경을 마쳤으면 Mind Map Studio로 돌아와 새로 고침한 후 변경 사항을 중심으로 시각적인 계획을 세우세요.

## 문제 해결하기

### 버전이 표시되지 않는 경우

패널에는 현재 Jira 프로젝트의 미릴리스 버전이 표시됩니다. 예상한 프로젝트에 있는지 확인하고 버전이 이미 릴리스되지 않았는지 확인한 다음 **Jira 릴리스 새로 고침**​을 선택하세요.

### 할당된 이슈가 표시되지 않는 경우

Jira에서 이슈를 열고 **수정 버전** 필드를 확인합니다. Jira가 할당을 저장한 후 Mind Map Studio로 돌아와 릴리스 목록을 새로 고치세요.

### 추가 버튼을 사용할 수 없는 경우

먼저 마인드맵에서 편집할 수 있는 아이디어를 선택하세요. 선택한 아이디어가 새 카드의 마인드맵 상위 항목이 됩니다.

## 관련 안내서

- [기존 Jira 이슈를 마인드맵에 추가하기](./add-existing-issues.md)
- [Jira에서 변경되는 항목 알아보기](./what-changes-in-jira.md)
- [마인드맵 만들고 편집하기](../building-and-editing.md)