深挖Openstack Cinder - CLI命令（3）

萧辰沛

2023-12-01

======================回忆上篇 Cinder CLI命令（2）===============================

四. 后端服务

1. 列出所有后端服务

cinderservice-list [--host <hostname>] [--binary <binary>]

参数：

参数	含义
host	根据主机名来筛选
binary	根据服务名称来筛选

2. 启用服务

cinderservice-enable <hostname> <binary>

参数：

参数	含义
hostname	主机名
binary	服务名称

3. 禁用服务

cinderservice-disable [--reason <reason>] <hostname> <binary>

参数：

参数	含义
reason	禁用原因
hostname	主机名
binary	服务名称

五. 卷转移

1. 创建转移卷

cindertransfer-create [--name <name>] <volume>

参数：

参数	含义
name	转移卷名
volume	卷名或ID，发送方提供的卷

2. 查看转移卷详情

cindertransfer-show <transfer>

参数：

参数	含义
transfer	转移卷名或ID

3. 接收转移卷

cindertransfer-accept <transfer> <auth_key>

参数：

参数	含义
transfer	接收方准备接收的转移卷ID
auth_key	发送方提供的auth_key值

4. 列出所有转移卷

cindertransfer-list [--all-tenants [<0|1>]]

参数：

参数	含义
all-tenants	是否列出所有租户的转移卷，0:不是，1:是，只能Admin使用

5. 删除转移卷

cindertransfer-delete <transfer>

参数：

参数	含义
transfer	转移卷名或ID

六. 一致性组

1. 创建一致性组

cinderconsisgroup-create [--name <name>] [--description <description>]

[--availability-zone<availability-zone>]

<volume-types>

参数：

参数	含义
name	一致性组名
description	一致性组描述信息
availability-zone	可用的zone
volume-types	卷类型

2. 其他方式创建一致性组

cinderconsisgroup-create-from-src [--cgsnapshot <cgsnapshot>]

[--source-cg<source-cg>]

[--name <name>]

[--description<description>]

参数：

参数	含义
cgsnapshot	一致性组快照名或ID
source-cg	源一致性组名或ID
name	一致性组名
description	一致性组描述信息

3. 删除一致性组

cinderconsisgroup-delete [--force]

<consistencygroup>[<consistencygroup> ...]

参数：

参数	含义
force	是否允许删除该一致性组，如果该一致性组为空，则可直接删除；如果不为空，则需要该参数指定是否可删除。
consistencygroup	一致性组名或ID，删除一个或多个一致性组

4. 查看一致性组详情

cinderconsisgroup-show <consistencygroup>

参数：

参数	含义
consistencygroup	一致性组名或ID

5. 更新一致性组

cinderconsisgroup-update [--name <name>] [--description <description>]

[--add-volumes<uuid1,uuid2,......>]

[--remove-volumes<uuid3,uuid4,......>]

参数：

参数	含义
name	一致性组新名
description	一致性组新描述信息
add-volumes	添加一个或多个卷到该一致性组，列出添加的卷UUID，以逗号隔开
remove-volumes	从该一致性组移除一个或多个卷，列出移除的卷UUID，以逗号隔开
consistencygroup	一致性组名或ID

6. 列出所有一致性组

cinderconsisgroup-list [--all-tenants [<0|1>]]

参数：

参数	含义
all-tenants	是否列出所有租户的一致性组，0:不是，1:是，只能Admin使用

7. 创建一致性组快照

cindercgsnapshot-create [--name <name>] [--description <description>]

参数：

参数	含义
name	快照名
description	快照描述信息
consistencygroup	一致性组名或ID

8. 删除一致性组快照

cindercgsnapshot-delete <cgsnapshot> [<cgsnapshot> ...]

参数：

参数	含义
cgsnapshot	一致性组快照名或ID，删除一个或多个一致性组快照

9. 查看一致性组快照详情

cindercgsnapshot-show <cgsnapshot>

参数：

参数	含义
cgsnapshot	一致性组快照名或ID

10. 列出所有一致性组快照

cindercgsnapshot-list [--all-tenants [<0|1>]] [--status <status>]

[--consistencygroup-id<consistencygroup_id>]

