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

使用tridentct利 管理Astra三端

贡献者

"Trident 安装程序包" 包括 tridentctl 使用命令行实用程序可以轻松访问Astra三端技术。具有足够权限的Kubornetes用户可以使用它来安装Astra Dent或管理包含Astra Dent Pod的命名空间。

命令和全局标志

您可以运行 tridentctl help 以获取可用命令的列表 tridentctl 或附加 --help 用于任何命令的标志、以获取该特定命令的选项和标志列表。

tridentctl [command] [--optional-flag]

Astra三项功能 tridentctl 实用程序支持以下命令和全局标志。

命令
create

将资源添加到Asta Trdent。

delete

从Asta Trdent中删除一个或多个资源。

get

从Asta三端获取一个或多个资源。

help

有关任何命令的帮助。

images

打印一个表格、其中包含Asta Trident所需的容器图像。

import

将现有资源导入到Asta Trident中。

install

安装 Astra Trident 。

logs

从Asta Trdent打印日志。

send

从Asta Trendent发送资源。

卸载

卸载Astra trident。

update

在Asta Dent中修改资源。

update backend state

暂时暂停后端操作。

upgrade

升级Asta Trdent中的资源。

ve版本

打印Asta Trdent的版本。

全局标志
-d--debug

调试输出。

-h--help

帮助 tridentctl

-k--kubeconfig string

指定 KUBECONFIG 在本地或从一个Kubornetes集群到另一个集群运行命令的路径。

备注 或者、您也可以导出 KUBECONFIG 变量、用于指向特定的Kubbernetes集群和问题描述 tridentctl 命令。
-n--namespace string

Astra三端部署的命名空间。

-o--output string

输出格式。json_yaml_name_wide|ps 之一(默认)。

-s--server string

Asta三端REST接口的地址/端口。

警告 可以将 Trident REST 接口配置为仅以 127.0.0.1 (对于 IPv4 )或(:: 1 )(对于 IPv6 )侦听和提供服务。

命令选项和标志

创建

使用 create 用于向Astra Trident添加资源的命令。

tridentctl create [option]

选项

backend:将后端添加到Astra Trident。

删除

使用 delete 用于从Astra Trident中删除一个或多个资源的命令。

tridentctl delete [option]

选项

backend:从Astra Trident中删除一个或多个存储后端。
snapshot:从Astra Trident中删除一个或多个卷快照。
storageclass:从Astra Trident中删除一个或多个存储类。
volume:从Astra Trident中删除一个或多个存储卷。

获取

使用 get 用于从Astra Trident获取一个或多个资源的命令。

tridentctl get [option]

选项

backend:从Astra Trident获取一个或多个存储后端。
snapshot:从Astra Trident获取一个或多个快照。
storageclass:从Astra Trident获取一个或多个存储类。
volume:从Astra Trident获取一个或多个卷。

标志

-h--help:卷帮助。
--parentOfSubordinate string:将查询限制为从源卷。
--subordinateOf string:将查询限制为卷的下属。

映像

使用 …​ images 用于打印Asta Trident所需容器映像表的标志。

tridentctl images [flags]

标志

-h--help:图像帮助。
-v--k8s-version string:Kubornetes集群的语义版本。

导入卷

使用 import volume 用于将现有卷导入到Astra Trident的命令。

tridentctl import volume <backendName> <volumeName> [flags]

别名

volumev

标志

-f--filename string:YAML或JSON PVC文件的路径。
-h--help:卷的帮助。
--no-manage:仅创建PV/PVC。不要假定卷生命周期管理。

安装

使用 install 用于安装Astra Trident的标志。

tridentctl install [flags]

标志

--autosupport-image string:AutoSupport遥测的容器映像(默认为"NetApp/TRIMT autostsupport:<current-version>")。
--autosupport-proxy string:用于发送AutoSupport 遥测的代理的地址/端口。
--enable-node-prep:尝试在节点上安装所需的软件包。
--generate-custom-yaml:在不安装任何内容的情况下生成YAML文件。
-h--help:安装帮助。
--http-request-timeout:覆盖三端控制器的REST API的HTTP请求超时(默认值为1 m30)。
--image-registry string:内部映像注册表的地址/端口。
--k8s-timeout duration:所有Kubernetes操作的超时(默认值为3m0)。
--kubelet-dir string:kubelet内部状态的主机位置(默认值为"/var/lib/kubelet")。
--log-format string:Astra Trident日志记录格式(文本、json)(默认为"text")。
--pv string:Astra Trident使用的原有PV的名称可确保此名称不存在(默认为"trident ")。
--pvc string:Asta三端图使用的原有PVC的名称,确保不存在(默认为“三端图”)。
--silence-autosupport:不要自动向NetApp发送AutoSupport 捆绑包(默认为true)。
--silent:在安装期间禁用大多数输出。
--trident-image string:要安装的Astra Trident映像。
--use-custom-yaml:使用设置目录中的任何现有YAML文件。
--use-ipv6:使用IPv6进行Astra Trident的通信。

