使用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]
- 别名
-
volume
,v
- 标志
-
-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
:
-
AddVolume
和Import Volume
已暂停。 -
CloneVolume
、ResizeVolume
PublishVolume
、、UnPublishVolume
、CreateSnapshot
GetSnapshot
RestoreSnapshot
、DeleteSnapshot
、、RemoveVolume
、GetVolumeExternal
ReconcileNodeAccess
保持可用。
您也可以使用后端配置文件或中的字段更新后端状态 userState
TridentBackendConfig
backend.json
。有关详细信息,请参阅 "用于管理后端的选项" 和 "使用 kubectl 执行后端管理"。
-
示例: *
按照以下步骤使用文件更新 userState
backend.json
:
-
编辑
backend.json
文件以包含userState
字段、并将其值设置为"已附加"。 -
使用命令和更新后的文件的路径更新后端
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", }
您可以在使用命令应用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
:版本帮助。