> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-ja/she-ding/jira-tong-he/jira-no.md).

# Jira 統合の概要

{% hint style="warning" %}

#### 旧UI向けに作成

この記事は旧UI向けに作成されました。手順は今でも使用できますが、スクリーンショットは古くなっています。場合によっては、手順で参照されている項目が移動または変更されていることがあります。項目が見つからない場合は、 [どこに行ったのか](/devops/devops-ja/shii-uiux-heno/dokonittanoka.md) 記事。
{% endhint %}

## ![](https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) 概要

DevOps は、ブランチを組織にデプロイしたときにストーリーのステータスを自動更新するために、チームの Jira アカウントと連携します。これにより、Jira のワークフローステータスがリリースプロセスと一致した状態に保たれます。この統合により、どの組織へのデプロイがどの Jira ステータスに対応するか、またどのストーリーがどのブランチに関連付くかを制御できます。

### DevOps Jira 統合はどのように機能しますか?

Jira 統合を始めるには、Jira アカウントを DevOps に接続します。接続したら、Jira プロジェクトを統合に追加します。次に、設定を行います **ステータスマッピング** ブランチを特定の組織にデプロイしたときに、ストーリーがどの Jira ステータスに更新されるかを定義します。たとえば、Development 組織を **進行中**、Testing 組織を **レビュー中**に、Production 組織を **完了**にマッピングします。これらの手順を完了する方法については、次の記事を参照してください。

* [Jira 統合の追加](/devops/devops-ja/she-ding/jira-tong-he/jira-no-1.md)
* [Jira 統合へのプロジェクト追加](/devops/devops-ja/she-ding/jira-tong-he/jira-henopurojekuto.md)
* [Jira プロジェクトの設定](/devops/devops-ja/she-ding/jira-tong-he/jira-purojekutono.md)

デプロイ中にどのストーリーを更新するかを制御するには、ブランチの **関連ストーリー** リストに追加します。そのブランチをデプロイすると、DevOps は **ステータスマッピング** に基づいて関連するすべての Jira ストーリーを自動的に更新し、手動更新なしでストーリーステータスが配信の進捗を正確に反映するようにします。ブランチにストーリーを追加する方法については、次の記事を参照してください。

* [ブランチへの Jira ストーリーの追加](/devops/devops-ja/she-ding/jira-tong-he/buranchiheno-jira-sutrno.md)

{% hint style="info" %}

#### ベスト プラクティス

* 複数の Jira インスタンスを接続する場合は、統合名をそれぞれ別にしてください。
* Jira ワークフローに合わせて、環境ごと（Dev、QA、Prod）に個別のステータスマッピングを作成します。
* Jira のワークフローステータスをリリースプロセスに合わせます。例: 進行中 → レビュー中 → 完了。
* 各マッピング変更後に設定を保存し、デプロイが正しい更新をトリガーするようにします。
  {% endhint %}

#### Jira 統合の例

下の図は、サンプル構成とワークフローを使用して Jira 統合がどのように機能するかを示しています。以下の **構成** と **ワークフロー** セクションの説明を参照してください。

* **構成**
  * ステータスマッピング
    * **Dev** org が **進行中**
    * **Test** org が **レビュー中**
    * **Prod** org が **完了**
  * ブランチ関連ストーリー
    * **DO-1 Feature** と **DO-3 Bug2** のストーリーは **NewVersion** ブランチ
  * Jira プロジェクト
    * この例の Jira プロジェクトにあるすべてのストーリーを一覧表示します。
* **ワークフロー**
  * 次のときに何が起こるかを示します **NewVersion** ブランチが **Dev** 組織。
  * 次のときに何が起こるかを示します **NewVersion** ブランチが **Test** 組織。
  * 次のときに何が起こるかを示します **NewVersion** ブランチが **Prod** 組織。

<figure><img src="https://225042527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F22KkfCFyR3ibrrVrPuyI%2FFlosum%20DevOps%20Jira%20Integration%20Overview.png?alt=media&amp;token=9e9aae41-8d2b-4fe8-a0a0-85504f425ced" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-ja/she-ding/jira-tong-he/jira-no.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
