この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

機能フラグ

機能フラグを使用すると、オプションまたは実験的な機能を試したり、段階的に廃止されるレガシー機能を有効にしたりできます。

機能の値とそれを有効にする方法について詳しくは、実験的機能の有効化を参照してください。

一部の機能フラグは、Rancherコンテナの再起動を必要とします。再起動が必要な機能は、Rancher UIにマークされています。

以下は、Rancherで利用可能な機能フラグのリストです。以前のRancherバージョンからアップグレードした場合、Rancher UIに追加のフラグが表示されることがあります。例えば、proxy`や`dashboard(両方ともxref:[廃止された])です。

  • aggregated-roletemplates:RoleTemplates、ProjectRoleTemplateBindings、およびClusterRoleTemplateBindingsに対して、クラスター役割集約アーキテクチャを使用します。詳細については、RoleTemplateの集約を参照してください。

  • clean-stale-secrets:`cattle-impersonation-system`ネームスペースから古いシークレットを削除します。これは、もはやなりすましシステムによって使用されていない古いシークレットを徐々にクリーンアップします。

  • continuous-delivery:Fleet GitOpsをFleetとは別に無効にすることができます。詳細については、継続的デリバリを参照してください。

  • fleet:v2.6以降のRancherプロビジョニングフレームワークは、Fleetを必要とします。このフラグは、以前のRancherバージョンでこのフラグを無効にしていても、アップグレード時に自動的に有効になります。詳細については、Fleetによる継続的デリバリを参照してください。

  • harvester:仮想化管理ページへのアクセスを管理し、ユーザーが直接Harvester clusterに移動してHarvester UIにアクセスできるようにします。詳細については、SUSE Virtualization 統合概要を参照してください。

  • imperative-api-extension:Rancher’s extension API server が新しい API を Kubernetes に登録できるようにします。このフラグはデフォルトで有効になっています。詳細については、Extension API Server ページをご覧ください。

  • istio-virtual-service-ui:Istio のトラフィック管理機能である Istio 仮想サービスと宛先ルールを作成、読み取り、更新、削除するための 視覚インターフェース を有効にします。

  • legacy:2.5.x およびそれ以前のバージョンからの機能セットを有効にしますが、これらは新しい実装に置き換えられるため、徐々に廃止されつつあります。これらは、廃止された機能と、最終的に新しいバージョンで利用可能になる機能の混合です。このフラグは、新しい Rancher インストールではデフォルトで無効になっています。以前のバージョンの Rancher からアップグレードする場合、このフラグは有効になります。

  • managed-system-upgrade-controller:ダウンストリームのインポートされた RKE2/K3s クラスターおよびローカルクラスタ(RKE2/K3s クラスターの場合)に system-upgrade-controller アプリのインストールを有効にします。

この managed-system-upgrade-controller フラグは 内部使用のみ を目的としており、関連する Feature CR はありません。注意して使用してください。

Rancher がインポートされた RKE2/K3s クラスターの Kubernetes バージョンを管理するかどうかを制御するには、Rancher v2.11.0 以降で利用可能な imported-cluster-version-management 機能を使用することをお勧めします。

Rancher v2.10.x で managed-system-upgrade-controller フラグが 無効 になっていて、ダウンストリームのインポートされた RKE2/K3s クラスターが Rancher の外で アップグレードされた場合、system-upgrade-controller アプリの予期しないインストールを防ぎ、imported-cluster-version-management 機能が正しく動作するようにするために、以下の手順に従ってください:

  1. Rancher を v2.11.0 以降にアップグレードし、v2.10.x インストール中に設定されていた場合は Helm 値の 機能フラグ を保持していることを確認してください。

  2. Rancher が完全に稼働したら、imported-cluster-version-management 設定を無効にします。これを行うには、Rancher UI で ☰ > グローバル設定 > 設定 > imported-cluster-version-management をクリックするか、kubectl を使用して対応する Setting.management.cattle.io/v3 カスタムリソースを編集します。

  3. 2 回目の Helm アップグレードを実行し、今度は managed-system-upgrade-controller=false 機能フラグを省略します。

これで、ダウンストリームのインポートされたクラスターのバージョン管理はデフォルトで無効になり、Rancher はダウンストリームのインポートされたクラスターに system-upgrade-controller アプリを自動的にインストールしなくなります。

この機能は、クラスターごとに有効にできます。詳細については、ドキュメント を参照してください。

  • multi-cluster-management:複数の Kubernetes クラスターのプロビジョニングと管理を可能にします。このフラグはインストール時にのみ設定できます。後で有効または無効にすることはできません。

  • rke2:RKE2クラスターのプロビジョニングを有効にします。このフラグはデフォルトで有効になっています。

  • token-hashing:トークンのハッシュ化を有効にします。有効にされると、既存のトークンはハッシュ化され、新しいトークンは自動的にSHA256アルゴリズムでハッシュ化されます。トークンがハッシュ化されると、元に戻すことはできません。このフラグは有効にされた後に無効にすることはできません。詳細についてはAPIトークンを参照してください。

  • uiextension:UI拡張機能を有効にします。このフラグはデフォルトで有効になっています。フラグを有効または無効にすると、Rancherポッドが再起動します。このフラグが`Active`に設定されると、最初にCRDが作成され、機能が動作するために必要なコントローラーとエンドポイントが有効になります。Disabled`に設定されると、前述のコントローラーとエンドポイントが無効になります。`uiextension`を`Disabled`に設定しても、CRD --には影響がありません。存在しない場合はCRDを作成せず、既に存在する場合はCRDを削除しません。* `unsupported-storage-drivers:デフォルトで有効になっていないストレージプロバイダーやプロビジョナーのタイプを有効にします。詳細についてはサポートされていないストレージドライバーを許可を参照してください。

  • ui-sql-cache:UIテーブルとサーバーサイドページネーションのためのSQLiteベースのキャッシュを有効にします。詳細についてはUIサーバーサイドページネーションを参照してください。

以下の表は、Rancherのいくつかの機能フラグの可用性とデフォルト値を示しています。「GA」とマークされた機能は一般に利用可能です:

機能フラグ名 デフォルト値 Status 利用可能な日付 その他の情報

aggregated-roletemplates

Disabled

実験的

v2.11.0

このフラグの値はインストール時にロックされており、変更することはできません。

clean-stale-secrets

Active

GA

v2.11.0

continuous-delivery

Active

GA

v2.6.0

external-rules

v2.7.14: Disabled、v2.8.5: Active

削除

v2.7.14、v2.8.5

このフラグは外部`RoleTemplate`の動作に影響を与えました。この動作はデフォルトで有効になっているため、Rancher v2.9.0以降では削除されます。

fleet

Active

無効にできなくなりました

v2.6.0

fleet

Active

GA

v2.5.0

harvester

Active

実験的

v2.6.1

imperative-api-extension

Active

GA

v2.11.0

legacy

新しいインストールには`false`、アップグレードには`true`を使用します。

GA

v2.6.0

managed-system-upgrade-controller

true

GA

v2.10.0

rke2

true

実験的

v2.6.0

token-hashing

新しいインストールには`Disabled`、アップグレードには`Active`を使用します。

GA

v2.6.0

uiextension

Active

GA

v2.9.0

ui-sql-cache

Active

GA

v2.9.0