参数：

参数	含义
all-tenants	是否列出所有租户的一致性组快照，0:不是，1:是，只能Admin使用
status	根据一致性组快照状态来筛选
consistencygroup-id	根据一致性组ID来筛选

七. 磁盘配额

1. 查看配额类详情

cinderquota-class-show <class>

参数：

参数	含义
class	配额类名

2. 修改配额类

cinderquota-class-update [--volumes <volumes>]

[--snapshots <snapshots>]

[--gigabytes<gigabytes>]

[--volume-type<volume_type_name>]

<class_name>

参数：

参数	含义
volumes	卷配新额值
snapshots	快照新配额值
gigabytes	千兆字节新配额值
volume-type	卷类型
class_name	配额类名

3. 列出租户的默认配额

cinderquota-defaults <tenant_id>

参数：

参数	含义
tenant_id	租户ID

4. 查看租户的配额详情

cinder quota-show<tenant_id>

参数：

参数	含义
tenant_id	租户ID

5. 删除租户的配额

cinderquota-delete <tenant_id>

参数：

参数	含义
tenant_id	租户UUID

6. 更新租户的配额

cinderquota-update [--volumes <volumes>] [--snapshots <snapshots>]

[--gigabytes<gigabytes>] [--backups <backups>]

[--backup-gigabytes<backup_gigabytes>]

[--consistencygroups<consistencygroups>]

[--volume-type <volume_type_name>]

[--per-volume-gigabytes<per_volume_gigabytes>]

<tenant_id>

参数：

参数	含义
volumes	卷新的配额值
snapshots	快照新的配额值
gigabytes	盘新的配额值
backups	备份新的配额值
backup-gigabytes	备份盘新的配额值
consistencygroups	一致性组新的配额值
volume-type	卷类型
per-volume-gigabytes	设置卷大小的最大值
tenant_id	租户ID

7. 列出租户已使用的配额

cinder quota-usage<tenant_id>

参数：

参数	含义
tenant_id	租户ID

八. QoS

1. 创建QoS

cinder qos-create<name> <key=value> [<key=value> ...]

参数：

参数	含义
name	QoS名
key=value	QoS规格，key-value形式

2. 删除QoS

cinder qos-delete[--force [<True|False>]] <qos_specs>

参数：

参数	含义
force	是否允许删除正在使用的QoS，True:是，False:否
qos_specs	QoS ID

3. 建立指定卷类型与QoS的联系

cinderqos-associate <qos_specs> <volume_type_id>

参数：

参数	含义
qos_specs	QoS ID
volume_type_id	与QoS建立联系的卷类型ID

4. 解除指定卷类型与QoS的联系

cinderqos-disassociate <qos_specs> <volume_type_id>

参数：

参数	含义
qos_specs	QoS ID
volume_type_id	与QoS解除联系的卷类型ID

5. 解除QoS所有联系

cinderqos-disassociate-all <qos_specs>

参数：

参数	含义
qos_specs	QoS ID

6. 列出与QoS相关的所有联系

cinderqos-get-association <qos_specs>

参数：

参数	含义
qos_specs	QoS ID

7. 查看QoS详情

cinder qos-show<qos_specs>

参数：

参数	含义
qos_specs	QoS ID

8. 列出所有QoS

cinder qos-list

9. 设置/取消QoS

cinder qos-key<qos_specs> <action> key=value [key=value ...]

参数：

参数	含义
qos_specs	QoS ID
action	set:设置 unset:取消
key=value	QoS元数据的key-value键值对。如果是unset，只提供key

九. 卷类型

1. 创建卷类型

cinder type-create[--description <description>]

[--is-public <is-public>]

<name>

参数：

参数	含义
description	卷类型描述信息
is-public	是否公开该卷类型
name	卷类型名

2. 列出所有默认的卷类型

cindertype-default

3. 删除卷类型

cinder type-delete<id>

参数：

参数	含义
id	卷类型ID

4. 修改卷类型

cinder type-update[--name <name>] [--description <description>] <id>

参数：

参数	含义
name	卷类型名
description	卷类型描述信息
id	卷类型ID

5. 列出所有可用的卷类型

