Linstor常用命令

V2.0

以下是 Linstor 常用命令及其详解 的优化整理版，涵盖命令用途、参数说明和输出效果，结构清晰、描述完整，方便用于日常操作与学习参考。

---

🌐 Linstor 简介

Linstor 是一个开源的分布式存储管理平台，用于配置、分配和管理基于 DRBD 的块存储卷。它适用于 Kubernetes、OpenStack、Proxmox 等环境，支持通过命令行或 API 进行资源编排和快照管理。

---

🧩 常用命令分类汇总

一、📡 节点管理（Node）

1. 创建节点

linstor node create <node-name> <ip> [--node-type=<type>]

• 用途：将新节点注册到集群中。

• 参数：

  • <node-name>：节点名称
  • <ip>：节点的管理 IP 地址
  • --node-type：可选，指定类型（如 Combined, Satellite, Controller）

• 示例：

  linstor node create node1 10.0.0.11
  

2. 列出节点

linstor node list

• 用途：查看当前所有注册节点的状态和信息。

• 输出内容：

  • 节点名、IP、类型、在线状态、存储池状态等

---

二、📦 存储池管理（Storage Pool）

3. 创建存储池

linstor storage-pool create lvm <node> <pool-name> <volume-group>

• 用途：在指定节点上创建一个逻辑卷管理（LVM）类型的存储池。

• 参数：

  • <node>：节点名称
  • <pool-name>：存储池名称
  • <volume-group>：LVM 的 VG 名称

• 示例：

  linstor storage-pool create lvm node1 pool1 vg_data
  

4. 列出存储池

linstor storage-pool list

• 用途：查看所有节点上的存储池信息。

• 输出内容：

  • 节点名、存储池名、类型、总容量、可用空间等

---

三、📂 资源管理（Resource）

5. 创建资源（存储卷）

linstor resource create <resource-name> --size <size> --storage-pool <pool>

• 用途：创建一个逻辑存储资源。

• 参数：

  • <resource-name>：资源名称
  • --size：大小，例如 10G
  • --storage-pool：目标存储池名称

• 示例：

  linstor resource create myvol --size 20G --storage-pool pool1
  

6. 列出资源

linstor resource list

• 用途：显示所有创建的资源信息。

• 输出内容：

  • 资源名、节点、副本数、使用存储池等

7. 显示资源详情

linstor resource show <resource-name>

• 用途：查看指定资源的完整配置、状态及副本信息。

8. 查看资源映射

linstor resource map <resource-name>

• 用途：查看资源在哪些节点上部署及其角色（如主、副）。

---

四、💿 卷管理（Volume）

9. 创建卷（不常用，已由资源命令隐式完成）

linstor volume create <resource-name> <volume-number> --size <size>

• 用途：为资源添加指定编号的卷。
• 一般推荐使用 resource create 来创建资源及卷

10. 列出卷

linstor volume list

• 用途：查看所有卷的信息，如大小、状态、所属资源。

---

五、📸 快照管理（Snapshot）

11. 创建快照

linstor snapshot create <resource-name> <volume-number> <snapshot-name>

• 用途：为指定资源的卷创建快照。

• 参数说明：

  • <volume-number>：通常为 0
  • <snapshot-name>：快照的名称

• 示例：

  linstor snapshot create myvol 0 snap1
  

12. 列出快照

linstor snapshot list <resource-name>

• 用途：列出某资源下的所有快照。

13. 恢复快照

linstor snapshot restore <resource-name> <volume-number> <snapshot-name>

• 用途：将卷内容还原为指定快照的状态。

---

🔧 其它实用命令

• linstor help：查看 Linstor 所有可用命令。
• linstor <command> --help：查看某个子命令的详细参数与用法。

---

📚 小贴士

• 推荐先部署好 Linstor Controller 与 Satellite 节点，再进行资源操作。
• 存储池需在每个节点本地先建立好如 LVM 的 Volume Group。
• Linstor 支持自动放置策略，可结合 Kubernetes CSI 插件实现自动动态卷调度。

---

如需了解更多高级用法（如自动副本、同步模式、控制器 HA），可参考官方文档：https://linbit.com/drbd-user-guide/linstor-guide-1_0-en/

是否需要我继续补充：

• Kubernetes 集成 CSI 插件使用方法？
• Linstor 高可用配置与容灾策略？
• 与 DRBD、Pacemaker 联动示例？

V1.0

Linstor 是一个开源的分布式存储管理工具，用于管理分布式存储卷。它提供了一组命令行工具来执行各种操作，以便用户可以使用 Linstor 在集群中创建、配置、管理和监视存储卷。

以下是一些常用的 Linstor 命令及其详细介绍：

1. linstor node create <node-name> <storage-pool>：创建一个新的存储节点，并将其与指定的存储池相关联。该命令用于将物理或虚拟机节点添加到 Linstor 集群中。

2. linstor node list：列出所有已注册的存储节点。这个命令可以显示节点的名称、IP 地址和状态等信息。

3. linstor resource create <resource-name> <volume-size> <storage-pool>：在 Linstor 中创建一个新的资源（存储卷）。您需要指定资源的名称、大小以及要使用的存储池。

4. linstor resource list：列出所有已创建的资源。这个命令可以显示资源的名称、大小、所在节点、存储池等信息。

5. linstor resource show <resource-name>：显示特定资源的详细信息，包括该资源的状态、副本数、当前位置等。

6. linstor resource map <resource-name>：显示指定资源的映射信息，即该资源在哪些节点上可见并可用。

7. linstor volume create <resource-name> <volume-name>：在指定的资源上创建一个新的卷。您需要提供资源名称和卷名称。

8. linstor volume list：列出所有已创建的卷。这个命令可以显示卷的名称、大小、所属资源等信息。

9. linstor volume snapshot create <resource-name> <volume-name> <snapshot-name>：为指定的卷创建一个快照。您需要提供资源名称、卷名称以及快照名称。

10. linstor volume snapshot list：列出指定资源下所有已创建的快照。

11. linstor volume snapshot restore <resource-name> <volume-name> <snapshot-name>：从指定的快照还原卷。这将使用快照数据替换当前卷的内容。

12. linstor storage-pool list：列出所有已创建的存储池。这个命令可以显示存储池的名称、节点、容量等信息。

这些是 Linstor 的一些常用命令，每个命令都有更多选项和参数，可以根据需要进行进一步的配置和管理。您可以使用 linstor --help 命令来查看完整的命令列表和其它相关选项。