Jira Software 10.3.x アップグレード ノート

Jira Software 10.3.x 長期サポート (LTS) へのアップグレードに関する重要な注意事項は次のとおりです。

アップグレード ノート

Jira Software 10.3.x は長期サポート (LTS) リリースです。通常、LTS リリースでは新機能を導入しませんが、前回の LTS リリース (Jira 9.12.0) 以降に導入した機能を統合します。

この要約は、深刻度および種類によって変更点をセクション分割しています。

• 重大な変更
• このリリースで導入された変更
• 改善、修正、および、重大な変更以外の変更

重大な変更

停止や混乱を避けるために注意すべき点について確認してください。このセクションの内容は、新しいものから古いものへと時系列に整理されています。

Jira 10.2: 2 段階認証による新しいログイン エクスペリエンス

Jira ログイン エクスペリエンスのセキュリティを向上させるために、2 つ目の認証レイヤーを追加しました。新しいログイン プロセスで問題が発生した場合は、JVM システム プロパティ atlassian.authentication.legacy.mode を true に設定することで、従来のログイン エクスペリエンスに切り替えられます。

Jira 10.2: データベースのパスワードをシークレット ストレージに安全に保管

データベースのパスワードを保護するためにシークレット ストレージを使用します。アップグレード後、またはゼロダウンタイムのアップグレード (ZDU) 中に、dbconfig.xml ファイルからパスワードを読み取り、暗号化してシークレット ストレージに保存し、dbconfig.xml ファイルのパスワードをプレースホルダー {ATL_SECURED} に置き換えます。

Jira 10.1: 利用状況データを共有する

インスタンスの利用状況データをアトラシアンと共有する新しい方法を導入しました。アナリティクス機能は利用状況データの共有になり、ユーザーがアトラシアンと共有する内容をより細かく制御できるようになりました。

Jira 10.0: フロントエンド API の変更

このリリースでは、Jira Data Center フロントエンド API の「Code sharing」セクションが改善、アップデートされました。次の変更を導入しました。

• リクエストされた Jira イベントなど、Jira 固有の API モジュールを追加。
• 共有ライブラリの拡張とアップデート。
• 共有ライブラリとエイリアス モジュール タイプの特定のバージョン管理を導入。
• UPM レベルのモジュールへの注釈およびコード内のより良い説明。

Jira 10.0: 以前に廃止された機能フラグの削除

次の機能フラグを削除しました:

• com.atlassian.jira.agile.darkfeature.burnupchart
• optimistic.transitions
• com.atlassian.jira.advanced.audit.log
• velocity.chart.ui
• jira.quick.search
• com.atlassian.jira.custom.csv.escaper
• atlassian.cdn.static.assets
• jira.users.and.roles.page.in.react

以前はこれらの機能フラグの背後にあったすべての機能が、既定で有効化されました。

Jira 10.0: Java API に関する後方互換性のない変更

いくつかの廃止されたメソッドとクラスを削除しました。さらに、署名とリターン タイプの変更に関連するメソッド群を調整しました。変更の完全な一覧を確認してください。

Jira 10.0: REST API に関する後方互換性のない変更

Jira Software 9.x 以降で廃止された、1 組の REST API のエンドポイントを削除しました。変更の完全な一覧を確認してください。

Jira 10.0: 依存関係の削除

いくつかの依存関係へのアクセスを削除しました。変更の完全な一覧を確認してください。

Jira 10.0: バイナリ インストーラーの削除

Jira 10.0 から、.bin と .exe のインストーラーは提供されなくなります。引き続き .zip と .tar.gz ディストリビューションを使用して Jira をインストールできます。

Jira 10.0: データベース スキーマのアップデート

changegroup、jiraissue、jiraaction テーブルの created 列をアップデートし、ミリ秒単位の精度をサポートしました。この変更は Oracle と MySQL のデータベースにのみ影響します。お客様側での特別な操作は不要です。再起動時にスキーマは自動的に移行されます。

Jira 10.0: H2 データベース エンジンのサポートを終了

H2 データベースと H2 ライブラリそのもののサポートを Jira のディストリビューションから削除しました。複数のセキュリティ脆弱性に対応するため、H2 データベース エンジン用の JDBC ドライバーは Jira にバンドルされなくなります。また、H2 の組み込みデータベースを使って Jira 10.0 を評価することもできなくなります。

Jira 10.0: JDK 17 の導入、Java 8 と 11 のサポート終了

Jira 10.0 は Java 16 言語レベルの JDK 17 で再コンパイルされています。つまり、今後 Jira を下位の Java バージョン (8 と 11) で実行することはできなくなります。

