Jira 11.0 への準備
このドキュメンテーションは、既存のアプリと Jira Software Data Center 11.0、Jira Service Management Data Center 11.0 との互換性を確認したい Jira 開発者向けです。
最新バージョン
ここでは最新の EAP についての情報をご案内します。
EAP 06 は Jira 11 の最後の EAP です。
アプリケーション | 日付 | 数値 | バージョン (Maven) | ダウンロード |
|---|---|---|---|---|
Jira Software |
| 11.0.0-EAP06 | 11.0.0-m0015 | |
Jira Service Management |
| 11.0.0-EAP06 | 11.0.0-m0015 |
変更の概要
このセクションでは、導入予定の変更の概要を紹介します。アプリへの影響の検討にお役立てください。アップデートの準備が整ったら、実装のタイミングとマイルストーンが表示されます。
- Jira Software と Jira Service Management の共通機能
- サポート対象プラットフォームの変更
- LESS のサポート終了
- オリジナル テーマのサポート終了
- jQuery 2 migrate の削除
- アプリ署名を既定で有効化
- OpenSearch のための準備 (EAP02)
- Spring と Jakarta のアップグレード (EAP02)
- Tomcat プロトコルのアップデート (EAP02)
- ユーザー一覧表示の新しい REST エンドポイント (EAP 04)
- 非推奨コンポーネントの削除 (EAP 04)
- 日付フィールドのアップデート (EAP 04)
- TEXT エンティティ プロパティのソート (EAP 04)
- 非表示のフィールド値が保存されなくなる (EAP 04)
- 変更履歴インデックスのプレフィックス (EAP 04)
- 信頼できるアプリの削除 (EAP 04)
- グローバル シリアル化フィルター (EAP 05)
- AUI 10 での非推奨コンポーネントの削除 (EAP 05)
- REST エンドポイントにスコープを追加して、OAuth 2.0 2LO を使用する (EAP 05)
- 基本認証を既定で無効化 (EAP 05)
- WebWork におけるマルチパート処理の簡素化 (EAP 05)
- Jira Software の機能
- Advanced Roadmaps for Jira の新しいルック & フィール
- 非推奨のテキスト ガジェットの削除 (EAP02)
- 同期履歴でのリポジトリの健全性の確認 (EAP02)
- アバター エンドポイントの削除 (EAP 05)
- Rovo 用 Jira Data Center コネクタの導入 (EAP 05)
- Jira Service Management の機能
Jira Software と Jira Service Management の共通機能
インデックス構造の変更により、Jira 11 にアップグレードする際には完全なインデックス再作成を実行する必要があります。
サポート対象プラットフォームの変更
ステータス: 実装済み (EAP 01)
Jira 11 では、次のサポートが廃止されました。
- JDK 17
- PostgreSQL 15
- PostgreSQL 14
- PostgreSQL 13
- PostgreSQL 12
- MySQL 8.0
- Oracle 18c
- MSSQL Server 2017
そして、次のサポートが追加されました。
- JDK 21
- PostgreSQL 17
- MySQL 8.4 LTS
このバージョンの Jira は Java 21 でのみ実行されます。
LESS のサポート終了
ステータス: 実装済み (EAP 01)
セキュリティ、パフォーマンス、そして全体的な開発者体験を向上させるために、LESS Web リソース トランスフォーマーと LESS Maven プラグインの両方を廃止します。
CSS 変数を使用するようにルック & フィールがアップデートされます。すべてのスタイルは CSS になるか、ビルド時に CSS にコンパイルされます。また、Java ビルドとランタイムから LESS コンパイルが削除されます。ビルド時には、引き続き、LESS やその他の CSS プリプロセッサを使用できます。
LESS ファイルのランタイム変換をビルド時のコンパイルに置き換えるか、状況に応じてネイティブ CSS ファイルにまとめて移行することをお勧めします。
オリジナル テーマのサポート終了
ステータス: 実装済み (EAP 01)
新しいライト テーマとダーク テーマの導入により、アクセシビリティとユーザビリティが向上しました。それに伴い、テーマ スイッチャーからオリジナル テーマが削除され、Jira 11 でも完全に削除される予定です。
jQuery 2 migrate の削除
ステータス: 実装済み (EAP 01)
jQuery 2 migrate プラグインが削除されました。次の EAP では、すべての Data Center 製品で jQuery のバージョンを統一するために、jQuery 3 にアップグレードされる予定です。これは、古いバージョンの jQuery を含む製品に対して jQuery バージョンが大幅に強化されることを意味し、製品間アプリの開発が容易になります。
アプリ署名を既定で有効化
ステータス: 実装済み (EAP 01)
2 月にお知らせしたとおり、2025 年にアプリ署名がロールアウトされます。このリリースでは、アプリ署名は既定で有効化されます。この機能により、セキュリティが向上し、ローカル インスタンスにインストールされたものに対する顧客の信頼が高まります。
Atlassian Marketplace にアプリをアップロードしたら、後はアトラシアンにお任せください。Marketplace がアプリを検証して承認すると、アトラシアンはデフォルトですべてのアプリに署名し、それらを信頼します。追加の操作は必要ありません。アプリ署名はアプリの新規インストールにのみ影響し、以前にインストールされたアプリは検証されません。
非公開のビルドについて詳しくは、こちらの CDAC の投稿を確認してください。
OpenSearch のための準備
ステータス: 実装済み (EAP 02)
アトラシアンでは、他に依存しない検索ツール オプションの基盤構築に向けて、まずは抽象化レイヤーの追加に取りかかっています。この変更は、今後の OpenSearch サポートを実現するための鍵になります。新しい抽象化レイヤーでは、新しい検索 API が導入されます。検索とインデックス化のパフォーマンスは、既存の Lucene 実装と同じままです。詳細については、次の記事を参照してください。
Spring と Jakarta のアップグレード
ステータス: 実装済み (EAP 02)
高度なセキュリティ基準を維持し、依存関係を継続的にサポートして最新の状態に保つために、Spring を 6.x ラインにアップデートします。Spring 6 では、現在使用されている Jakarta 8 との互換性がなくなったため、Jakarta のバージョンも EE プラットフォーム 10、具体的には次のものにアップデートする必要があります。
- Jakarta Servlet 6.0
- Jakarta RESTful Web Services 3.1
- Jakarta Dependency Injection 2.0
- Jakarta Annotations 2.1
- Jakarta Activation 2.1
- Jakarta Mail 2.1
- Jakarta XML Binding 4.0
- Jakarta Bean Validation 3.0
Spring と Jakarta に依存する他のすべてのライブラリも更新しています。
Jakarta API の更新のために必要でない限り、アトラシアンの API には変更を加えません。Jakarta では、アプリに影響する可能性のある API の変更もいくつかあります。
既知の問題
アップグレード後に次の問題が発生する可能性があることが確認されています。アトラシアンではこれらの問題の解決に積極的に取り組んでいます。
- 次のプラグインが起動しません。
- Jira DVCS コネクター プラグイン (
com.atlassian.jira.plugins.jira-bitbucket-connector-plugin) - Atlassian Troubleshooting and Support Tools (
com.atlassian.troubleshooting.plugin-jira) - Jira Cloud Migration Assistant (
com.atlassian.jira.migration.jira-migration-plugin) - Atlassian Jira - プラグイン - ATST ヘルス チェック (
com.atlassian.jira.jira-atst-healthcheck-plugin)
- Jira DVCS コネクター プラグイン (
- Jira を起動したら、[管理] > [アプリの管理] でソフトウェア アプリを手動で有効にする必要があります。ソフトウェア アプリが機能しなくなる場合があり、[管理] > [アプリの管理] で再度有効にする必要があります。
- [リリース]、[レポート]、[コンポーネント] の各ページが機能しません。
- [課題]/[現在の検索] は機能しないものの、[課題]/[課題の検索] は機能します。
Tomcat プロトコルのアップデート
ステータス: 実装済み (EAP 02)
Jira に用意されているプロトコルがアップデートされ、Tomcat プロトコルの拡張としてパスワード暗号化がサポートされるようになりました。
Crowd プロトコル | Tomcat プロトコルに基づく | パスワード暗号化でサポートされる属性 |
|---|---|---|
com.atlassian.secrets.tomcat.protocol.Http11NioProtocolWithPasswordEncryption | Http11NioProtocol |
|
com.atlassian.secrets.tomcat.protocol.Http11Nio2ProtocolWithPasswordEncryption | Http11Nio2Protocol |
|
com.atlassian.secrets.tomcat.protocol.AjpNioProtocolWithPasswordEncryption | AjpNioProtocol |
|
com.atlassian.secrets.tomcat.protocol.AjpNio2ProtocolWithPasswordEncryption | AjpNio2Protocol |
|
APR/ネイティブ ライブラリと APR/ネイティブ コネクター (AJP と HTTP の両方を含む) は、Tomcat 10 で非推奨として指定されて Tomcat 10.1.x 以降では削除される予定です。具体的には、Http11AprProtocol (HTTP コネクター) と AjpAprProtocol (AJP コネクター) は非推奨です。そのため、これらは Jira 11 ではサポートされなくなりました。
- com.atlassian.secrets.tomcat.protocol.AjpAprProtocolWithPasswordEncryption
- com.atlassian.secrets.tomcat.protocol.Http11AprProtocolWithPasswordEncryption
ユーザー一覧表示の新しい REST エンドポイント
ステータス: 実装済み (EAP 04)
ユーザーを一覧表示する新しいエンドポイント https://{baseurl}/rest/api/2/user/list を導入します。
非推奨コンポーネントの削除
ステータス: 実装済み (EAP 04)
非 API コンポーネント com.atlassian.jira.component.pico.ComponentManager を削除します。
日付フィールドのアップデート
ステータス: 実装済み 重大な UI の変更 (EAP 04)
LocalDate は、エポックからの日数単位ではなく、エポックからのミリ秒単位で保存されるようになりました。影響を受けるフィールドは、期限、作業時間ログ日付、およびカスタム日付ピッカーです。この変更は、検索 API を介したデータ アクセスに対して透過的に行われます。
TEXT エンティティ プロパティのソート
ステータス: 実装済み 重大な UI の変更 (EAP 04)
TEXT エンティティ プロパティのソートをサポートしなくなりました。これは、既存の TEXT エンティティ プロパティにも適用されます。
複数のタイプで宣言されたエンティティ プロパティ
同じエンティティ プロパティが 1 回以上宣言されている場合、最初の宣言のみが考慮され、その後の宣言は無視されます。
下記の index-document-configuration モジュールでは、STRING プロパティのみが作成されます。
<index-document-configuration entity-key="IssueProperty" key="IssueProperty">
<key property-key="foo.bar">
<extract path="foo1.bar2" type="string" alias="fb">
</extract>
</key>
<key property-key="foo.bar">
<extract path="foo1.bar2" type="date">
</extract>
</key>
</index-document-configuration>com.atlassian.jira.search.issue.index.indexers.impl.IssuePropertyIndexExtractor パッケージの DEBUG のログ レベルを構成することで、プロパティが無視されているかどうかを確認できます。
非表示のフィールド値が保存されなくなる
ステータス: 実装済み (EAP 04)
以前のバージョンでは、非表示のフィールドはインデックス化されず、保存されるだけでした。Jira 11 では、こうした非表示フィールドの値の保存を停止しました。つまり、フィールド値が表示されていない場合は何の処理も行われません。
数値カスタム フィールドのパディングされた文字列フィールドも保存されなくなりました。該当するフィールドは string_customfield_xxxxx のようになります。
変更履歴インデックスのプレフィックス
ステータス: 実装済み 重大な UI の変更 (EAP 04)
変更履歴データは {jira-home}/caches/indexesV2/changes にある Lucene インデックスにインデックス化されています。現在、インデックス フィールドの名前には、変更履歴の影響を受ける Jira フィールドに対応したプレフィックスが付けられています。
たとえば、assignee フィールドと priority フィールドを含む変更履歴は、次のスニペットのようなドキュメントにインデックス化されます。
インデックス フィールド | 値 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Jira 11 では、インデックス フィールドの名前にプレフィックスが付かなくなりました。代わりに、値にプレフィックスが付きます。新しい構造では、上記の例のドキュメントは次のようになります。
インデックス フィールド | 値 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(数字は 19 文字にゼロパディングされます) |
アプリが現在、変更履歴インデックスを使用している場合 (履歴の変更を検索する場合など)、この新しいデータ構造を反映するようにクエリを調整する必要があります。
信頼できるアプリの削除
ステータス: 実装済み (EAP 04)
製品への安全でないエントリ ポイントの数を減らすために、信頼できるアプリが削除されます。アトラシアン製品間のこの情報交換方法は、業界のベスト プラクティスに沿った安全性の高いソリューション (OAuth 2.0 プロトコルなど) に置き換えられています。
グローバル シリアル化フィルター
ステータス: 実装済み (EAP 05)
Java の逆シリアル化、Velocity、XStream のセントラル ブロックリストに依存するグローバル シリアル化フィルターを実装します。このフィルターは、公開されているガジェット チェーンを通じてリモート コード実行 (RCE) に対して脆弱であると認識されている特定のクラスやパターンをブロックするように設計されています。
AUI 10 での非推奨コンポーネントの削除
ステータス: 実装済み (EAP 05)
デザインとアクセシビリティの問題があるいくつかの古い AUI 10 コンポーネントを削除する作業を進めています。必ず新しいバージョンに移行するか、Atlaskit に移行してください。
古い依存関係をいくつかアップグレードする作業も進めています。
- npm: dompurify を 2.5.7 から 3.1.6+ にアップグレードしました。この依存関係は、ツールチップのタイトルに内部的に使用されます。内部で使用されているバージョンを再利用しないでください。
- npm: jquery-form を 2.67 から 4.3.0+ にアップグレードしました。このアップグレードにより、jQuery 3 との互換性が向上します。
以下を廃止または削除する作業も進めています。
- テンプレート - AUI ドキュメント - 必要に応じて Soy または I18n システムに移行します。これにより、ツールでサポートする言語の数を減らし、自作のテンプレート言語によるセキュリティ問題の発生を防ぐことができます。
- ダーク モード (旧) - AUI ドキュメント - 新しいダーク テーマを導入したため、使用されていない古いダーク テーマを削除します。最近のガイド (「ダーク テーマに対応した Data Center アプリの準備」) に従い、デザイン トークンを使用してダーク テーマの準備を行った場合は、必要な準備がすべて完了しています。
- オリジナル テーマ - 「ライト」テーマに置き換わるため、すべてのフォールバック値が削除されます。
- ブラウザでネイティブにサポートされるようになった冗長なポリフィル (npm: css.escape、カスタム イベント、<input> プレースホルダーなど)。
- npm: @atlassian/tipsy - これはメンテナンスが終了しており、バージョン 9.3 以降の AUI ライブラリでは内部で使用していません。必要に応じてバンドルできますが、可能な場合は Floating UI (ツールチップ、ポップオーバー、ドロップダウンなどの作成) に移行するか、Atlaskit または AUI コンポーネントを使用することをお勧めします。
- npm: trim-extra-html-whitespace - これはメンテナンスが終了しており、公開ドキュメントで内部的にのみ使用されています。ブラウザには不要ですが、必要に応じてバンドルすることもできます。ただし、メンテナンスされている HTML ミニファイアを見つけることをお勧めします。
- 使用頻度が低く、名前が変更された Soy テンプレート、Web リソース、CSS クラス。
ほかには、Node 22 エンジンの要件が変更される予定です。これは、NPM 経由で AUI を使用する場合のみ影響し、実行中の製品には影響しません。
REST エンドポイントにスコープを追加して、OAuth 2.0 2LO を使用する
ステータス: 実装済み (EAP 05)
REST エンドポイントのセキュリティと制御を強化するために、@ScopesAllowed を導入しました。
@ScopesAllowed アノテーションをエンドポイントに追加し、OAuth 2.0 クライアント認証情報トークン (2LO) を使用してアクセスできるようにします。たとえば、このアノテーションでは、このエンドポイントへのアクセスを提供する前に、アクセス トークンに WRITE スコープが必要です。
@POST
@ScopesAllowed(requiredScope = "WRITE")
public void createEntity(...) {}受信リンクの Jira OAuth 2.0 スコープをご確認ください
基本認証を既定で無効化
ステータス: 実装済み (EAP 05)
基本認証による認証を既定で無効にする作業を進めています。これは、わずかに残るユースケースをサポートする代替手段を開発し、成熟させつつ、基本認証を完全に廃止するための第一歩です。
WebWork におけるマルチパート処理の簡素化
ステータス: 実装済み (EAP 05)
Jira で使用されなくなり、アプリでの使用を目的としていない以下のクラスを Jira と WebWork から削除しました。アプリがこれらのクラスを使用している場合、別のクラスにトランジションする必要があります。
com.atlassian.jira.web.TempFileRemovingMultipartRequestWrapper
webwork.multipart.PellMultiPartRequestJira Software の機能
Advanced Roadmaps for Jira の新しいルック & フィール
ステータス: 実装済み 重大な UI の変更 (EAP 01)
Advanced Roadmaps for Jira のユーザー インターフェイスに対するメジャー アップデートが展開されます。これらの機能強化により、プログラムおよびプラン全体でシームレスなエクスペリエンスが提供され、プロジェクトの表示と管理の方法の一貫性が確保されます。
新しい機能は次のとおりです。
- ユーザー インターフェイスを再構築し、管理機能とプログラム管理機能を改善することにより、より直感的なエクスペリエンスが実現されました。
- モダンで視覚的に魅力的なインターフェイスを提供するダーク テーマが実装されました。アプリの互換性をテストするには、[プロファイル]、[テーマ] の順に移動し、[ダーク] を選択してダーク テーマを有効にします。
これらの変更により、セキュリティとアクセシビリティに関する懸念が解決され、古いテクノロジーをアップデートすることで技術的負債も削減されました。
これらの変更は、Jira 11.0 より前にリリースされる予定の Jira 10.7 でも実装されます。
非推奨のテキスト ガジェットの削除
ステータス: 実装済み (EAP 02)
Jira 9.11 で非推奨になったダッシュボード用テキスト ガジェットが削除され、Jira のセキュリティを強化するためにリッチ テキスト ガジェットに置き換えられました。
同期履歴でリポジトリの健全性を確認
ステータス: 実装済み (EAP 02)
分散型バージョン管理システム (DVCS) の管理セクションに同期履歴を導入しています。これは、リポジトリ同期監査ログを一目で確認できる新機能です。これまで、管理者は過去のリポジトリ同期に関する重要な情報にアクセスできなかったため、同期プロセスの状態を評価したり、エラーをデバッグしたりするのが困難でした。
今後は、監査テーブルで過去 7 日間の詳細なリポジトリ同期のリストにアクセスできるため、問題のある領域の特定と切り分けに必要な時間が短縮されます。詳細には、開始時刻と終了時刻、同期ステータス、失敗の原因、期間、同期のタイプ (ソフトまたは完全) が含まれます。
リポジトリの同期履歴を確認するには、次の手順を実行します。
- [設定] > [アプリ] の順に移動します。
- [DVCS アカウント] に移動して、自分のアカウントを開きます。
- 確認するリポジトリの横にある [同期履歴を表示] を選択します。
アバター エンドポイントの削除
ステータス: 実装済み (EAP 05)
以下のエンドポイントを削除しました。
/rest/api/2/avatar/{type}/temporary/rest/api/2/avatar/{type}/temporaryCrop
代わりに、以下の既存の代替エンドポイントを使用してください。
/rest/api/2/universal_avatar/type/{type}/owner/{owningObjectId}/temp/rest/api/2/universal_avatar/type/{type}/owner/{owningObjectId}/avatar
Rovo 用 Jira Data Center コネクタの導入
ステータス: 実装済み (EAP 05)
Jira Data Center コネクタでは、Jira Data Center から Atlassian Cloud の Rovo へのデータ同期がシームレスに行われます。これにより、クラウドへの完全移行をすることなくクラウドベースの AI 機能を活用できます。
Rovo を利用すると、さまざまなプラットフォームから知識を集約することができるので、クラウドとデータ センター、および SharePoint や Slack などのサードパーティ ツールからの検索結果をまとめて表示することができます。既存のインフラストラクチャを維持しながら、Rovo チャットの AI の機能を活用したインサイトとパーソナライズされた応答で生産性を高めることができます。
近日公開: Rovo の統合検索と AI エクスペリエンスには、Jira Service Management Data Center のプロジェクトや課題を含めることもできます。
検索アプリ、チャット アプリ、スタジオ アプリ、エージェントを含む Rovo は、Jira、Confluence、Jira Service Management、または Teamwork Collection の Premium プランまたは Enterprise Cloud プランのお客様にご利用いただけます。新しいプランの設定についてサポートが必要な場合は、当社のチームにお問い合わせください。
すでに Rovo へのアクセス権をお持ちの場合は、こちらのガイドからステップバイステップの手順を参照してコネクタをセットアップしてください。
Jira Service Management の機能
カスタム フィールドのソート動作の変更
ステータス: 実装済み (EAP 01)
複数の値に対応したアセットおよび組織のカスタム フィールドのソート動作が変更されました。以前は、比較のためにすべての値が連結されていましたが、現在は最小値のみが使用されるため、アイテムの順序が変わる可能性があります。
この変更により、ソートの精度と一貫性が向上しています。対象となるのは、次のカスタム フィールドです。
- アセット オブジェクト
- アセット読み取り専用オブジェクト
- アセット オブジェクト (複数) (レガシー)
- アセットが参照するオブジェクト (複数)
- 組織
カスタム フィールド | Jira 11.0 より前のソート順序 | Jira 11.0 より後のソート順序 |
|---|---|---|
アセット関連 | 値はコンマで連結されていました。たとえば、値として そのため、降順でソートしたときに、値 | 比較には最小値のみが使用されます。たとえば、課題 PUBLIC-27 では、別の値が含まれている場合でも、値 そのため、降順でソートしたときに、値 |
組織 | 値はスペースで連結されていました。たとえば、値として そのため、降順でソートしたときに、値 | 比較には最小値のみが使用されます。たとえば、課題 YP-2 では、別の値が含まれている場合でも、値 そのため、降順でソートしたときに、値 |