日志

使用 …​ logs 用于从Astra Trident打印日志的标志。

tridentctl logs [flags]

标志

-a--archive:除非另有说明、否则使用所有日志创建支持归档。
-h--help:日志帮助。
-l--log string:要显示的Astra Trident日志。Trident 中的一个 "auto"|trident 操作符 "All" (默认为 "auto" )。
--node string:要从中收集节点Pod日志的Kubernetes节点名称。
-p--previous:获取先前容器实例的日志(如果存在)。
--sidecars:获取sidecar容器的日志。

发送

使用 send 用于从Astra Trident发送资源的命令。

tridentctl send [option]

选项

autosupport:将AutoSupport 归档发送给NetApp。

卸载

使用 …​ uninstall 用于卸载Astra Trident的标志。

tridentctl uninstall [flags]

标志

-h, --help:卸载帮助。
--silent:卸载期间禁用大多数输出。

更新

使用 update 命令以修改Asta Dent中的资源。

tridentctl update [option]

选项

backend:在Astra Trident中更新后端。

更新后端状态

使用 update backend state 用于暂停或恢复后端操作的命令。

tridentctl update backend state <backend-name> [flag]

需要考虑的要点
  • 如果使用TridentBackendConfig (tbc)创建后端、则无法使用文件更新后端 backend.json

  • 如果 userState 已在tbc中设置、则无法使用命令修改 tridentctl update backend state <backend-name> --user-state suspended/normal

  • 通过tbc设置后、要重新获得通过tldentctt设置的功能 userState 、必须从tbc中删除该 userState 字段。可以使用命令来完成此操作 kubectl edit tbc 。删除此字段后 userState 、您可以使用 tridentctl update backend state 命令更改 userState 后端的。

  • 使用 tridentctl update backend state 更改 userState。您还可以使用或文件更新 userState TridentBackendConfig backend.json ;这会触发后端的完全重新初始化、并且可能会非常耗时。

    标志

    -h--help:后端状态帮助。
    --user-state:设置为 suspended 暂停后端操作。设置为 normal 恢复后端操作。设置为时 suspended

  • AddVolumeImport Volume 已暂停。

  • CloneVolumeResizeVolume PublishVolume、、 UnPublishVolumeCreateSnapshot GetSnapshot RestoreSnapshotDeleteSnapshot、、 RemoveVolumeGetVolumeExternal ReconcileNodeAccess 保持可用。

您也可以使用后端配置文件或中的字段更新后端状态 userState TridentBackendConfig backend.json。有关详细信息,请参阅 "用于管理后端的选项""使用 kubectl 执行后端管理"

  • 示例: *

JSON

按照以下步骤使用文件更新 userState backend.json

  1. 编辑 backend.json 文件以包含 userState 字段、并将其值设置为"已附加"。

  2. 使用命令和更新后的文件的路径更新后端 tridentctl backend update backend.json

    示例tridentctl backend update -f /<path to backend JSON file>/backend.json

{
    "version": 1,
    "storageDriverName": "ontap-nas",
    "managementLIF": "<redacted>",
    "svm": "nas-svm",
    "backendName": "customBackend",
    "username": "<redacted>",
    "password": "<redacted>",
    "userState": "suspended",
}
YAML

您可以在使用命令应用tbc后对其进行编辑 kubectl edit <tbc-name> -n <namespace> 。以下示例使用选项将后端状态更新为暂停 userState: suspended

apiVersion: trident.netapp.io/v1
kind: TridentBackendConfig
metadata:
  name: backend-ontap-nas
spec:
  version: 1
  backendName: customBackend
  storageDriverName: ontap-nas
  managementLIF: <redacted>
  svm: nas-svm
userState: suspended
  credentials:
    name: backend-tbc-ontap-nas-secret

version

使用 …​ version 用于打印版本的标志 tridentctl 以及正在运行的Trident服务。

tridentctl version [flags]

标志

--client:仅限客户端版本(不需要服务器)。
-h, --help:版本帮助。