第18章 テクノロジープレビュー機能の管理
機能フラグを使用して、テクノロジープレビューの機能を有効または無効にすることができます。
重要
テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
18.1. 機能フラグの管理
18.1.1. 前提条件
- RHACS コンポーネントがデプロイされている環境にアクセスできる。
- 環境変数を変更する権限がある。
- テクノロジープレビュー機能は不完全な場合があり、サポートも限定的に提供されることを理解している。
- デプロイメント前にテクノロジープレビュー機能のフラグを設定する必要があるかどうかを把握している。インストールマニフェストをチェックして、必要なフラグが使用されているかを確認します。
手順
-
機能フラグに関連付けられている環境変数名を識別します。有効または無効にする機能のフラグを識別するには、リリースノートまたは
/v1/featureflagsAPI エンドポイントを参照してください。 次のいずれかのアクションを実行して、機能フラグを変更します。
-
機能を有効にするには、フラグに関連付けられた環境変数の値を
trueに設定し、設定を行います。これを Kubernetes デプロイメントで直接設定するか、Helm チャートまたは Operator カスタムリソース (CR) を使用してインストール中に設定します。 -
機能を無効にするには、フラグに関連付けられた環境変数を
falseに設定します。
-
機能を有効にするには、フラグに関連付けられた環境変数の値を
アプリケーションを再起動または再デプロイした後、次の手順を実行して、機能が有効または無効になっていることを確認します。
-
/v1/featureflagsAPI エンドポイントの出力を確認します。 - 機能に関連するアプリケーションの機能を確認します。
- ログまたはモニタリングツールでエラーや確認メッセージがないか確認します。
-
18.1.2. ベストプラクティス
機能フラグを使用する場合は、次のベストプラクティスに従ってください。
- 機能の変更を実稼働環境に適用する前に、必ずステージング環境でテストしてください。
- すべての機能フラグとその現在のステータスを記録します。
- 機能によって問題が発生した場合には、変更を元に戻す準備をしておいてください。
18.1.3. トラブルシューティング
次のトラブルシューティングのガイドラインに従ってください。
- その機能が表示されない場合は、環境変数の名前が正しく設定され、適切に設定されていることを確認してください。機能フラグの解析に関連するエラーがないかアプリケーションログを確認します。
- 機能を有効にするとアプリケーションエラーが発生する場合は、機能を無効にして Red Hat Support チームにお問い合わせください。
