Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

tridentctlを使用してインストールする

PDF

Tridentは `tridentctl`を使用してインストールできます。このプロセスは、Tridentで必要なコンテナイメージがプライベートレジストリに保存されているかどうかに関係なく適用されます。 `tridentctl`の導入をカスタマイズするには、"tridentctl 導入環境のカスタマイズ"を参照してください。

Trident10に関する重要な情報

Trident に関する以下の重要な情報を必ずお読みください。

<strong>Tridentに関する重要な情報</strong>

  • Kubernetes 1.27 が Trident でサポートされるようになりました。Kubernetes をアップグレードする前に Trident をアップグレードしてください。

  • Trident は SAN 環境でのマルチパス構成の使用を厳格に強制し、multipath.conf ファイル内の推奨値は `find_multipaths: no`です。

    非マルチパス構成の使用、または multipath.conf ファイルでの `find_multipaths: yes`または `find_multipaths: smart`値の使用は、マウントの失敗を引き起こします。Trident は、 21.07 リリース以降 `find_multipaths: no`の使用を推奨しています。

Tridentを使用してインストール tridentctl

"インストールの概要"を確認して、インストールの前提条件を満たしていること、および環境に適したインストールオプションが選択されていることを確認します。

開始する前に

インストールを始める前に、Linuxホストにログインし、正常に動作している"サポートされている Kubernetes クラスター"を管理していること、および必要な権限を持っていることを確認します。

メモ OpenShift では、以下のすべての例で oc を kubectl の代わりに使用し、最初に oc login -u system:admin または oc login -u kube-admin を実行して system:admin としてログインしてください。
Details

  1. Kubernetes のバージョンを確認します：

    kubectl version

  2. クラスタ管理者権限を確認します：

    kubectl auth can-i '*' '*' --all-namespaces

  3. Docker Hub からイメージを使用するポッドを起動し、ポッド ネットワーク経由でストレージ システムにアクセスできることを確認します：

    kubectl run -i --tty ping --image=busybox --restart=Never --rm -- \
  ping <management IP>

ステップ1：Tridentインストーラーパッケージをダウンロードする

Tridentインストーラーパッケージは、Tridentポッドを作成し、その状態を維持するために使用されるCRDオブジェクトを構成し、CSIサイドカーを初期化して、ボリュームのプロビジョニングやクラスターホストへの接続などのアクションを実行します。最新バージョンのTridentインストーラーを"GitHub の Assets セクション"からダウンロードして解凍します。例の_<trident-installer-XX.XX.X.tar.gz>_を選択したTridentバージョンで更新します。

wget https://github.com/NetApp/trident/releases/download/v25.10.0/trident-installer-25.10.0.tar.gz
tar -xf trident-installer-25.10.0.tar.gz
cd trident-installer

ステップ2：Tridentをインストールする

目的のネームスペースに Trident をインストールするには、 `tridentctl install`コマンドを実行します。追加の引数を追加して、イメージレジストリの場所を指定できます。

標準モード
./tridentctl install -n trident
1つのレジストリ内の画像
./tridentctl install -n trident --image-registry <your-registry> --autosupport-image <your-registry>/trident-autosupport:25.10 --trident-image <your-registry>/trident:25.10.0
異なるレジストリ内のイメージ
./tridentctl install -n trident --image-registry <your-registry> --autosupport-image <your-registry>/trident-autosupport:25.10 --trident-image <your-registry>/trident:25.10.0

インストールのステータスは次のようになります。

....
INFO Starting Trident installation.                namespace=trident
INFO Created service account.
INFO Created cluster role.
INFO Created cluster role binding.
INFO Added finalizers to custom resource definitions.
INFO Created Trident service.
INFO Created Trident secret.
INFO Created Trident deployment.
INFO Created Trident daemonset.
INFO Waiting for Trident pod to start.
INFO Trident pod started.                          namespace=trident pod=trident-controller-679648bd45-cv2mx
INFO Waiting for Trident REST interface.
INFO Trident REST interface is up.                 version=25.10.0
INFO Trident installation succeeded.
....

インストールの確認

ポッド作成ステータスを使用してインストールを確認するか、 `tridentctl`を使用できます。

ポッド作成ステータスの使用

作成されたポッドのステータスを確認することで、Tridentのインストールが完了したかどうかを確認できます：

kubectl get pods -n trident

NAME                                  READY   STATUS    RESTARTS   AGE
trident-controller-679648bd45-cv2mx   6/6     Running   0          5m29s
trident-node-linux-vgc8n              2/2     Running   0          5m29s
メモ インストーラが正常に完了しない場合、または trident-controller-<generated id> (trident-csi-<generated id>（23.01より前のバージョン）が*Running*ステータスでない場合、プラットフォームはインストールされていません。 `-d`を使用して"デバッグモードをオンにする"問題のトラブルシューティングを行います。

使用 tridentctl

`tridentctl`を使用して、インストールされているTridentのバージョンを確認できます。
./tridentctl -n trident version

+----------------+----------------+
| SERVER VERSION | CLIENT VERSION |
+----------------+----------------+
| 25.10.0        | 25.10.0        |
+----------------+----------------+

サンプル構成

以下の例は、 `tridentctl`を使用してTridentをインストールするためのサンプル構成を示しています。

Windowsノード

Windows ノードで Trident を実行できるようにするには：

tridentctl install --windows -n trident
強制的に切り離す

詳細については、"Tridentを使用したステートフルアプリケーションのフェイルオーバーの自動化"を参照してください。

tridentctl install --enable-force-detach=true -n trident
同時実行Tridentコントローラー操作を有効にする

スループットを向上させるために同時実行Tridentコントローラ処理を有効にするには、この例に示すように、インストール中に `--enable-concurrency`オプションを追加します。

メモ Tech Preview：この機能は試験的なもので、現在、ONTAP-NAS（NFSのみ）およびONTAP-SAN（統合ONTAP 9のNVMe）ドライバを使用した限定的な並列ワークフローをサポートしています。これは、既存のONTAP-SANドライバ（統合ONTAP 9のiSCSIおよびFCPストレージ プロトコル）のTech Previewに加えてのものです。 
tridentctl install --enable-concurrency -n trident