存储指南

流程

1. 运行以下命令，以验证集群的所有服务是否正在运行：

   $ cinder cluster-list --detailed

   或者，运行 cluster show 命令。

2. 如果有任何服务没有运行，请运行以下命令来识别这些特定服务：

   $ cinder service-list

3. 运行以下命令以触发服务器清理：

   $ cinder work-cleanup [--cluster <cluster-name>] [--host <hostname>] [--binary <binary>] [--is-up <True|true|False|false>] [--disabled <True|true|False|false>] [--resource-id <resource-id>] [--resource-type <Volume|Snapshot>]

   注意

   过滤器，如 --cluster、--host 和 --binary，定义命令清理的内容。您可以在集群名称、主机名、服务类型和资源类型上过滤，包括特定资源。如果不应用过滤，命令会尝试清理可以清理的所有内容。

   以下示例按集群名称过滤：

   $ cinder work-cleanup --cluster tripleo@tripleo_ceph

流程

1. 在仪表板中作为 admin 用户，选择 Admin > Volumes > Volume Types。
2. 单击 Create Volume Type。
3. 在 Name 字段中输入卷类型名称。
4. 单击 Create Volume Type。新类型会出现在 卷类型 表中。
5. 选择卷类型的 View Extra Specs 操作。
6. 点 Create 并指定 Key 和 Value。键值对必须有效；否则，在卷创建过程中指定卷类型将导致错误。例如，要为这个卷类型指定一个后端，请添加 volume_backend_name Key，并将 Value 设置为所需后端的名称。
7. 点 Create。相关的设置（键值对）现在会出现在 Extra Specs 表中。

流程

1. 在仪表板中作为 admin 用户，选择 Admin > Volumes > Volume Types。
2. 在 卷类型 表中，选择卷类型的 View Extra Specs 操作。

3. 在这个页面的 Extra Specs 表中，您可以：

   • 在卷类型中添加新设置。要做到这一点，点 Create 并指定您要与卷类型关联的新设置的键/值对。
   • 选择设置的 Edit 操作来编辑与卷类型关联的现有设置。
   • 选中额外 specs' 复选框，然后点击 Delete Extra Specs 以及下一个对话框中，来删除与卷类型关联的现有设置。

流程

1. 在仪表板中作为 admin 用户，选择 Admin > Volumes > Volume Types。
2. 在 QOS Specs 表中，点 Create QOS Spec。
3. 输入 QOS Spec 的名称。

4. 在 Consumer 字段中，指定 QOS 策略应强制执行的位置：

   表 2.1. 消费者类型

   类型	描述
   back-end	QOS 策略将应用到 Block Storage 后端。
   front-end	QOS 策略将应用到 Compute。
   两者	QOS 策略将应用到 Block Storage 和 Compute。

5. 点 Create。新的 QOS Spec 现在应该出现在 QOS Specs 表中。
6. 在 QOS Specs 表中，选择新的 spec 的 Manage Specs 操作。

7. 单击 Create，再指定 Key 和 Value。键值对必须有效；否则，在卷创建过程中指定与此 QOS Spec 关联的卷类型将失败。

   例如，要将读取限制 IOPS 设置为 500，请使用以下 Key/Value 对：

   read_iops_sec=500

8. 点 Create。相关的设置（键值对）现在会出现在 Key-Value Pairs 表中。

流程

1. 在仪表板中以管理员身份，选择 Admin > Volumes > Volume Types。
2. 在 卷类型 表中，选择类型的 Manage QOS Specsso 操作。
3. 从要关联的 QOS Spec 列表中选择 QOS Spec。要从现有卷类型解除 QOS 规格关联，请选择 None。
4. 点 关联。所选 QOS Spec 现在会出现在编辑卷类型的 关联 QOS Spec 列中。

流程

1. 在仪表板中作为 admin 用户，选择 Admin > Volumes > Volume Types。
2. 在要加密的卷的 Actions 列中，选择 Create Encryption 来启动 Create Volume Type Encryption 向导。

3. 在这里，配置卷类型加密的 提供程序、控制位置、Cipher 和 Key Size 设置。Description 列描述了每个设置。

   重要

   以下列表的值是 提供程序、Cipher 和 Key Size 唯一支持的选项。

   1. 为 Provider 输入 luks。
   2. 为 Cipher 输入 aes-xts-plain64。
   3. 为 Key Size 输入 256。
4. 单击 Create Volume Type Encryption。

1. 从卷类型的 Actions 列中选择 Update Encryption 来启动 Update Volume Type Encryption 向导。
2. 在 Project > Compute > Volumes 中，检查 Volumes 表中的 Encrypted 列，以确定卷是否加密。
3. 如果卷加密，点该列中的 Yes 来查看加密设置。

流程

1. 创建卷类型：

   $ cinder type-create encrypt-type

2. 配置密码、密钥大小、控制位置和供应商设置：

   $ cinder encryption-type-create --cipher aes-xts-plain64 --key-size 256 --control-location front-end encrypt-type luks

3. 创建加密的卷：

   $ cinder --debug create 1 --volume-type encrypt-type --name DemoEncVol

流程

1. 编辑环境文件，并将新条目添加到 parameter_defaults 部分。这样可确保容器更新条目，并在 director 使用 openstack overcloud deploy 命令重新部署环境时保留。