Jira 9.17: アプリケーション リンクで Client Credential Grant Flow (CCGF) のサポートを開始

Jira 9.17 では、メール認証用の新しい外向き OAuth 2.0 連携として Client Credential Grant Flow (CCGF) がサポートされています。CCGF は Authorization Code Grant と異なり、アプリケーション同士の接続をユーザーが手動で認証して承認する必要がないため、直接的なユーザー インタラクションが行えない状況に適しています。

Jira 9.16: バックアップを S3 オブジェクト ストレージに安全に保存

Jira Data Center インスタンスを AWS で実行している場合、バックアップをご利用のアプリケーションのローカル ファイルシステムではなく Amazon S3 オブジェクト ストレージに安全に保存できるようになりました。

Jira 9.15: バックアップ エクスポート ディレクトリの新しい場所

Jira Software 9.15.0 の時点では、既定のバックアップ エクスポート ディレクトリが <jira-home-dir>/export to <jira-home-dir>/export/backups から変更されました。<jira-home-dir> は Jira の shared ホームディレクトリです。エクスポート ディレクトリは、データ パイプラインとサポート zip で使用される汎用ディレクトリとなります。

Jira 9.15: Jira にアップロードできるファイル拡張子を制限

Jira インスタンスや組織のインフラストラクチャをマルウェアの脅威から保護するために、管理者は不要なファイル拡張子が課題を通じてアップロードされないように制限できるようになりました。特定のファイル形式を制限するには、禁止または許可すべきファイル拡張子のブロック リストまたは許可リストを作成する必要があります。

Jira 9.15: websudo の許可リストでセキュリティを強化する

websudo 操作のセキュリティ層を追加するために、Jira 用の独自の IP アドレス/サブネット許可リストを構成し、有効化できます。つまり、特定のスーパーユーザー操作を、事前に承認済みの IP アドレスからのみ実行できるようになります。

Jira 9.15: Confluence ページ ガジェットに代わる Confluence ページ ビューアー

従来の人気のある Confluence ページ ガジェットを新しい Confluence ページ ビューアーで置き換えました。この新しいガジェットはモダンかつセキュアな技術スタック上に構築されており、全体的なエクスペリエンスを向上させるために複数の UI 改善が含まれています。これまでのものと同様に、Confluence ページ ビューアーを利用して、リンクされた Confluence Data Center サイトのページを Jira ダッシュボードに埋め込むことができます。

Jira 9.14: Universal Plugin Manager を利用したアプリのインストール

Universal Plugin Manager (UPM) を使用すると、アトラシアン アプリやサードパーティ製アプリを Jira やその他の Data Center 製品に 3 つの方法でインストールできます。

• [アプリの管理] ページの [アプリのアップロード] ボタンを利用し、アプリの URL を提供するかアプリのファイルをアップロード。
• REST API (/rest/plugins)。
• [新しいアプリを発見] ページの [インストール] ボタン。

Jira 9.13: 常にコメントを古い順または新しい順に表示

Jira はユーザーが希望するコメントの並べ替え順序を記憶するようになりました。課題上のコメントをどのように表示するか (最新のものからか、古いものからか) を一度選択すると、あとは同じようにソートされます。

Jira 9.13: データベース パスワードを HashiCorp Vault に保存して保護

パスワードを HashiCorp Vault に保存して保護管理者がSecretStore プラグインを有効にして、Vault インスタンスからデータベース パスワードを読み取れるようになりました。これは、データベースのパスワードをプレーン テキストとして XML ファイルに保存するための、より安全な代替方法です。

このリリースで導入された変更

ダーク テーマを正式に提供

過去に、一部のサポート対象外領域を含むベータ版のダーク テーマを部分的に実装しました。コンテンツを読みやすくし、作業環境全体で視覚的な調和を実現する新しい体験をお楽しみください。また、ビジュアルが向上するため、目の疲れが軽減されます。今すぐお試しください: [プロファイル] > [テーマ] に移動し、[ライト]、[ダーク]、または [システムに一致] を選択します。

最後のマイルストーンとして、プラン機能のビューでもダーク テーマを利用できるように積極的に取り組んでいます。しばらくお待ちください。

ライト テーマが新しいデフォルトになります

Jira 10.3 では、オリジナル テーマに代わり、ライト テーマがデフォルトになります。オリジナル テーマは廃止されます。これは、Jira の既定のルック & フィール設定がライト テーマと一致していることを意味します。オリジナル テーマはこれ以上サポートされなくなるため、ライト テーマを採用することをお勧めします。

このリリースでバイナリ インストーラーが利用可能に

