Confluence 8.8 への準備
このドキュメントでは、既存のプラグインやアプリに Confluence 8.8 との互換性があるかどうかを確認したい Confluence 開発者向けの情報をご案内します。
このページで、新しいマイルストーンの公開タイミング、およびその内容をご確認ください。ベータ版のリリース後、正式なリリース ノートを公開します。
最新のマイルストーン
2024 年 2 月 2 日 | 8.8.0-rc1 |
このマイルストーンで問題が見受けられた場合
Confluence EAP のヘッダーで [フィードバック] ボタンを押すか、課題を登録してお知らせください。
On this page:
予定されている変更
このセクションでは、導入予定の変更の概要について紹介します。アプリへの影響の検討にお役立てください。変更の実装が完了したら、そのタイミングと対象のマイルストーンをご案内します。
このリリースは Data Center ライセンスのみをサポートします。サーバー ライセンスをお持ちの場合は、アップグレードのオプションをご確認ください。
Struts アクション パラメーターの変更
ステータス: 完了
アトラシアンはこれを重要な変更として分類しています。次の情報をよく読んで、ご利用のアプリが最新バージョンの Confluence で正しくセットアップされているかをご確認ください。
以前は、Struts によるパラメーター挿入 (複雑なパラメーター/ネストされたパラメーターとも呼ばれます) を目的とした POJO にアクセスできるようにするには、@ParameterSafe
という注釈を付ける必要がありました。今後は、パラメーター挿入用のすべてのメソッド/フィールドに、@StrutsParameter
という新しい注釈を付ける必要があります。
複雑な/ネストされたパラメーターでは、新しい注釈の一部として depth
値も指定する必要があります。これは、Java オブジェクト パラメーター内のネストのレベルを指します。マップ、配列/リスト、POJO などのほとんどの複雑なパラメーターについては、1 の深さで十分です。マップ/リスト/POJO 内に POJO がある場合は、2 の深さが必要となる場合があります。
@ParameterSafe
の注釈は引き続き機能しますが、深さは 2 に固定されます。Confluence の旧バージョンに対してコンパイルすることを選択した場合は、代替パラメーターの深さを指定できません。
詳細については、Struts モジュール リファレンスを参照してください。
Struts OGNL 許可リスト
ステータス: 完了
重大な変更です。次の情報をよく読んで、ご利用のアプリが新しいリリース向けに正しくセットアップされていることをご確認ください。
今後は、OGNL 式の実行が厳格なクラス許可リストの対象となります。Confluence は、OGNL 式の実行に必要となるほとんどすべてのクラスを自動で許可リストに登録します。ただし、クラスを許可リストに手動で登録する必要があるという一部のエッジ ケースも存在します。
2 以上の深さで注釈が付けられた Struts パラメーターでは、ネストされたタイプを許可リストに手動で登録する必要があります。
許可リストに登録されていないプラグイン クラスに関連する、その他のログ警告に気付いた場合は、それらも許可リストに含める必要があるでしょう。
Struts、OGNL、またはベロシティの悪用があった場合は、許可リストに登録済みのクラスの公開メンバーに対して、攻撃者がアクセスできるようになる可能性があります。
クラスやパッケージは、Struts モジュール記述子内において、次のエントリを使用して許可リストに手動で登録できます。パッケージを許可リストに登録すると、そのサブパッケージも許可リストに追加されます。パッケージを許可リストに登録せずに、各クラスを明示的に宣言することをおすすめします。
<constant name="struts.allowlist.classes" value="
com.company.package.ClassOne,
com.company.package.ClassTwo
">
<constant name="struts.allowlist.packages" value="
com.company.package.model,
com.company.package.dto
">
Struts モジュールのドキュメンテーションで詳細をご確認ください。
Confluence での Velocity サーブレットのサポートの廃止
ステータス: 完了
概要 - 末尾が .vm の URL のレンダリングのサポートはこのバージョンから削除されました。その結果、この機能は停止するため、変更が必要になります。
これは、アクション内で VM ファイルを利用するプラグインの機能には影響しないことに注意してください。
アクションが必要 - Confluence で Velocity サーブレットのサポートが廃止されたため、影響を受けるプラグインは、追加のサーバー レンダリング制御とセキュリティ機能を提供する Velocity テンプレートベースの UI 画面に対応するために Struts アクションを活用する必要があります。
Confluence での使用頻度の低いレンダリング方法の削除
ステータス: 完了
このリリースでは、使用頻度の低いいくつかのレンダリング方法を予定外に削除する必要がありました。非常にまれなケースですが、これにより、お客様が開発したプラグインやユーザー マクロのレンダリングが失敗する可能性があります。このアップグレード後にユーザー マクロが壊れた場合は、アトラシアン サポートにご連絡ください。
Universal Plugin Manager によるアプリのアップロードの変更
ステータス: DONE
セキュリティを強化するために、Confluence を含む Data Center 製品で Universal Plugin Manager (UPM) と REST API を使用してアプリのインストールを処理する方法を変更しました。UPM の [アプリをアップロード] ボタンは既定で無効になりました。システム プロパティ upm.plugin.upload.enabled
を true に設定することで、システム管理者は今後もアプリのインストールを有効にできます。
この変更は Atlassian Marketplace からのアプリのインストールには影響しません。dev
モードで実行されているインスタンスでは UPM のアップロード オプションが依然として有効である点に注意してください。
Atlassian User Interface (AUI) 9.9.x アップグレード
ステータス: 完了
AUI をバージョン 9.2.2 から 9.9.x. にアップグレードします。このアップグレードによって、アクセシビリティに関するさまざまなメリットと修正が提供される予定です。ご利用のアプリに影響する可能性のある変更については、AUI 9 .x アップグレード ガイドと AUI 変更ログをご参照ください。
新しい REST API
ステータス: DONE
管理者が次のような管理タスクを一括で自動化およびスクリプト化できるように、追加の REST API を導入します。
ページの権限の更新
スペースのアーカイブと復元
新しく導入された API については、Confluence API ドキュメンテーションに反映されます。
埋め込みの Crowd のアップグレード
ステータス: DONE
このリリースでは、組み込みの Crowd を 5.1.6 から 5.2.1 にアップグレードする予定です。この変更によって、一部のパフォーマンスと安定性が向上すると予想されます。
ATST アプリの 1.54.0 へのアップグレードに伴う新しいヘルス チェックの追加
ステータス: 完了
Atlassian Troubleshooting and Support アプリ (ATST) がバージョン 1.54.0 にアップグレードされ、次のチェック機能が追加されました。
ヘルス チェックは Confluence Data Center 8.8 で既定で利用可能になります。
Confluence 8.7 以前を使用している場合も、ATST アプリを 1.54.0 にアップグレードできます。Atlassian Marketplace から手動でアップグレードして、最新のヘルス チェック機能を使い始めることができます。
スタートアップ エラー:データベースの添付ファイル ストレージ
ステータス: DONE
現在でも引き続き添付ファイルをデータベースに保存している場合(この方法は Confluence 5.4 で廃止済みです)、Confluence 8.8 以降にアップグレードする前に、これらをファイル システムに移行する必要があります。この移行を実行しないと、Confluence は正常に起動しません。
添付ファイルをデータベース ストレージからファイル システム ストレージに移行する方法をご確認ください。
ユーザー ディレクトリ サーバー パスワードの AES 暗号化
ステータス: DONE
ユーザー ディレクトリのパスワード暗号化をサポートするために、シークレット マネージャー ソリューションを拡張しました。これによって、ユーザー ディレクトリを設定する際に、指定されたサーバー パスワードが自動で AES 暗号化されます。ユーザー ディレクトリが設定済みである既存のインスタンスの場合は、Confluence 8.8.0 へのアップグレード時にパスワードが自動で暗号化されます。Confluence は暗号化キーを自動で生成し、キー ディレクトリに保存します。ディレクトリはサイト エクスポートに含まれていないので、このディレクトリを手動でバックアップする必要があります。ディレクトリの場所は次のとおりです。
- クラスター化されたインスタンス:
shared home
ディレクトリ - シングルノード インスタンス:
local home
ディレクトリ
非推奨の通知:JavaScript グローバル AJS.ConfluenceDialog
ステータス: DONE
コード ベースをクリーンアップするための継続的な取り組みの一環として、JavaScript グローバル AJS.ConfluenceDialog
を Confluence 9.0 から削除するために、非推奨とします。ご利用のアプリでは、これらの依存関係ではなく、Atlassian User Interface(AUI)ライブラリをご利用ください。
添付ファイルの一括削除
ステータス: DONE
これまで、ユーザーがページやブログ投稿から添付ファイルを削除する場合は、1 つずつ削除する必要がありました。今後は、一度に削除するページ内の添付ファイルを最大 20 個まで選択できます。
Confluence 用ダーク テーマ
ステータス: 事前通知
ダーク テーマは、2024 年第 2 四半期で提供される次のリリースで正式に導入されます。現時点では、theme.switcher
ダーク機能を使用して、テスト用にダーク テーマ(アルファ)を有効にできます。
ダーク テーマに対応した Data Center アプリの準備に関するガイドをご覧ください。
Confluence ダーク テーマに関する詳細は、近日中にお知らせします。現時点では、以下のことが確定しています。
テーマ スイッチャーとすべてのダーク テーマ機能は、ダーク機能 theme.switcher で有効にできます。システム全体 (`/admin/darkfeatures.action`)
とユーザー単位 (`/users/darkfeatures.action`)
のどちらでも有効にできます。
テーマ スイッチャーは、type=theme.change
のメッセージをすべての iFrame (同一オリジンとクロスオリジンの両方) に投稿します。
atlassian-theme によって処理されるクエリ パラメーターは次のとおりです。
atlThemeColorMode = light | dark
atlThemeDark = dark
atlThemeLight = light | original
atlThemeMatchUa = false | true
グレー API の廃止
ステータス: 事前通知
Confluence 9.0 では、プラグインで多数のサードパーティ製ライブラリ (グレー API とも呼ばれます) を読み込む機能が削除されます。これによってアトラシアンは、お客様のアプリに影響を与えることなく、これまでより頻繁に Confluence を改善できるようになります。また、変更に合わせてお客様が大幅なテストや手直しを行う必要もなくなります。
Confluence 8.7 から 8.9 では、これらのサードパーティ製ライブラリといくつかのアトラシアン固有のライブラリは、メインの confluence
アーティファクトの移行期の Maven の依存関係として公開されなくなります。これを補うため、プラグインでは、それらの依存関係をバンドルして明示的に宣言する必要があります。
9.0 より前の Confluence では、これらのライブラリの可用性に影響する実行時の変更は行われず、バイナリの互換性は維持される点に注意してください。8.7 から 8.9 の Confluence に対する変更は、あくまでもビルド時の変更であり、Confluence 9.0 での実行時の削除に向けた準備となります。
この変更の詳細とアプリの準備については、グレー API 開発者ガイドを参照してください。
OpenSearch のオプトインが進行中です
ステータス: 事前通知
将来の Confluence リリースには、オプトインの検索エンジン、OpenSearch が含まれる予定です。これによって、より高度なインデックス化のオプションが提供され、処理要件も少なくなります。スムーズな移行のためにも、この変更が導入されるまでの間、OpenSearch アップグレード ガイドを定期的にご確認のうえ、最新情報をチェックしてください。
変更の実装内容
このセクションでは、実装済みの変更の詳細について、それらが最初に提供されたマイルストーンごとに紹介します。テストするマイルストーン バージョンの判断にご利用ください。
RC – 2024 年 2 月 2 日
マイルストーン 8.8.0-rc1
含まれるもの
- 軽微なバグ修正
ベータ – 2024 年 1 月 24 日
マイルストーン 8.8.0-beta1
含まれるもの
- ユーザー ディレクトリのパスワード暗号化
- 軽微なバグ修正
EAP 2 – 2024 年 1 月 18 日
Milestone 8.8.0-m61
含まれるもの
- AUI 9.9.0 アップグレード バグ修正
- UPM プラグインのアップロードにおける変更
- 軽微なバグ修正
EAP 1 – 2024 年 1 月 8 日
Milestone 8.8.0-m46
含まれるもの
- 新しいキーボード ショートカット(テーブルの行を上下に追加)
- 添付ファイルの一括削除
- AUI 9.9.0 アップグレード
- 埋め込みの Crowd の 5.2.1 へのアップグレード
- ダーク機能:Confluence ダーク テーマ
- データベース添付ファイル ストレージのスタートアップ エラー
削除したもの:
Confluence.ScrollingInlineDialog
コンポーネント
非推奨
- JavaScript グローバル
AJS.ConfluenceDialog
最新のドキュメントをお探しの場合は、Confluence EAP スペースで最新のドキュメントをご確認ください。
Did you know we’ve got a new developer community? Head to community.developer.atlassian.com/ to check it out! We’ll be posting in the announcements category if when new EAP releases are available.