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

Tridentオペレータを手動で導入（オフラインモード）

10/30/2024 共同作成者

Tridentオペレータが手動で導入してAstra Tridentをインストールできます。このプロセスでは、環境をインストールする際に、Astra Tridentで必要なコンテナイメージがプライベートレジストリに格納されます。プライベートイメージレジストリがない場合は、を使用し"標準的な導入のプロセス"ます。

Astra Tridentに関する重要な情報24.06

Astra Tridentに関する次の重要な情報をお読みください。*

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

Astra TridentでKubernetes 1.31がサポートされるようになりました。Kubernetesをアップグレードする前にTridentをアップグレード
Astra Tridentでは、SAN環境でのマルチパス構成の使用が厳密に実施されます。multipath.confファイルの推奨値はです find_multipaths: no。

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

Tridentオペレータを手動で導入し、Tridentをインストール

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

開始する前に

Linuxホストにログインし、動作中のを管理していること、および必要なPrivilegesがあることを確認します"サポートされる Kubernetes クラスタ"。

OpenShiftでは、以降のすべての例での代わり `kubectl`にを使用し、または `oc login -u kube-admin`を `oc`実行して最初に* system:admin *としてログインし `oc login -u system:admin`ます。

Details

Kubernetesのバージョンを確認します。
```
kubectl version
```
クラスタ管理者の権限を確認します。
```
kubectl auth can-i '*' '*' --all-namespaces
```
Docker Hubのイメージを使用してポッドを起動し、ポッドネットワーク経由でストレージシステムにアクセスできることを確認します。
```
kubectl run -i --tty ping --image=busybox --restart=Never --rm -- \
  ping <management IP>
```

手順1：Tridentのインストーラパッケージをダウンロード

Astra Tridentインストーラパッケージには、Tridentオペレータの導入とAstra Tridentのインストールに必要なものがすべて含まれています。からTridentインストーラの最新バージョンをダウンロードして展開し"GitHubの_Assets_sectionを参照してください"ます。

wget https://github.com/NetApp/trident/releases/download/v24.06.0/trident-installer-24.06.0.tar.gz
tar -xf trident-installer-24.06.0.tar.gz
cd trident-installer

手順2：CRDを作成する `TridentOrchestrator`

カスタムリソース定義（CRD）を作成し `TridentOrchestrator`ます。後でカスタムリソースを作成し `TridentOrchestrator`ます。で適切なCRD YAMLバージョンを使用して `deploy/crds`CRDを作成し `TridentOrchestrator`ます。

kubectl create -f deploy/crds/<VERSION>.yaml

手順3：オペレータのレジストリの場所を更新します

で /deploy/operator.yaml、イメージレジストリの場所を反映するように更新し image: docker.io/netapp/trident-operator:24.06.0 ます。は "TridentとCSIの画像" 1つのレジストリまたは別のレジストリに配置できますが、すべてのCSIイメージは同じレジストリに配置する必要があります。例：

image: <your-registry>/trident-operator:24.06.0 イメージがすべて1つのレジストリに格納されている場合。
image: <your-registry>/netapp/trident-operator:24.06.0 TridentイメージがCSIイメージとは別のレジストリにある場合。

ステップ4：Tridentオペレータを導入

Astra Tridentインストーラには、オペレータのインストールや関連オブジェクトの作成に使用できるバンドルファイルが用意されています。このバンドルファイルを使用すると、オペレータを簡単に導入し、デフォルトの設定でAstra Tridentをインストールできます。

クラスタでKubernetes 1.24を実行している場合は、を使用し `bundle_pre_1_25.yaml`ます。
クラスタでKubernetes 1.25以降を実行している場合は、を使用します bundle_post_1_25.yaml。

開始する前に

デフォルトでは、Tridentインストーラによってネームスペースにオペレータが配置され trident`ます。ネームスペースが存在しない場合は `trident、次のコマンドを使用して作成します。
```
kubectl apply -f deploy/namespace.yaml
```
名前空間以外の名前空間にオペレータを配置するには trident、 clusterrolebinding.yaml`を使用してバンドルファイルを更新し `serviceaccount.yaml、 operator.yaml`生成します `kustomization.yaml。
1. 次のコマンドを使用して、<bundle.yaml> bundle_pre_1_25.yaml `bundle_post_1_25.yaml`のバージョンに基づいてを作成し `kustomization.yaml`ます。
  cp deploy/kustomization_<bundle.yaml> deploy/kustomization.yaml
2. 次のコマンドWHERE__ ISまたは `bundle_post_1_25.yaml`使用している<bundle.yaml>のバージョンに基づいて、バンドルをコンパイルし `bundle_pre_1_25.yaml`ます。
  kubectl kustomize deploy/ > deploy/<bundle.yaml>

手順

リソースを作成し、オペレータを配置します。
```
kubectl create -f deploy/<bundle.yaml>
```
operator、deployment、およびReplicaSetsが作成されたことを確認します。
```
kubectl get all -n <operator-namespace>
```

Kubernetes クラスタには、オペレータのインスタンスが * 1 つしか存在しないようにしてください。Trident のオペレータが複数の環境を構築することは避けてください。

手順5： `TridentOrchestrator`