cinder type-list

Admin只能看到私有类型

6. 设置/取消卷类型的额外属性

cinder type-key<vtype> <action> <key=value> [<key=value> ...]

参数：

参数	含义
vtype	卷类型名或ID
action	set:设置 unset:取消
key=value	卷类型额外属性的key-value键值对。如果是unset，只提供key

7. 给指定项目添加卷类型

cindertype-access-add --volume-type <volume_type>

--project-id <project_id>

参数：

参数	含义
volume-type	卷类型名或ID
project-id	项目ID

8. 列出卷类型的使用情况

cindertype-access-list --volume-type <volume_type>

参数：

参数	含义
volume-type	根据卷类型名或ID来筛选

9. 从指定项目移除卷类型

cinder type-access-remove --volume-type<volume_type>

--project-id <project_id>

参数：

参数	含义
volume-type	卷类型名或ID
project_id	项目ID

10. 修改卷的类型

cinder retype[--migration-policy <never|on-demand>]

参数：

参数	含义
migration-policy	修改卷的类型过程中的迁移策略
volume	卷名或ID
volume-type	卷新的类型

十. 加密（只有Admin身份才能调用）

1. 给指定卷类型创建加密类型(Admin only)

cinderencryption-type-create [--cipher <cipher>]

[--key_size<key_size>]

[--control_location<control_location>]

<volume_type> <provider>

参数：

参数	含义
cipher	加密算法或模式，比如：aes-xts-plain64
key_size	密钥大小，比如：128位或256位
control_location	实施加密的服务，参数值为front-end或back-end，比如：front-end=Nova
volume_type	卷类型名或ID
provider	加密类型的提供者，比如：LuksEncryptor

2. 从指定卷类型移除加密类型(Admin only)

cinderencryption-type-delete <volume_type>

参数：

参数	含义
volume_type	卷类型名或ID

3. 查看指定卷类型的加密类型详情(Admin only)

cinderencryption-type-show <volume_type>

参数：

参数	含义
volume_type	卷类型名或ID

4. 修改指定卷类型的加密类型(Admin only)

cinderencryption-type-update [--provider <provider>]

[--cipher [<cipher>]]

[--key-size[<key-size>]]

[--control-location<control-location>]

<volume-type>

参数：

参数	含义
provider	加密类型的提供者，比如：LuksEncryptor
cipher	加密算法或模式，比如：aes-xts-plain64
key_size	密钥大小，比如：128位或256位
control_location	实施加密的服务，参数值为front-end或back-end，比如：front-end=Nova
volume_type	卷类型名或ID

5. 列出所有加密类型(Admin only)

cinderencryption-type-list

十一. 其他

1. 查看帮助信息

cinder help

2. 列出当前用户的所有资源限制值

cinderabsolute-limits

3. 列出所有的速度限制

cinder rate-limits

4. 列出所有可用的zone

cinderavailability-zone-list

5. 列出当前用户的keystone认证信息

cinder credentials

6. 发现注册的endpoints

cinder endpoints

7. 列出当前卷类型和额外规格

cinderextra-specs-list

8. 查看后端卷的状态和属性(Admin only)

cinderget-capabilities <host>

参数：

参数	含义
host	Cinder主机

9. 查看后端池的信息详情(Admin only)
cinder get-pools [--detail]

参数：

参数	含义
detail	显示池的详细信息

10. 设置/取消卷镜像的元数据

cinderimage-metadata <volume> <action> <key=value>[<key=value> ...]

参数：

参数	含义
volume	卷名或ID
action	set:设置 unset:取消
key=value	卷镜像元数据的key-value键值对。如果是unset，只提供key

11. 促进第二卷为主要关系

cinderreplication-promote <volume>

参数：

参数	含义
volume	卷名或ID，该卷应具有源副本参数创建的副本卷

12. 同步第二卷为主要关系

cinderreplication-reenable <volume>

参数：

参数	含义
volume	卷名或ID，该卷的复制状态应为inactive

13. 列出所有命令和参数

cinderbash-completion

14. 列出所有可用的操作系统接口扩展

cinderlist-extensions

==============Cinder CLI命令完结======================