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

実験的機能を有効にする

Rancherには、実験的でデフォルトで無効になっている機能がいくつか含まれています。これらの機能を有効にしたい場合があります。たとえば、サポートされていないストレージタイプを使用する利点が、未テストの機能を使用するリスクを上回ると判断した場合です。機能フラグは、デフォルトで有効になっていないこれらの機能を試すことを可能にするために導入されました。

機能は、3つの方法で有効にできます。

Rancherを起動する際に機能を有効にする。CLIを使用してRancherをインストールする際に、デフォルトで機能を有効にするために機能フラグを使用できます。
Rancher UIから機能を有効にするには、*設定*ページに移動します。
Rancher APIで機能を有効にするには、Rancherをインストールした後に行います。

各機能には2つの値があります。

デフォルト値は、コマンドラインからフラグまたは環境変数で設定できます。
設定値は、Rancher APIまたはUIで設定できます。

値が設定されていない場合、Rancherはデフォルト値を使用します。

APIが実際の値を設定し、コマンドラインがデフォルト値を設定するため、APIまたはUIで機能を有効または無効にすると、コマンドラインで設定された値が上書きされます。

たとえば、Rancherをインストールし、その後Rancher APIで機能フラグをtrueに設定し、機能フラグをfalseに設定するコマンドでRancherをアップグレードすると、デフォルト値は依然としてfalseですが、機能はRancher APIで設定されたため有効のままです。その後、Rancher APIで設定値（true）をNULLに設定して削除すると、デフォルト値（false）が適用されます。詳細については、機能フラグページを参照してください。

Rancherを起動する際の機能の有効化

Rancherをインストールする際に、機能フラグで希望する機能を有効にします。コマンドは、Rancherを単一ノードにインストールする場合とKubernetesインストールを行う場合で異なります。

Kubernetesインストールのための機能の有効化

Rancher APIから設定された値は、コマンドラインを通じて渡された値を上書きします。

Helmチャートを使用してRancherをインストールする際は、`--set`オプションを使用してください。以下の例では、機能フラグ名をカンマ区切りのリストで渡すことにより、2つの機能が有効化されています。

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org \
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

エアギャップインストール用の機能の有効化

xref:installation-and-upgrade/other-installation-methods/air-gapped/install-rancher-ha.adocRancherのエアギャップインストールを実行するには、Helmチャートリポジトリを追加し、Helmチャートをダウンロードしてから、HelmでRancherをインストールします。

Helmチャートをインストールする際は、以下の例のように、カンマ区切りのリストで機能フラグ名を渡す必要があります。

helm install rancher ./rancher-<VERSION>.tgz \
  --namespace cattle-system
  --set hostname=<RANCHER.YOURDOMAIN.COM> \
  --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
  --set ingress.tls.source=secret \
  --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
  --set useBundledSystemChart=true # Use the packaged Rancher system charts
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Dockerインストールのための機能の有効化

DockerでRancherをインストールする際は、`--features`オプションを使用してください。以下の例では、機能フラグ名をカンマ区切りのリストで渡すことにより、2つの機能が有効化されています：

docker run -d -p 80:80 -p 443:443 \
  --restart=unless-stopped \
  rancher/rancher:rancher-latest \
  --features=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true

Rancher UIでの機能の有効化

左上隅で、*☰ > グローバル設定*をクリックします。
*機能フラグ*をクリックしてください。
機能を有効にするには、有効にしたい無効になっている機能に移動し、*⋮ > 有効化*をクリックしてください。

*結果:*機能が有効化されました。

Rancher UIでの機能の無効化

左上隅で、*☰ > グローバル設定*をクリックします。
*機能フラグ*をクリックしてください。実験的な機能のリストが表示されます。
機能を無効にするには、無効にしたい有効になっている機能に移動し、*⋮ > 無効化*をクリックしてください。

*結果:*機能が無効化されました。

Rancher APIでの機能の有効化

`<RANCHER-SERVER-URL>/v3/features`に進みます。
`data`セクションでは、機能フラグでオンにできるすべての機能を含む配列が表示されます。機能の名前は`id`フィールドにあります。有効にしたい機能の名前をクリックしてください。
画面の左上隅にある*Operations,*の下で、*Edit*をクリックします。
*Value*のドロップダウンメニューで、*True*をクリックします。
*Show Request*をクリックします。
*Send Request*をクリックします。
[閉じる] をクリックします。

*結果:*機能が有効化されました。

Rancher APIでの機能の無効化

`<RANCHER-SERVER-URL>/v3/features`に進みます。
`data`セクションでは、機能フラグでオンにできるすべての機能を含む配列が表示されます。機能の名前は`id`フィールドにあります。有効にしたい機能の名前をクリックしてください。
画面の左上隅にある*Operations,*の下で、*Edit*をクリックします。
*Value*のドロップダウンメニューで、*False*をクリックします。
*Show Request*をクリックします。
*Send Request*をクリックします。
[閉じる] をクリックします。

*結果:*機能が無効化されました。