は "TridentとCSIの画像" 1つのレジストリまたは別のレジストリに配置できますが、すべてのCSIイメージは同じレジストリに配置する必要があります。レジストリ構成に基づいて追加のロケーション仕様を追加するには、更新し `deploy/crds/tridentorchestrator_cr.yaml`ます。

1つのレジストリ内のイメージ

imageRegistry: "<your-registry>"
autosupportImage: "<your-registry>/trident-autosupport:24.06"
tridentImage: "<your-registry>/trident:24.06.0"

異なるレジストリ内の画像

別のレジストリの場所を使用するには、をに imageRegistry`追加する必要があります `sig-storage。

imageRegistry: "<your-registry>/sig-storage"
autosupportImage: "<your-registry>/netapp/trident-autosupport:24.06"
tridentImage: "<your-registry>/netapp/trident:24.06.0"

手順6：を作成 `TridentOrchestrator`してTridentをインストールする

これで、を作成してAstra Tridentをインストールできます TridentOrchestrator。必要に応じて、仕様内の属性をさらに使用 `TridentOrchestrator`できます"Tridentのインストールをカスタマイズ"。次の例は、TridentイメージとCSIイメージが異なるレジストリにあるインストールを示しています。

kubectl create -f deploy/crds/tridentorchestrator_cr.yaml
tridentorchestrator.trident.netapp.io/trident created

kubectl describe torc trident

Name:        trident
Namespace:
Labels:      <none>
Annotations: <none>
API Version: trident.netapp.io/v1
Kind:        TridentOrchestrator
...
Spec:
  Autosupport Image:  <your-registry>/netapp/trident-autosupport:24.06
  Debug:              true
  Image Registry:     <your-registry>/sig-storage
  Namespace:          trident
  Trident Image:      <your-registry>/netapp/trident:24.06.0
Status:
  Current Installation Params:
    IPv6:                       false
    Autosupport Hostname:
    Autosupport Image:          <your-registry>/netapp/trident-autosupport:24.06
    Autosupport Proxy:
    Autosupport Serial Number:
    Debug:                      true
    Http Request Timeout:       90s
    Image Pull Secrets:
    Image Registry:       <your-registry>/sig-storage
    k8sTimeout:           30
    Kubelet Dir:          /var/lib/kubelet
    Log Format:           text
    Probe Port:           17546
    Silence Autosupport:  false
    Trident Image:        <your-registry>/netapp/trident:24.06.0
  Message:                Trident installed
  Namespace:              trident
  Status:                 Installed
  Version:                v24.06.0
Events:
    Type Reason Age From Message ---- ------ ---- ---- -------Normal
    Installing 74s trident-operator.netapp.io Installing Trident Normal
    Installed 67s trident-operator.netapp.io Trident installed

インストールの確認

インストールを確認するには、いくつかの方法があります。

ステータスの使用 `TridentOrchestrator`

のステータス TridentOrchestrator`は、インストールが正常に完了したかどうかを示し、インストールされているTridentのバージョンを表示します。インストール中に、のステータス `TridentOrchestrator`がからに `Installed`変わります `Installing。ステータスを確認し、オペレータが単独で回復できない場合は Failed、を"ログをチェックしてください"参照してください。

ステータス説明

ステータス	説明
インストール	オペレータはこのCRを使用してAstra Tridentをインストールしています `TridentOrchestrator`。
インストール済み	Astra Trident のインストールが完了しました。
アンインストール中です	オペレータがAstra Tridentをアンインストールしています。 `spec.uninstall=true`
アンインストール済み	Astra Trident がアンインストールされました。
失敗	オペレータは Astra Trident をインストール、パッチ適用、更新、またはアンインストールできませんでした。オペレータはこの状態からのリカバリを自動的に試みます。この状態が解消されない場合は、トラブルシューティングが必要です。
更新中	オペレータが既存のインストールを更新しています。
エラー	は `TridentOrchestrator`使用されません。別のファイルがすでに存在します。

インストール

オペレータはこのCRを使用してAstra Tridentをインストールしています TridentOrchestrator。

インストール済み

Astra Trident のインストールが完了しました。

アンインストール中です

オペレータがAstra Tridentをアンインストールしています。
spec.uninstall=true

アンインストール済み

Astra Trident がアンインストールされました。

失敗

オペレータは Astra Trident をインストール、パッチ適用、更新、またはアンインストールできませんでした。オペレータはこの状態からのリカバリを自動的に試みます。この状態が解消されない場合は、トラブルシューティングが必要です。

更新中

オペレータが既存のインストールを更新しています。

エラー

は `TridentOrchestrator`使用されません。別のファイルがすでに存在します。

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

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

kubectl get pods -n trident

NAME                                       READY   STATUS    RESTARTS   AGE
trident-controller-7d466bf5c7-v4cpw        6/6     Running   0           1m
trident-node-linux-mr6zc                   2/2     Running   0           1m
trident-node-linux-xrp7w                   2/2     Running   0           1m
trident-node-linux-zh2jt                   2/2     Running   0           1m
trident-operator-766f7b8658-ldzsv          1/1     Running   0           3m

使用方法 `tridentctl`

を使用して、インストールされているAstra Tridentのバージョンを確認できます tridentctl。

./tridentctl -n trident version

+----------------+----------------+
| SERVER VERSION | CLIENT VERSION |
+----------------+----------------+
| 24.06.0        | 24.06.0        |
+----------------+----------------+