How to manage dark features in Jira Server and Data Center
プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Fisheye および Crucible は除く
問題
Jira の一部の機能はデフォルトでは有効化されておらず、ダーク機能 (機能フラグ) として実装されています。
ダーク機能は注意して使うようにしてください。ダーク機能はインスタンス全体に影響するため、誤って使用すると問題が発生する可能性があります。これはアトラシアン サポートによる指示があった場合にのみ利用することが想定されています。
ベスト プラクティスとして、本番環境に適用する前に下層の環境で検証を行うようにしてください。また、ダーク機能を初めて変更する前に完全なバックアップを取得することが推奨されます。
ソリューション
ダーク機能を管理するには、Jira 管理者のアカウントとして次の URL にアクセスします。
<BASE_URL>/secure/admin/SiteDarkFeatures!default.jspa
ダーク機能の有効化
機能フラグを有効化するには、[ダーク機能の有効化] テキスト領域で「 <機能フラグ名>.enabled」と入力し、[追加] ボタンをクリックします。
機能フラグ名の末尾で「.enabled」が重複しないようにします。
Dark Features related to migration (e.g all the dark features of format com.atlassian.jira.migration.*) may not support above notation. DON't add ".enabled" or ".disabled" suffix for these migration related Dark features.
Please work with your Migrations Support team for the correct directions in implementing such dark features.
ダーク機能の無効化
機能フラグを 無効化 するには、次の手順を実行します。
- 個々の機能フラグの横にある [無効化] リンクをクリックする (以降のスクリーンショット参照)
または
- ダーク機能の有効化テキスト エリアで「<機能フラグ名>.disabled」と入力し、[追加] ボタンをクリックします。
- 機能フラグ名の末尾で「enabled.disabled」のようにサフィックスを組み合わせないようにしてください。
管理ページに存在しないダーク機能がある場合、そのダーク機能は既定値を持ち、それが個々のダーク機能に応じて有効化または無効化されている可能性があります。
ダーク機能の管理画面の例
REST API を利用したダーク機能の管理
次の非公開エンドポイントを利用して Jira のダーク機能を管理できます。/rest/internal/1.0/darkFeatures/{key}
これは、アトラシアンが製品内で利用する非公開の API です。この API は予告なしで変更される可能性があります。
手順
上記のエンドポイントへの PUT メソッドを実行し、次の JSON 本文を続けます (機能フラグを追加したいか削除したかに応じて true または false を設定)
{ "enabled": "true" }ここで {key} はダーク機能のキーです。例:
<BASE_URL>/rest/internal/1.0/darkFeatures/sd.sla.improved.rendering.enabledcURL シンタックスの例です。
curl -u user:password -X PUT <BASE_URL>/rest/internal/1.0/darkFeatures/{key} -H 'Content-Type: application/json' -d '{ "enabled": "true" }'構成の保持について
Jira は、構成済みのダーク機能をテーブル feature. で保持します。ダーク機能は、サービスの再起動や、Jira Data Center 環境におけるノードの置き換えがあっても保持されます。
Additional Information
Jira のダーク機能は、ダーク テーマ/モード (ブラウザ ウィンドウでの外観の変更) とは異なります。
Jira Data Center または Cloud でダーク テーマ/モードをお探しの場合、次の提案をご確認ください。
For Jira Data Center: JRASERVER-63150 - Getting issue details... STATUS
For Jira Cloud: JRACLOUD-63150 - Getting issue details... STATUS