2. 使用 CinderApiPolicies 添加新部分到环境文件，以设置一致性组设置。带有 JSON 文件中的默认设置的等同的 parameter_defaults 部分以以下方式显示：

   parameter_defaults:
     CinderApiPolicies: { \
        cinder-consistencygroup_create: { key: 'consistencygroup:create', value: 'group:nobody' }, \
        cinder-consistencygroup_delete: { key: 'consistencygroup:delete', value: 'group:nobody' },  \
        cinder-consistencygroup_update: { key: 'consistencygroup:update', value: 'group:nobody' }, \
        cinder-consistencygroup_get: { key: 'consistencygroup:get', value: 'group:nobody' }, \
        cinder-consistencygroup_get_all: { key: 'consistencygroup:get_all', value: 'group:nobody' }, \
        cinder-consistencygroup_create_cgsnapshot: { key: 'consistencygroup:create_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_delete_cgsnapshot: { key: 'consistencygroup:delete_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_get_cgsnapshot: { key: 'consistencygroup:get_cgsnapshot', value: 'group:nobody' }, \
        cinder-consistencygroup_get_all_cgsnapshots: { key: 'consistencygroup:get_all_cgsnapshots', value: 'group:nobody' }, \
    }

3. 值 'group:nobody' 确定没有组可以使用此功能，以便其有效禁用。要启用它，请将组更改为另一个值。

4. 为提高安全性，请将一致性组 API 和卷类型管理 API 的权限设置为相同。默认情况下，卷类型管理 API 会在同一个 /etc/cinder/policy.json_ file 文件中设置为 "rule:admin_or_owner"。

   "volume_extension:types_manage": "rule:admin_or_owner",

5. 要使所有用户可以使用一致性组功能，请设置 API 策略条目，允许用户创建、使用和管理自己的一致性组。要做到这一点，请使用 rule:admin_or_owner ：

   CinderApiPolicies: { \
        cinder-consistencygroup_create: { key: 'consistencygroup:create', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_delete: { key: 'consistencygroup:delete', value: 'rule:admin_or_owner' },  \
        cinder-consistencygroup_update: { key: 'consistencygroup:update', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get: { key: 'consistencygroup:get', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_all: { key: 'consistencygroup:get_all', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_create_cgsnapshot: { key: 'consistencygroup:create_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_delete_cgsnapshot: { key: 'consistencygroup:delete_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_cgsnapshot: { key: 'consistencygroup:get_cgsnapshot', value: 'rule:admin_or_owner' }, \
        cinder-consistencygroup_get_all_cgsnapshots: { key: 'consistencygroup:get_all_cgsnapshots', value: 'rule:admin_or_owner’ }, \
    }

6. 当您在 /home/stack/templates/ 中创建环境文件后，以 stack 用户身份登录并部署配置：

   $ openstack overcloud deploy --templates \
   -e /home/stack/templates/<ENV_FILE>.yaml

   将 <ENV_FILE.yaml > 替换为您添加的 ExtraConfig 设置。

   重要

   如果您在创建 overcloud 时传递任何额外的环境文件，请使用 -e 选项再次传递它们，以避免对 overcloud 进行不必要的更改。

流程

1. 在仪表板中作为 admin 用户，选择 Project > Compute > Volumes > Volume Consistency Groups。
2. 点 Create Consistency Group。
3. 在向导的 Consistency Group Information 选项卡中，为您的一致性组输入名称和描述。然后，指定其 可用区。
4. 您还可以在一致性组中添加卷类型。当您在一致性组中创建卷时，块存储服务会应用来自这些卷类型的兼容设置。要添加卷类型，请点击所有可用卷类型列表中的 + 按钮。
5. 点 Create Consistency Group。它会出现在 卷组表中。

流程

1. 可选：您可以通过从 Action 列中选择 Edit Consistency Group 来更改一致性组的名称或描述。
2. 要直接从一致性组中添加或删除卷，作为仪表板中的 admin 用户，请选择 Project > Compute > Volumes > Volume Consistency Groups。

3. 查找您要配置的一致性组。在该一致性组的 Actions 列中，选择 Manage Volumes。这将启动 Add/Remove Consistency Group Volumes 向导。

   1. 要将卷添加到一致性组中，请点击 所有可用卷 列表中的 + 按钮。
   2. 要从一致性组中删除卷，请点击所选 卷 列表中的 - 按钮。
4. 单击 Edit Consistency Group。

流程

1. 在托管 openstack-cinder-api 的节点，使用命令行以 admin 用户身份登录，并输入：

   # export OS_VOLUME_API_VERSION=2

   这会将客户端配置为使用 openstack-cinder-api 的版本 2。

2. 列出所有可用一致性组及其对应的 ID：

   # cinder consisgroup-list

3. 使用一致性组创建快照：

   # cinder cgsnapshot-create --name <CGSNAPNAME> --description "<DESCRIPTION>" <CGNAMEID>

   替换：

   • <CGSNAPNAME >，带有快照名称（可选）。
   • <DESCRIPTION >，包含快照的描述（可选）。
   • <CGNAMEID> 带有一致性组的名称或 ID。

4. 显示所有可用一致性组快照的列表：

   # cinder cgsnapshot-list

流程

1. 克隆现有的一致性组：

   # cinder consisgroup-create-from-src --source-cg <CGNAMEID> --name <CGNAME> --description "<DESCRIPTION>"

   替换：

   • <CGNAMEID > 是您要克隆的一致性组的名称或 ID。
   • <CGNAME > 是一致性组的名称（可选）。
   • <DESCRIPTION > 是一致性组的描述（可选）。

2. 从一致性组快照创建一致性组：

   # cinder consisgroup-create-from-src --cgsnapshot <CGSNAPNAME> --name <CGNAME> --description "<DESCRIPTION>

   将 < CGSNAPNAME > 替换为您要用于创建一致性组的快照的名称或 ID。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 stackrc 凭证文件：

   $ source ~/stackrc

3. 使用覆盖环境文件或创建新文件，如 multipath_overrides.yaml。添加和设置以下参数：

   parameter_defaults:
     ExtraConfig:
       cinder::config::cinder_config:
         backend_defaults/use_multipath_for_image_xfer:
           value: true

   注意

   默认设置将生成适用于大多数环境的基本多路径配置。但是，检查您的存储厂商是否有建议，因为有些供应商已经优化了特定于其硬件的配置。有关多路径的详情，请参考 配置设备映射器多路径 指南。

4. 可选：如果您有一个用于 overcloud 部署的多路径配置文件，请使用 MultipathdCustomConfigFile 参数指定此文件的位置：

   1. 您必须将多路径配置文件复制到 /var/lib/mistral 目录中：

           $ sudo cp <config_file_name> /var/lib/mistral

      将 <config_file_name > 替换为您的文件的名称。

   2. 将 MultipathdCustomConfigFile 参数设置为多路径配置文件的这个位置：

           parameter_defaults:
                MultipathdCustomConfigFile: /var/lib/mistral/<config_file_name>

      注意

      其他 TripleO 多路径参数覆盖本地自定义配置文件中任何对应的值。例如，如果 MultipathdEnableUserFriendlyNames 为 False，则 overcloud 节点上的文件会更新为匹配，即使本地自定义文件中启用了该设置。

      有关多路径参数的更多信息，请参阅 多路径 heat 模板参数。

5. 在 openstack overcloud deploy 命令中包含环境文件，以及与您的环境相关的任何其他环境文件：

   $ openstack overcloud deploy \
   --templates \
   …
   -e <existing_overcloud_environment_files> \
   -e /usr/share/openstack-tripleo-heat-templates/environments/multipathd.yaml
   -e multipath_overrides.yaml \
   …

流程

1. 创建虚拟机。
2. 将非加密的卷附加到虚拟机。

3. 获取包含实例的 Compute 节点的名称：

   $ nova show INSTANCE | grep OS-EXT-SRV-ATTR:host

   将 INSTANCE 替换为您要引导的虚拟机的名称。

4. 检索实例的 virsh 名称：

   $ nova show INSTANCE | grep instance_name

   将 INSTANCE 替换为您要引导的虚拟机的名称。

5. 获取 Compute 节点的 IP 地址：

   $ . stackrc
   $ nova list | grep compute_name

   使用 nova show INSTANCE 命令的输出的名称替换 compute_name。

6. SSH 到运行虚拟机的 Compute 节点：

   $ ssh heat-admin@COMPUTE_NODE_IP

   将 COMPUTE_NODE_IP 替换为 Compute 节点的 IP 地址。

7. 登录到运行 virsh 的容器：

   $ podman exec -it nova_libvirt /bin/bash

8. 在 Compute 节点实例上输入以下命令来验证它是否使用 cinder 卷主机位置中的多路径：

   virsh domblklist VIRSH_INSTANCE_NAME | grep /dev/dm

   将 VIRSH_INSTANCE_NAME 替换为 nova show INSTANCE | grep instance_name 命令的输出。

   如果实例显示 /dev/dm- 以外的值，则连接是非多路径，您需要使用 nova shelve 和 nova unshelve 命令刷新连接信息：

   $ nova shelve <instance>
   $ nova unshelve <instance>

   注意

   如果您有多种后端，则必须在所有后端上验证实例和卷，因为每个后端返回的连接信息可能会有所不同。

流程

1. 在控制面板中，选择 Project > Compute > Volumes。
2. 在您要迁移的卷的 Actions 列中，选择 Change Volume Type。
3. 在 Change Volume Type 对话框中，选择目标卷类型，然后从 Type 列表中选择新的后端。
4. 如果您要将卷迁移到另一个后端，请从 Migration Policy 列表中选择 On Demand。更多信息请参阅 第 4.4 节 “在后端间移动卷”。
5. 点 Change Volume Type 启动迁移。

流程

1. 输入以下命令重新输入卷：

   $ cinder retype <volume name or id> <new volume type name>

2. 如果 retype 操作需要将卷从一个后端移动到另一个后端，块存储服务需要一个特定的标记：

   $ cinder retype --migration-policy on-demand <volume name or id> <new volume type name>

流程

1. 运行以下命令来创建 multi-attach 卷类型：

   $ cinder type-create multiattach
   $ cinder type-key multiattach set multiattach="<is> True"

   注意

   此流程在任何支持多附加的后端上创建卷。因此，如果有两个支持 multiattach 的后端，调度程序会根据创建时的可用空间决定使用哪个后端。

2. 运行以下命令以指定后端：

   $ cinder type-key multiattach set volume_backend_name=<backend_name>

流程

1. 运行以下命令来创建 multi-attach 卷：

   $ cinder create <volume_size> --name <volume_name> --volume-type multiattach

2. 运行以下命令，以验证卷是否能够多附加功能。如果卷能够多附件，则 multiattach 字段等于 True。

   $ cinder show <vol_id> | grep multiattach
   
   | multiattach | True |

流程

1. 登录到其中一个 Controller 节点。

2. 运行以下命令：

   [root@overcloud-controller-2 ~]# sudo podman exec -it -u swift swift_object_server /usr/bin/swift-recon -arqlT --md5
   
   ======================================================================--> Starting reconnaissance on 3 hosts (object)
   ======================================================================[2018-12-14 14:55:47] Checking async pendings
   [async_pending] - No hosts returned valid data.
   ======================================================================[2018-12-14 14:55:47] Checking on replication
   [replication_failure] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_success] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_time] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [replication_attempted] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   Oldest completion was 2018-12-14 14:55:39 (7 seconds ago) by 172.16.3.186:6000.
   Most recent completion was 2018-12-14 14:55:42 (4 seconds ago) by 172.16.3.174:6000.
   ======================================================================[2018-12-14 14:55:47] Checking load averages
   [5m_load_avg] low: 1, high: 2, avg: 2.1, total: 6, Failed: 0.0%, no_result: 0, reported: 3
   [15m_load_avg] low: 2, high: 2, avg: 2.6, total: 7, Failed: 0.0%, no_result: 0, reported: 3
   [1m_load_avg] low: 0, high: 0, avg: 0.8, total: 2, Failed: 0.0%, no_result: 0, reported: 3
   ======================================================================[2018-12-14 14:55:47] Checking ring md5sums
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================[2018-12-14 14:55:47] Checking swift.conf md5sum
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================[2018-12-14 14:55:47] Checking quarantine
   [quarantined_objects] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [quarantined_accounts] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   [quarantined_containers] low: 0, high: 0, avg: 0.0, total: 0, Failed: 0.0%, no_result: 0, reported: 3
   ======================================================================[2018-12-14 14:55:47] Checking time-sync
   3/3 hosts matched, 0 error[s] while checking hosts.
   ======================================================================

3. 可选：使用 --all 选项返回附加输出。

   此命令查询环中的所有服务器以获取以下数据：

   • async pendings ：如果集群负载太大，且进程无法快速更新数据库文件，则一些更新会异步进行。这些数字随着时间的推移会减少。
   • 复制指标：检查复制时间戳；完整复制传递经常发生，并显示几个错误。例如，一个旧条目（例如，自 6 个月前的时间戳的条目）表示节点上的复制还没有在最后的 6 个月内完成。
   • 环形 md5sums ：这样可确保所有环文件在所有节点上都一致。
   • Swift.conf md5sums ：这样可确保所有配置文件在所有节点上都一致。
   • Quarantined 文件：所有节点必须无或非常少。
   • Time-sync ：所有节点都必须同步。

流程

1. Edit swift_params.yaml:

   cat > swift_params.yaml << EOF
   parameter_defaults:
       ExtraConfig:
         swift::proxy::copy::object_post_as_copy: False
   EOF

2. 在部署或更新 overcloud 时包含参数文件：

   openstack overcloud deploy [... previous args ...] -e swift_params.yaml

流程

1. 复制 /usr/share/openstack-tripleo-heat-templates 中的 roles_data.yaml。
2. 编辑新文件。
3. 删除不需要的控制器角色，如 Aodh047、Chcter、Ceph、Ceph、Cinder、Glance、Heat、Ironic、Manila、Mistral 过程、Nova114、Octct、Octavia、Swift。
4. 在 roles_data.yaml 中找到 ObjectStorage 角色。
5. 将此角色复制到同一文件中的新角色，并将其命名为 ObjectProxy。

6. 将 SwiftStorage 替换为此角色中的 SwiftProxy。

   以下 roles_data.yaml 文件示例显示了示例角色。

   - name: Controller
     description: |
   	Controller role that has all the controller services loaded and handles
   	Database, Messaging and Network functions.
     CountDefault: 1
     tags:
   	- primary
   	- controller
     networks:
   	- External
   	- InternalApi
   	- Storage
   	- StorageMgmt
   	- Tenant
     HostnameFormatDefault: '%stackname%-controller-%index%'
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Clustercheck
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::Ec2Api
   	- OS::TripleO::Services::Etcd
   	- OS::TripleO::Services::HAproxy
   	- OS::TripleO::Services::Keepalived
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::Keystone
   	- OS::TripleO::Services::Memcached
   	- OS::TripleO::Services::MySQL
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Pacemaker
   	- OS::TripleO::Services::RabbitMQ
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages
   	- OS::TripleO::Services::Vpp
   
   - name: ObjectStorage
     CountDefault: 1
     description: |
   	Swift Object Storage node role
     networks:
   	- InternalApi
   	- Storage
   	- StorageMgmt
     disable_upgrade_deployment: True
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Collectd
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::FluentdClient
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::SensuClient
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::SwiftRingBuilder
   	- OS::TripleO::Services::SwiftStorage
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages
   
   - name: ObjectProxy
     CountDefault: 1
     description: |
   	Swift Object proxy node role
     networks:
   	- InternalApi
   	- Storage
   	- StorageMgmt
     disable_upgrade_deployment: True
     ServicesDefault:
   	- OS::TripleO::Services::AuditD
   	- OS::TripleO::Services::CACerts
   	- OS::TripleO::Services::CertmongerUser
   	- OS::TripleO::Services::Collectd
   	- OS::TripleO::Services::Docker
   	- OS::TripleO::Services::FluentdClient
   	- OS::TripleO::Services::Kernel
   	- OS::TripleO::Services::MySQLClient
   	- OS::TripleO::Services::Ntp
   	- OS::TripleO::Services::Securetty
   	- OS::TripleO::Services::SensuClient
   	- OS::TripleO::Services::Snmp
   	- OS::TripleO::Services::Sshd
   	- OS::TripleO::Services::SwiftRingBuilder
   	- OS::TripleO::Services::SwiftProxy
   	- OS::TripleO::Services::Timezone
   	- OS::TripleO::Services::TripleoFirewall
   	- OS::TripleO::Services::TripleoPackages

7. 使用常规 openstack deploy 命令部署 overcloud，包括新角色。

   openstack overcloud deploy --templates -r roles_data.yaml -e [...]

流程

1. 以 stack 用户身份登录 undercloud，再提供 stackrc 凭证文件：

   $ source ~/stackrc

2. 创建以下目录：

   $ mkdir temp && cd temp/

3. 将 overcloud 环构建器文件下载到新目录中：

   $ openstack object save overcloud-swift-rings swift-rings.tar.gz

4. 提取环：

   $ tar xzvf swift-rings.tar.gz

5. 创建一个目录来备份环的原始版本：

   $ mkdir backup && cp swift-rings.tar.gz backup/

   对象存储环文件位于 etc/swift 文件夹中。

6. 根据您的设备详情收集以下变量的值：

   • <device_name>:

     $ openstack baremetal introspection data save <node_name> | jq ".inventory.disks"

   • <node_ip>:

      openstack server show <node_name>

   • <port > 默认端口为 600x。如果更改了默认值，请使用适用的端口。
   • <builder_file > 第 3 步中的构建器文件名。
   • <weight &gt ; 和 <zone > 变量是用户定义的。

7. 使用 swift-ring-builder 将新节点添加到现有环。根据设备详情替换变量。

   $ swift-ring-builder etc/swift/<builder_file> add <zone>-<node_ip>:<port>/<device_name> <weight>

8. 将修改后的环文件上传到 undercloud 上的对象存储服务：

   $ tar cvzf swift-rings.tar.gz etc/
   $ openstack object create overcloud-swift-rings swift-rings.tar.gz

流程

1. 使用类似以下示例的脚本，将 undercloud 节点中的环文件分发到指定的 Controller 节点，并重启这些节点上的对象存储服务容器：

   cd etc/swift/
   for j in 8 11 23; do
     ssh heat-admin@192.168.24."$j" "rm *.ring.gz"
     for i in account.ring.gz container.ring.gz object.ring.gz; do
       scp $i heat-admin@192.168.24."$j":~/
       ssh heat-admin@192.168.24."$j" "sudo cp -f "$i" /var/lib/config-data/puppet-generated/swift/etc/swift/"
       ssh heat-admin@192.168.24."$j" "sudo chown root:root /var/lib/config-data/puppet-generated/swift/etc/swift/"$i""
       ssh heat-admin@192.168.24."$j" "sudo restorecon /var/lib/config-data/puppet-generated/swift/etc/swift/"$i""
     done
     ssh heat-admin@192.168.24."$j" "rm *.builder"
     for i in account.builder container.builder object.builder; do
       scp $i heat-admin@192.168.24."$j":~/
       ssh heat-admin@192.168.24."$j" "cat "$i" | sudo tee  /var/lib/config-data/puppet-generated/swift/etc/swift/"$i" >/dev/null"
     done
     ssh heat-admin@192.168.24."$j" 'for k in `sudo podman ps --format "{{.Names}}" | grep swift`; do sudo podman restart $k; done'
   done
   cd ../../

2. 要确认数据正在移至新磁盘，请在新存储节点上运行以下命令：

   $  sudo grep -i replication  /var/log/container/swift/swift.log

流程

1. 以 stack 用户身份登录 undercloud，再提供 stackrc 凭证文件：

   $ source ~/stackrc

2. 使用 ObjectStorageCount 参数将 Object Storage 数减少为 1。此参数通常位于 node-info.yaml 中，这是包含节点数的环境文件：

   parameter_defaults:
     ObjectStorageCount: 3

3. 删除您从 node-info.yaml 文件中的 ObjectStorageIPs 参数中删除的节点的 IP 地址：

   ObjectStorageIPs: <ip_address>

4. 创建一个环境文件，如 remove-object-node.yaml。此文件标识并删除您指定的 Object Storage 节点。以下示例内容指定 overcloud-objectstorage-1 的移除：

   parameter_defaults:
     ObjectStorageRemovalPolicies:
       [{'resource_list': ['1']}]

5. 在部署命令中包含 node-info.yaml 和 remove-object-node.yaml 文件：

   $ openstack overcloud deploy \
   --templates \
   …
   -e <existing_overcloud_environment_files> \
   -e node-info.yaml \
   -e remove-object-node.yaml \
   …

   director 从 overcloud 中删除 Object Storage 节点，并更新 overcloud 中的其他节点来使删除生效。

6. 列出活跃节点以验证您删除了正确的节点：

   $ openstack server list

7. 在 undercloud 节点上，删除 remove-object-node.yaml 文件，使其不包含在将来的重新部署中：

   $ rm <file_path>/remove-object-node.yaml

流程

1. 以 stack 用户身份登录 undercloud，再提供 stackrc 凭证文件：

   $ source ~/stackrc

2. 使用 ObjectStorageCount 参数将 Object Storage 数减少为 1。此参数通常位于 node-info.yaml 中，这是包含节点数的环境文件：

   parameter_defaults:
     ObjectStorageCount: 3

3. 删除您从 node-info.yaml 文件中的 ObjectStorageIPs 参数中删除的节点的 IP 地址：

   ObjectStorageIPs: <ip_address>

4. 创建一个环境文件，如 remove-object-node.yaml。此文件标识并删除您指定的 Object Storage 节点。以下示例内容指定 overcloud-objectstorage-1 的移除：

   parameter_defaults:
     ObjectStorageRemovalPolicies:
       [{'resource_list': ['1']}]

5. 在部署命令中包含 node-info.yaml 和 remove-object-node.yaml 文件：

   $ openstack overcloud deploy \
   --templates \
   …
   -e <existing_overcloud_environment_files> \
   -e node-info.yaml \
   -e remove-object-node.yaml \
   …

   director 从 overcloud 中删除 Object Storage 节点，并更新 overcloud 中的其他节点来使删除生效。

6. 列出活跃节点以验证您删除了正确的节点：

   $ openstack server list

7. 在 undercloud 节点上，删除 remove-object-node.yaml 文件，使其不包含在将来的重新部署中：

   $ rm <file_path>/remove-object-node.yaml

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 点 Create Container。

3. 指定 Container Name，并在 Container Access 字段中选择以下之一。

   类型	描述
   private	限制对当前项目中的用户的访问权限。
   公开	允许使用公共 URL 对任何人的 API 访问。但是，在仪表板中，项目用户无法查看其他项目中的公共容器和数据。

4. 点 Create Container。

5. 可选：新容器使用默认存储策略。如果您定义了多个存储策略，例如，默认策略和另一个策略启用纠删代码，您可以将容器配置为使用非默认存储策略：

   # swift post -H "X-Storage-Policy:<policy>" <container_name>

   将 & lt;policy > 替换为您要使用容器的策略的名称或别名，并将 &lt ;container_name > 替换为容器的名称。

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 单击您要添加伪文件夹的容器名称。
3. 单击 Create Pseudo-folder。
4. 在 Pseudo-folder Name 字段中指定名称，然后单击 Create。

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 在 Containers 部分中浏览容器，并确保删除所有对象。如需更多信息，请参阅 删除对象。
3. 在容器箭头菜单中选择 Delete Container。
4. 点 Delete Container 确认容器被删除。

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 单击您要放置上传对象的容器的名称。如果容器中已存在伪文件夹，您可以点击其名称。
3. 浏览您的文件，然后单击 Upload Object。

4. 在 Object Name 字段中指定名称：

   • 您可以使用 / 字符在名称中指定伪文件夹，例如 Images/myImage.jpg。如果指定的文件夹尚不存在，则会在上传对象时创建它。
   • 对位置不是唯一的名称（即对象已存在）会覆盖对象的内容。
5. 单击 Upload Object。

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 单击对象容器或文件夹的名称（以显示对象）。
3. 单击 Upload Object。
4. 浏览要复制的文件，然后在箭头菜单中选择 Copy。

5. 指定以下内容：

   字段	描述
   目标容器	新对象的目标容器。
   路径	目标容器中的伪文件夹；如果文件夹尚不存在，则创建它。
   目标对象名称	新对象的名称。如果您使用对位置没有唯一的名称（即对象已存在），它会覆盖对象之前的内容。

6. 单击 Copy Object。

流程

1. 在控制面板中，选择 Project > Object Store > Containers。
2. 浏览对象，然后在其箭头菜单中选择 Delete Object。
3. 单击 Delete Object 以确认对象已被删除。

流程

1. 创建存储自定义 YAML 文件。您可以使用此文件提供适合您的环境的任何值或覆盖：

   $ vi /home/stack/templates/storage_customizations.yaml

2. 配置存储自定义 YAML 文件以包含任何覆盖，包括启用多个后端：

   parameter_defaults:
     ManilaEnabledShareProtocols:
       - NFS
     ManilaNetappLogin: '<login_name>'
     ManilaNetappPassword: '<password>'
     ManilaNetappServerHostname: '<netapp-hostname>'
     ManilaNetappVserver: ‘<netapp-vserver>’
     ManilaNetappDriverHandlesShareServers: 'false'

3. 使用 openstack overcloud deploy 命令指定后端模板。示例配置通过 NFS 后端启用带有 NetApp 后端和 CephFS 的共享文件系统服务。

   注意

   在发出 openstack overcloud deploy 命令之前，执行 source ~/stackrc。

   [stack@undercloud ~]$ source ~/stackrc
   $ openstack overcloud deploy \
     --timeout 100 \
     --stack overcloud \
     --templates /usr/share/openstack-tripleo-heat-templates \
     -n /usr/share/openstack-tripleo-heat-templates/network_data_ganesha.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-mds.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml \
     -r /home/stack/templates/roles/roles_data.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/manila-cephfsganesha-config.yaml \
   -e /usr/share/openstack-tripleo-heat-templates/environments/manila-netapp-config.yaml \
   -e /home/stack/templates/storage_customizations.yaml \
   ...

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 overcloudrc 凭证文件：

   $ source ~/overcloudrc

3. 确认共享文件系统服务后端列表：

   $ manila service-list
   
   +----+--------+--------+------+---------+-------+----------------------------+
   | Id | Binary | Host | Zone | Status | State | Updated_at |
   +----+--------+--------+------+---------+-------+----------------------------+
   | 2 | manila-scheduler | hostgroup | nova | enabled | up | 2021-03-24T16:49:09.000000 |
   | 5 | manila-share | hostgroup@cephfs | nova | enabled | up | 2021-03-24T16:49:12.000000 |
   | 8 | manila-share | hostgroup@tripleo_netapp | nova | enabled | up | 2021-03-24T16:49:06.000000 |

   每个成功部署的后端的状态显示 enabled，状态会显示 up。

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 overcloudrc 凭证文件：

   $ source ~/overcloudrc

3. 创建存储自定义 YAML 文件。此文件可用于提供适合您的环境的任何值或覆盖：

   $ vi /home/stack/templates/storage_customizations.yaml

4. 使用您想要的值配置 ManilaEnabledShareProtocols 参数：

   parameter_defaults:
     ManilaEnabledShareProtocols:
       - NFS
       - CEPHFS

5. 使用 -e 选项，在 openstack overcloud deploy 命令中包含新内容的环境文件。确保包含与部署相关的所有其他环境文件。

   $ openstack overcloud deploy \
   ...
   -e /home/stack/templates/storage_customizations.yaml

   注意

   部署不会验证设置。您分配的 NAS 协议必须被共享文件系统服务部署中的后端支持。

流程

1. 发现可用的共享类型：

   $ manila type-list

   命令输出列出了共享类型的名称和 ID。

流程

1. 列出共享：

   (user) [stack@undercloud-0 ~]$ manila list
   
   +--------------------------------------+----------+-----+-----------+           | ID                                   | Name     | ... | Status    ...
   +--------------------------------------+----------+-----+-----------+
   | 8c3bedd8-bc82-4100-a65d-53ec51b5fe81 | share-01 | ... | available ...
   +--------------------------------------+----------+-----+-----------+

2. 查看共享的导出位置：

   (user) [stack@undercloud-0 ~]$ manila share-export-location-list share-01
   
    +------------------------------------------------------------------
    | Path
    |  172.17.5.13:/volumes/_nogroup/e840b4ae-6a04-49ee-9d6e-67d4999fbc01
    +------------------------------------------------------------------

3. 查看共享的参数：

   $ manila share-export-location-show <id>

   注意

   您可以使用导出位置在 第 6.9.2 节 “挂载共享” 中挂载共享。

流程

1. 为 StorageNFS 端口创建一个安全组，允许数据包到出口端口，但不允许来自未建立的连接的入站数据包：

   (user) [stack@undercloud-0 ~]$ openstack security group create no-ingress -f yaml
   created_at: '2018-09-19T08:19:58Z'
   description: no-ingress
   id: 66f67c24-cd8b-45e2-b60f-9eaedc79e3c5
   name: no-ingress
   project_id: 1e021e8b322a40968484e1af538b8b63
   revision_number: 2
   rules: 'created_at=''2018-09-19T08:19:58Z'', direction=''egress'', ethertype=''IPv4'',
    id=''6c7f643f-3715-4df5-9fef-0850fb6eaaf2'', updated_at=''2018-09-19T08:19:58Z''
   
    created_at=''2018-09-19T08:19:58Z'', direction=''egress'', ethertype=''IPv6'',                                                          id=''a8ca1ac2-fbe5-40e9-ab67-3e55b7a8632a'', updated_at=''2018-09-19T08:19:58Z'''
   updated_at: '2018-09-19T08:19:58Z'

2. 在 StorageNFS 网络中创建一个端口，其安全性由 no-ingress 安全组强制使用。

   (user) [stack@undercloud-0 ~]$ openstack port create nfs-port0 --network StorageNFS --security-group no-ingress -f yaml
   
   admin_state_up: UP
   allowed_address_pairs: ''
   binding_host_id: null
   binding_profile: null
   binding_vif_details: null
   binding_vif_type: null
   binding_vnic_type: normal
   created_at: '2018-09-19T08:03:02Z'
   data_plane_status: null
   description: ''
   device_id: ''
   device_owner: ''
   dns_assignment: null
   dns_name: null
   extra_dhcp_opts: ''
   fixed_ips: ip_address='172.17.5.160', subnet_id='7bc188ae-aab3-425b-a894-863e4b664192'
   id: 7a91cbbc-8821-4d20-a24c-99c07178e5f7
   ip_address: null
   mac_address: fa:16:3e:be:41:6f
   name: nfs-port0
   network_id: cb2cbc5f-ea92-4c2d-beb8-d9b10e10efae
   option_name: null
   option_value: null
   port_security_enabled: true
   project_id: 1e021e8b322a40968484e1af538b8b63
   qos_policy_id: null
   revision_number: 6
   security_group_ids: 66f67c24-cd8b-45e2-b60f-9eaedc79e3c5
   status: DOWN
   subnet_id: null
   tags: ''
   trunk_details: null
   updated_at: '2018-09-19T08:03:03Z'

   注意

   StorageNFSSubnet 分配 IP 地址 172.17.5.160 到 nfs-port0。

3. 将 nfs-port0 添加到 Compute 实例。

   (user) [stack@undercloud-0 ~]$ openstack server add port instance0 nfs-port0
   (user) [stack@undercloud-0 ~]$ openstack server list -f yaml
   - Flavor: m1.micro
     ID: 0b878c11-e791-434b-ab63-274ecfc957e8
     Image: manila-test
     Name: demo-instance0
     Networks: demo-network=172.20.0.4, 10.0.0.53; StorageNFS=172.17.5.160
     Status: ACTIVE

   除了它的私有和浮动地址外，计算实例还会分配一个在 StorageNFS 网络上 IP 地址为 172.17.5.160 的端口，您可以在问题中为该地址授予访问权限时挂载 NFS 共享。

   注意

   您可能需要调整 Compute 实例上的网络配置，并重新启动 Compute 实例的服务，以激活具有此地址的接口。

流程

1. 登录该实例。

2. 配置 IPv6 接口地址：

   $ sudo ip address add fd00:fd00:fd00:7000::c/64 dev eth1

3. 激活接口：

   $ sudo ip link set dev eth1 up

4. 在共享的导出位置 ping IPv6 地址来测试接口连接：

   $ ping -6  fd00:fd00:fd00:7000::21

5. 或者，通过 Telnet 验证您可以访问 NFS 服务器：

   $ sudo dnf install -y telnet
   $ telnet fd00:fd00:fd00:7000::21 2049

流程

1. 检索您要挂载共享的客户端计算实例的 IP 地址。确保您选择了与可以访问共享的网络对应的 IP 地址。在本例中，它是 StorageNFS 网络的 IP 地址：

   (user) [stack@undercloud-0 ~]$ openstack server list -f yaml
   - Flavor: m1.micro
     ID: 0b878c11-e791-434b-ab63-274ecfc957e8
     Image: manila-test
     Name: demo-instance0
     Networks: demo-network=172.20.0.4, 10.0.0.53;
     StorageNFS=172.17.5.160
     Status: ACTIVE
   
   (user) [stack@undercloud-0 ~]$ manila access-allow share-01 ip 172.17.5.160

   注意

   对共享的访问权限具有自己的 ID (accessid)。

   +-----------------+---------------------------------------+
   | Property        | Value                                 |
   +-----------------+---------------------------------------+
   | access_key      | None
   | share_id        | db3bedd8-bc82-4100-a65d-53ec51b5cba3
   | created_at      | 2018-09-17T21:57:42.000000
   | updated_at      | None
   | access_type     | ip
   | access_to       | 172.17.5.160
   | access_level    | rw
   | state           | queued_to_apply
   | id              | 875c6251-c17e-4c45-8516-fe0928004fff
   +-----------------+---------------------------------------+

2. 验证访问配置是否成功：

   (user) [stack@undercloud-0 ~]$ manila access-list share-01
   
   +--------------+-------------+--------------+--------------+--------+ ...
   | id           | access_type | access_to    | access_level | state  | ...
   +--------------+-------------+--------------+--------------+--------+
   | 875c6251-... | ip          | 172.17.5.160 | rw       	   | active | ...
   +--------------+------------+--------------+--------------+---------+ ...

流程

1. 检索共享的导出位置：

   (user) [stack@undercloud-0 ~]$ manila share-export-location-list share-01

   当存在多个导出位置时，请选择 首选 metadata 字段的值等于 True 的值。如果没有首选位置，您可以使用任何导出位置。

流程

1. 登录到实例并运行以下命令：

   (user) [stack@undercloud-0 ~]$ openstack server ssh demo-instance0 --login root
   # hostname
   demo-instance0

2. 使用导出位置将共享挂载到 IPv4 网络中：

   # mount -t nfs -v  172.17.5.13:/volumes/_nogroup/e840b4ae-6a04-49ee-9d6e-67d4999fbc01 /mnt

流程

1. 您可以使用以下命令来查看配额。如果包含 --user 选项，您可以在指定项目中查看特定用户的配额。如果省略 --user 选项，您可以查看适用于指定项目的所有用户的配额。

   同样，如果您包含可选的 --share-type，您可以查看特定共享类型的配额，因为它与项目相关。--user 和 --share-type 选项是互斥的。

   $ manila quota-show

   • 项目示例：

     $ manila quota-show --project af2838436f3f4cf6896399dd97c4c050
     +-----------------------+----------------------------------+
     | Property              | Value                            |
     +-----------------------+----------------------------------+
     | gigabytes             | 1000                             |
     | id                    | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes     | 1000                             |
     | share_group_snapshots | 50                               |
     | share_groups          | 49                               |
     | share_networks        | 10                               |
     | share_replicas        | 100                              |
     | shares                | 50                               |
     | snapshot_gigabytes    | 1000                             |
     | snapshots             | 50                               |
     +-----------------------+----------------------------------+

   • 项目用户的示例：

     $ manila quota-show --project af2838436f3f4cf6896399dd97c4c050 --user 81ebb491dd0e4c2aae0775dd564e76d1
     +-----------------------+----------------------------------+
     | Property              | Value                            |
     +-----------------------+----------------------------------+
     | gigabytes             | 500                              |
     | id                    | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes     | 1000                             |
     | share_group_snapshots | 50                               |
     | share_groups          | 49                               |
     | share_networks        | 10                               |
     | share_replicas        | 100                              |
     | shares                | 25                               |
     | snapshot_gigabytes    | 1000                             |
     | snapshots             | 50                               |
     +-----------------------+----------------------------------+

   • 特定共享类型的项目示例：

     $ manila quota-show --project af2838436f3f4cf6896399dd97c4c050 --share-type dhss_false
     +---------------------+----------------------------------+
     | Property            | Value                            |
     +---------------------+----------------------------------+
     | gigabytes           | 1000                             |
     | id                  | af2838436f3f4cf6896399dd97c4c050 |
     | replica_gigabytes   | 1000                             |
     | share_replicas      | 100                              |
     | shares              | 15                               |
     | snapshot_gigabytes  | 1000                             |
     | snapshots           | 50                               |
     +---------------------+----------------------------------+

2. 使用 manila quota-update 命令更新配额。您可以为所有项目用户、特定项目用户或项目中的共享类型更新配额：

   • 为项目中的所有用户更新配额：

     $ manila quota-update <id> [--shares <share_quota> --gigabytes <share_gigabytes_quota> …]

     将 & lt;id& gt; 替换为项目 ID。

   • 为项目中的特定用户更新配额：

     $  manila quota-update <id> --user <user_id> [--shares <new_share_quota> --gigabytes <new_share_gigabytes_quota> …]

     • 将 & lt;id& gt; 替换为项目 ID。这个值必须是项目 ID，而不是项目名称。
     • 将 <user_id& gt; 替换为用户 ID。该值必须是用户 ID，而不是用户名。

   • 为使用特定共享类型的所有用户更新配额：

     $ manila quota-update <id> --share-type <share_type> [--shares <new_share_quota>30 --gigabytes <new-share_gigabytes_quota> …]

     • 将 & lt;id& gt; 替换为项目 ID。这个值必须是项目 ID，而不是项目名称。
     • 将 < share_type > 替换为您要将配额应用到的共享类型的名称或 ID。

验证

1. quota-delete 命令不会生成任何输出。使用 quota-show 命令来验证配额是否已成功重置。

2. 列出所有项目的默认配额。默认配额应用到没有覆盖的项目。

   $ manila quota-class-show default

流程

1. 查看 manila quota-class-update 命令的 usage 语句：

   $ manila help quota-class-update
   usage: manila quota-class-update [--shares <shares>] [--snapshots <snapshots>]
                                    [--gigabytes <gigabytes>]
                                    [--snapshot-gigabytes <snapshot_gigabytes>]
                                    [--share-networks <share_networks>]
                                    [--share-replicas <share_replicas>]
                                    [--replica-gigabytes <replica_gigabytes>]
                                    <class_name>

   注意

   参数 & lt;class_name > 是一个位置参数。它标识设定配额的配额类。将此参数设置为 default。不支持其他配额类。

   您可以为以下任何可选参数更新值：

   • --shares <shares > 为 共享 配额添加新值。
   • --snapshots <snapshots > 为 快照 配额添加新值。
   • --gigabytes <gigabytes> 添加一个新的 gigabytes 配额。
   • --snapshot-gigabytes <snapshot_gigabytes& gt ; 或 --snapshot_gigabytes <snapshot_gigabytes > 为 snapshot_gigabytes 配额添加新值。
   • --share-networks <share_networks& gt ; 或 --share_networks <share_networks > 为 share_networks 配额添加新值。
   • --share-replicas <share_replicas&gt; , --share_replicas <share_replicas > , 或 --replicas <share_replicas > 为 share_replicas 配额添加新值。
   • --replica-gigabytes <replica_gigabytes& gt ; 或 --replica_gigabytes <replica_gigabytes > 为 replica_gigabytes 配额添加新值。

2. 使用 usage 语句中的信息来更新默认配额。以下示例为 shares 和 gigabytes 更新默认配额：

   $ manila quota-class-update default --shares 30 --gigabytes 512
   $ manila quota-class-show default
   +-----------------------+---------+
   | Property              | Value   |
   +-----------------------+---------+
   | gigabytes             | 512     |
   | id                    | default |
   | replica_gigabytes     | 1000    |
   | share_group_snapshots | 50      |
   | share_groups          | 50      |
   | share_networks        | 10      |
   | share_replicas        | 100     |
   | shares                | 30      |
   | snapshot_gigabytes    | 1000    |
   | snapshots             | 50      |
   +-----------------------+---------+

流程

1. 要创建共享，您可以使用共享类型来指定您希望共享具有的一些功能。云管理员可以创建共享类型。查看可用的共享类型：

   clouduser1@client:~$ manila type-list
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | ID                                   | Name        | visibility | is_default | required_extra_specs                 | optional_extra_specs                       | Description |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 | dhss_false  | public     | YES        | driver_handles_share_servers : False | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   | 277c1089-127f-426e-9b12-711845991ea1 | dhss_true   | public     | -          | driver_handles_share_servers : True  | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+

   在本例中，提供了两种共享类型。

2. 要使用指定 driver_handles_share_servers=True 功能的共享类型，您必须创建一个共享网络来导出共享。从私有项目网络创建共享网络。

   clouduser1@client:~$ openstack subnet list
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   | ID                                   | Name                | Network                              | Subnet              |
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   | 78c6ac57-bba7-4922-ab81-16cde31c2d06 | private-subnet      | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 | 10.0.0.0/26         |
   | a344682c-718d-4825-a87a-3622b4d3a771 | ipv6-private-subnet | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 | fd36:18fc:a8e9::/64 |
   +--------------------------------------+---------------------+--------------------------------------+---------------------+
   
   clouduser1@client:~$ manila share-network-create --name mynet --neutron-net-id 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 --neutron-subnet-id 78c6ac57-bba7-4922-ab81-16cde31c2d06
   +-------------------+--------------------------------------+
   | Property          | Value                                |
   +-------------------+--------------------------------------+
   | network_type      | None                                 |
   | name              | mynet                                |
   | segmentation_id   | None                                 |
   | created_at        | 2018-10-09T21:32:22.485399           |
   | neutron_subnet_id | 78c6ac57-bba7-4922-ab81-16cde31c2d06 |
   | updated_at        | None                                 |
   | mtu               | None                                 |
   | gateway           | None                                 |
   | neutron_net_id    | 74d5cfb3-5dd0-43f7-b1b2-5b544cb16212 |
   | ip_version        | None                                 |
   | cidr              | None                                 |
   | project_id        | cadd7139bc3148b8973df097c0911016     |
   | id                | 0b0fc320-d4b5-44a1-a1ae-800c56de550c |
   | description       | None                                 |
   +-------------------+--------------------------------------+
   
   clouduser1@client:~$ manila share-network-list
   +--------------------------------------+-------+
   | id                                   | name  |
   +--------------------------------------+-------+
   | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 | mynet |
   +--------------------------------------+-------+

3. 创建共享：

   clouduser1@client:~$ manila create nfs 1 --name software_share --share-network mynet --share-type dhss_true
   +---------------------------------------+--------------------------------------+
   | Property                              | Value                                |
   +---------------------------------------+--------------------------------------+
   | status                                | creating                             |
   | share_type_name                       | dhss_true                            |
   | description                           | None                                 |
   | availability_zone                     | None                                 |
   | share_network_id                      | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 |
   | share_server_id                       | None                                 |
   | share_group_id                        | None                                 |
   | host                                  |                                      |
   | revert_to_snapshot_support            | False                                |
   | access_rules_status                   | active                               |
   | snapshot_id                           | None                                 |
   | create_share_from_snapshot_support    | False                                |
   | is_public                             | False                                |
   | task_state                            | None                                 |
   | snapshot_support                      | False                                |
   | id                                    | 243f3a51-0624-4bdd-950e-7ed190b53b67 |
   | size                                  | 1                                    |
   | source_share_group_snapshot_member_id | None                                 |
   | user_id                               | 61aef4895b0b41619e67ae83fba6defe     |
   | name                                  | software_share                       |
   | share_type                            | 277c1089-127f-426e-9b12-711845991ea1 |
   | has_replicas                          | False                                |
   | replication_type                      | None                                 |
   | created_at                            | 2018-10-09T21:12:21.000000           |
   | share_proto                           | NFS                                  |
   | mount_snapshot_support                | False                                |
   | project_id                            | cadd7139bc3148b8973df097c0911016     |
   | metadata                              | {}                                   |
   +---------------------------------------+--------------------------------------+

4. 查看共享的状态：

   clouduser1@client:~$ manila list
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | ID                                   | Name           | Size | Share Proto | Status | Is Public | Share Type Name | Host | Availability Zone |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error  | False     | dhss_true       |      | None              |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+

   在本例中，在共享创建过程中出现错误。

5. 要查看用户支持消息，请运行 message-list 命令。使用 --resource-id 过滤您要查找的特定共享。

   clouduser1@client:~$ manila message-list
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+

   在 User Message 列中，请注意共享文件系统服务因为功能不匹配而无法创建共享。

6. 要查看更多信息，请运行 message-show 命令，后跟来自 message-list 命令的消息 ID：

   clouduser1@client:~$ manila message-show 7d411c3c-46d9-433f-9e21-c04ca30b209c
   +---------------+----------------------------------------------------------------------------------------------------------+
   | Property      | Value                                                                                                    |
   +---------------+----------------------------------------------------------------------------------------------------------+
   | request_id    | req-0a875292-6c52-458b-87d4-1f945556feac                                                                 |
   | detail_id     | 008                                                                                                      |
   | expires_at    | 2018-11-08T21:12:21.000000                                                                               |
   | resource_id   | 243f3a51-0624-4bdd-950e-7ed190b53b67                                                                     |
   | user_message  | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. |
   | created_at    | 2018-10-09T21:12:21.000000                                                                               |
   | message_level | ERROR                                                                                                    |
   | id            | 7d411c3c-46d9-433f-9e21-c04ca30b209c                                                                     |
   | resource_type | SHARE                                                                                                    |
   | action_id     | 001                                                                                                      |
   +---------------+----------------------------------------------------------------------------------------------------------+

7. 作为云用户，您可以通过共享类型检查功能，以便您可以查看可用的共享类型。两种共享类型之间的区别是 driver_handles_share_servers 的值：

   clouduser1@client:~$ manila type-list
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | ID                                   | Name        | visibility | is_default | required_extra_specs                 | optional_extra_specs                       | Description |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+
   | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 | dhss_false  | public     | YES        | driver_handles_share_servers : False | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   | 277c1089-127f-426e-9b12-711845991ea1 | dhss_true   | public     | -          | driver_handles_share_servers : True  | create_share_from_snapshot_support : True  | None        |
   |                                      |             |            |            |                                      | mount_snapshot_support : False             |             |
   |                                      |             |            |            |                                      | revert_to_snapshot_support : False         |             |
   |                                      |             |            |            |                                      | snapshot_support : True                    |             |
   +--------------------------------------+-------------+------------+------------+--------------------------------------+--------------------------------------------+-------------+

8. 使用其他可用共享类型创建共享：

   clouduser1@client:~$ manila create nfs 1 --name software_share --share-network mynet --share-type dhss_false
   +---------------------------------------+--------------------------------------+
   | Property                              | Value                                |
   +---------------------------------------+--------------------------------------+
   | status                                | creating                             |
   | share_type_name                       | dhss_false                           |
   | description                           | None                                 |
   | availability_zone                     | None                                 |
   | share_network_id                      | 6c7ef9ef-3591-48b6-b18a-71a03059edd5 |
   | share_group_id                        | None                                 |
   | revert_to_snapshot_support            | False                                |
   | access_rules_status                   | active                               |
   | snapshot_id                           | None                                 |
   | create_share_from_snapshot_support    | True                                 |
   | is_public                             | False                                |
   | task_state                            | None                                 |
   | snapshot_support                      | True                                 |
   | id                                    | 2d03d480-7cba-4122-ac9d-edc59c8df698 |
   | size                                  | 1                                    |
   | source_share_group_snapshot_member_id | None                                 |
   | user_id                               | 5c7bdb6eb0504d54a619acf8375c08ce     |
   | name                                  | software_share                       |
   | share_type                            | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 |
   | has_replicas                          | False                                |
   | replication_type                      | None                                 |
   | created_at                            | 2018-10-09T21:24:40.000000           |
   | share_proto                           | NFS                                  |
   | mount_snapshot_support                | False                                |
   | project_id                            | cadd7139bc3148b8973df097c0911016     |
   | metadata                              | {}                                   |
   +---------------------------------------+--------------------------------------+

   在本例中，第二个共享创建尝试会失败。

9. 查看用户支持信息：

   clouduser1@client:~$ manila list
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | ID                                   | Name           | Size | Share Proto | Status | Is Public | Share Type Name | Host | Availability Zone |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   | 2d03d480-7cba-4122-ac9d-edc59c8df698 | software_share | 1    | NFS         | error  | False     | dhss_false      |      | nova              |
   | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error  | False     | dhss_true       |      | None              |
   +--------------------------------------+----------------+------+-------------+--------+-----------+-----------------+------+-------------------+
   
   clouduser1@client:~$ manila message-list
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
   | ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 | SHARE         | 2d03d480-7cba-4122-ac9d-edc59c8df698 | 002       | create: Driver does not expect share-network to be provided with current configuration.                  | 003       | 2018-10-09T21:24:40.000000 |
   | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
   +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+

   该服务不会期望共享网络用于您使用的共享类型。

10. 如果没有咨询管理员，您可以发现管理员没有提供支持直接将共享导出到私有 neutron 网络的存储后端。创建没有 share-network 参数的共享：

    clouduser1@client:~$ manila create nfs 1 --name software_share --share-type dhss_false
    +---------------------------------------+--------------------------------------+
    | Property                              | Value                                |
    +---------------------------------------+--------------------------------------+
    | status                                | creating                             |
    | share_type_name                       | dhss_false                           |
    | description                           | None                                 |
    | availability_zone                     | None                                 |
    | share_network_id                      | None                                 |
    | share_group_id                        | None                                 |
    | revert_to_snapshot_support            | False                                |
    | access_rules_status                   | active                               |
    | snapshot_id                           | None                                 |
    | create_share_from_snapshot_support    | True                                 |
    | is_public                             | False                                |
    | task_state                            | None                                 |
    | snapshot_support                      | True                                 |
    | id                                    | 4d3d7fcf-5fb7-4209-90eb-9e064659f46d |
    | size                                  | 1                                    |
    | source_share_group_snapshot_member_id | None                                 |
    | user_id                               | 5c7bdb6eb0504d54a619acf8375c08ce     |
    | name                                  | software_share                       |
    | share_type                            | 1cf5d45a-61b3-44d1-8ec7-89a21f51a4d4 |
    | has_replicas                          | False                                |
    | replication_type                      | None                                 |
    | created_at                            | 2018-10-09T21:25:40.000000           |
    | share_proto                           | NFS                                  |
    | mount_snapshot_support                | False                                |
    | project_id                            | cadd7139bc3148b8973df097c0911016     |
    | metadata                              | {}                                   |
    +---------------------------------------+--------------------------------------+

11. 确保已成功创建共享：

    clouduser1@client:~$ manila list
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+
    | ID                                   | Name           | Size | Share Proto | Status    | Is Public | Share Type Name | Host | Availability Zone |
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+
    | 4d3d7fcf-5fb7-4209-90eb-9e064659f46d | software_share | 1    | NFS         | available | False     | dhss_false      |      | nova              |
    | 2d03d480-7cba-4122-ac9d-edc59c8df698 | software_share | 1    | NFS         | error     | False     | dhss_false      |      | nova              |
    | 243f3a51-0624-4bdd-950e-7ed190b53b67 | software_share | 1    | NFS         | error     | False     | dhss_true       |      | None              |
    +--------------------------------------+----------------+------+-------------+-----------+-----------+-----------------+------+-------------------+

12. 删除共享和支持信息：

    clouduser1@client:~$ manila message-list
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    | ID                                   | Resource Type | Resource ID                          | Action ID | User Message                                                                                             | Detail ID | Created At                 |
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    | ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 | SHARE         | 2d03d480-7cba-4122-ac9d-edc59c8df698 | 002       | create: Driver does not expect share-network to be provided with current configuration.                  | 003       | 2018-10-09T21:24:40.000000 |
    | 7d411c3c-46d9-433f-9e21-c04ca30b209c | SHARE         | 243f3a51-0624-4bdd-950e-7ed190b53b67 | 001       | allocate host: No storage could be allocated for this share request, Capabilities filter didn't succeed. | 008       | 2018-10-09T21:12:21.000000 |
    +--------------------------------------+---------------+--------------------------------------+-----------+----------------------------------------------------------------------------------------------------------+-----------+----------------------------+
    
    clouduser1@client:~$ manila delete 2d03d480-7cba-4122-ac9d-edc59c8df698 243f3a51-0624-4bdd-950e-7ed190b53b67
    clouduser1@client:~$ manila message-delete ed7e02a2-0cdb-4ff9-b64f-e4d2ec1ef069 7d411c3c-46d9-433f-9e21-c04ca30b209c
    
    clouduser1@client:~$ manila message-list
    +----+---------------+-------------+-----------+--------------+-----------+------------+
    | ID | Resource Type | Resource ID | Action ID | User Message | Detail ID | Created At |
    +----+---------------+-------------+-----------+--------------+-----------+------------+
    +----+---------------+-------------+-----------+--------------+-----------+------------+

流程

1. 验证共享的访问控制列表，以确保与您的客户端对应的规则正确，并且已被成功应用。

   $ manila access-list share-01

   在成功规则中，state 属性等于 active。

2. 如果 share 类型参数被配置为 driver_handles_share_servers=False，请从导出位置复制主机名或 IP 地址，并 ping它以确认连接到 NAS 服务器的连接：

   $ ping -c 1 172.17.5.13
   PING 172.17.5.13 (172.17.5.13) 56(84) bytes of data.
   64 bytes from 172.17.5.13: icmp_seq=1 ttl=64 time=0.048 ms--- 172.17.5.13 ping statistics ---
   1 packets transmitted, 1 received, 0% packet loss, time 0ms
   rtt min/avg/max/mdev = 7.851/7.851/7.851/0.000 ms
   If using the NFS protocol, you may verify that the NFS server is ready to respond to NFS rpcs on the proper port:
   $ rpcinfo -T tcp -a 172.17.5.13.8.1 100003 4
   program 100003 version 4 ready and waiting

   注意

   IP 地址以通用地址格式(uaddr)编写，它添加了两个额外的 octets (8.1)来代表 NFS 服务端口 2049。