Skip to main content
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

使用 tridentctl 安装

PDF

您可以使用 `tridentctl`安装 Trident。此过程适用于 Trident 所需的容器镜像存储在私有注册表中或不存储在私有注册表中的安装。要自定义 `tridentctl`部署，请参阅"自定义 tridentctl 部署"。

有关 Trident10 的关键信息

您必须阅读以下有关 Trident 的重要信息。

<strong>有关 Trident 的重要信息</strong>

  • Trident 现在支持 Kubernetes 1.27。在升级 Kubernetes 之前升级 Trident。

  • Trident 严格执行在 SAN 环境中使用多路径配置，在 multipath.conf 文件中的建议值为 find_multipaths: no。

    使用非多路径配置或在 multipath.conf 文件中使用 find_multipaths: yes`或 `find_multipaths: smart`值将导致挂载失败。自 21.07 版本发布以来，Trident 建议使用 `find_multipaths: no。

使用 tridentctl 安装 Trident

请检查 "安装概述" 以确保您已满足安装先决条件，并为您的环境选择了正确的安装选项。

开始之前

在开始安装之前，请登录到 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 镜像的 Pod，并通过 Pod 网络到达您的存储系统：

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

步骤 1：下载 Trident 安装程序包

Trident 安装程序包创建一个 Trident pod，配置用于维护其状态的 CRD 对象，并初始化 CSI sidecar 以执行配置和将卷附加到集群主机等操作。从 "GitHub 上的 Assets 部分" 下载并提取最新版本的 Trident 安装程序。使用您选择的 Trident 版本更新示例中的 <trident-installer-XX.XX.X.tar.gz>。

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

通过执行 `tridentctl install`命令在所需的命名空间中安装 Trident。您可以添加其他参数以指定映像注册表位置。

标准模式
./tridentctl install -n trident
一个注册表中的图像
./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.
....

验证安装

您可以使用 Pod 创建状态或 `tridentctl`来验证您的安装。

使用 pod 创建状态

您可以通过查看已创建的 Pod 的状态来确认 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 节点

要启用 Trident 在 Windows 节点上运行：

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 协议）。 
tridentctl install --enable-concurrency -n trident