Jira 10.3 のリリースとそれ以降のバグ修正リリースで、バイナリ インストーラーを復活させることを決めました。現在、アップグレード プロセスについて引き続き調査中であり、手動アップグレード パスのより良いサポートに向けて取り組んでいます。そのため、この決定は Jira 10.3 LTS にのみ適用されます。これ以降のフィーチャー リリース (たとえば 10.4 と 10.5) はインストーラーを含みません。

Atlassian Package Scanner からの警告の無視

Atlassian Package Scanner は、同じパッケージ (場合によっては別のバージョンのパッケージ) を提供する .jar ファイルがないかどうかを確認します。Jira Software Data Center 10.3 または Jira Service Management Data Center 10.3 にアップグレードすると、Atlassian Package Scanner によって、別の .jar ファイルから提供された同じ内容のパッケージについて通知されます。

これは、Embedded Crowd がまだ新バージョンのプラットフォームに移行中で、引き続き password-cipher を使用しているのに対し、すでに atlassian-secrets に移行している Jira は下位互換性のために引き続き password-cipher を提供する必要があるためです。atlassian-secrets には password-cipher が組み込まれているため、Atlassian Package Scanner はこれを検出しますが、内容は同じであるため、次の警告は無視してかまいません (.jar ファイルが /lib と atlassian-jira/WEB-INF/lib の両方に配置されているため、重複する行があることに注意してください)。

JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-api-5.0.4.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: password-cipher-base-1.4.0.jar and atlassian-secrets-store-5.0.4.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.protocol' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.utils' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.secrets.tomcat.cipher' with different versions. Files: atlassian-secrets-store-5.0.4.jar and password-cipher-base-1.4.0.jar JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: password-cipher-api-1.4.0.jar and atlassian-secrets-api-5.0.4.jar

警告の全文には、スキャンされたファイルの正確な場所に関する詳細情報が記載されています。

2024-10-17 09:31:28,389+0000 JIRA-Bootstrap WARN [o.twdata.pkgscanner.ExportPackageListBuilder] Package Scanner found duplicates for package 'com.atlassian.db.config.password' with different versions. Files: atlassian-secrets-api-5.0.4.jar and password-cipher-base-1.4.0.jar '/tmp/jira/lib/atlassian-secrets-api-5.0.4.jar' '/tmp/jira/lib/password-cipher-base-1.4.0.jar'

改善、修正、および、重大な変更以外の変更

Jira 10.3 までの各リリースに追加されたすべての改善、修正、および破壊的でない変更を垣間見ることができます。表はリリースごとに行に分かれています。各行には、詳細を記載している関連アップグレード ノートへのリンクが含まれています。

サポート対象プラットフォームの変更

前回の Jira LTS リリース以降に加えられたサポートされているプラットフォームに関する変更を確認してください。

サポート終了

次のサポートを削除しました。

• Oracle 12c R2
• Amazon Aurora on PostgreSQL 10
• Amazon Aurora on PostgreSQL 11
• H2 データベース エンジン
• Java 8
• Java 11
• .bin と .exe のバイナリ インストーラー

次のバンドルを解除しました:

• Java (バイナリ インストーラーが削除されたため)

サポートを確認済み

次の製品のサポートを確認しました。

• Azure PostgreSQL フレキシブル サーバー (1 つのプライマリ ノードのみ)

既知の問題

このセクションには、テストで発見されたすべての問題に関する情報を含みます。引き続き監視をしており、何か分かり次第こちらでお知らせします。

Jira の起動時に、「Dangerous use of multiple connections」という警告が多数記録される

Jira の起動時に、「Dangerous use of multiple connections」という警告が複数記録される。
このスタック トレースは、この動作がアプリケーション プロパティの読み取り中に発生することを示しています。これは Jira 9.15.0 でリファクタリングされました。詳細はこちら

優先度の追加ダイアログで画像を選択すると、コンソールにエラーが表示される

回避策

アイコン URL のサンプルを使って新しい優先度の作成に進みます。例:

images/icons/priorities/trivial.png

優先度が作成されたら、画像を編集および選択して、ポップアップ ウィンドウを表示します。詳細はこちら

 アップグレード手順

Upgrading from Jira version 9.x.x? 

• See Upgrading Jira applications for complete upgrade procedures, including all available upgrade methods and pre-upgrade steps. 
  
• For a more tailored upgrade, go to Jira administration, then Applications, then Plan your upgrade. We’ll recommend a version to upgrade to, run pre-upgrade checks, and provide you with a custom upgrade guide with step-by-step instructions.

 アプリ開発者向けの情報

See Preparing for Jira 10.3 for any important changes regarding apps.