ironic-oneview-cli 1.2.1

概述

Ironic-OneView CLI 是一个命令行界面工具，用于简化 Ironic 的 OneView 驱动程序的使用。它允许用户轻松管理：

• 兼容 OneView 服务器硬件对象的 Ironic 节点；

• 使用 OneView 驱动程序的可用 Ironic 节点匹配的 Nova 味道；

• Ironic 端口映射服务器硬件端口。

> 注意 > > 该工具与 OpenStack Identity API v2.0 和 v3 一起工作。

> 注意 > > 该工具与 OpenStack Ironic API 微版本 '1.31' 一起工作。

有关 HPE OneView 实体的更多信息，请参阅[此处](https://www.hpe.com/us/en/integrated-systems/software.html)。

安装

要从 PyPI 安装 Ironic-OneView CLI，请使用以下命令

$ pip install ironic-oneview-cli

> 注意 > > Ocata/Newton 用户，我们建议使用版本 0.6.0

配置

Ironic-Oneview CLI 使用由 OpenStack RC 文件（从 OpenStack Horizon 下载）加载到环境变量中的凭证，以及 Ironic OneView CLI RC 文件，可以使用以下 genrc 子命令生成示例文件：

$ ironic-oneview genrc > ironic-oneviewrc.sh

使用任何文本编辑器将 OneView 凭据填充到 ironic-oneviewrc.sh 后，可以通过运行以下命令来加载它：

$ source ironic-oneviewrc.sh

可以将凭证作为命令行参数传递。运行以下命令将显示通知应使用哪些参数的帮助信息：

$ ironic-oneview help

有关如何获取和加载 OpenStack RC 文件的更多信息，请参阅[此处](http://docs.openstack.org/user-guide/common/cli_set_environment_variables_using_openstack_rc.html)。

用法

设置必要的环境变量和命令行参数后，Ironic OneView CLI 即可使用。Ironic-OneView CLI 当前版本提供以下交互式子命令

<table> <col width=”23%” /> <col width=”76%” /> <tbody> <tr class=”odd”> <td align=”left”><blockquote> <p>node-create</p> </blockquote></td> <td align=”left”>根据可用的 HPE OneView 服务器硬件创建 Ironic 节点。</td> </tr> <tr class=”even”> <td align=”left”><blockquote> <p>flavor-create</p> </blockquote></td> <td align=”left”>根据可用的 Ironic 节点创建 Nova 味道。</td> </tr> <tr class=”odd”> <td align=”left”><blockquote> <p>port-create</p> </blockquote></td> <td align=”left”>根据可用的 Ironic 节点创建 Ironic 端口。</td> </tr> <tr class=”even”> <td align=”left”><blockquote> <p>server-profile-template-list</p> </blockquote></td> <td align=”left”>列出 HPE OneView 服务器配置模板。</td> </tr> <tr class=”odd”> <td align=”left”><blockquote> <p>server-hardware-list</p> </blockquote></td> <td align=”left”>列出 HPE OneView 服务器硬件。</td> </tr> <tr class=”even”> <td align=”left”><blockquote> <p>node-delete</p> </blockquote></td> <td align=”left”>删除多个 Ironic 节点。</td> </tr> <tr class=”odd”> <td align=”left”><blockquote> <p>genrc</p> </blockquote></td> <td align=”left”>生成示例 Ironic-OneView CLI RC 文件。</td> </tr> <tr class=”even”> <td align=”left”><blockquote> <p>help</p> </blockquote></td> <td align=”left”>显示有关此程序或其子命令的帮助信息。</td> </tr> </tbody> </table>

任何 ironic-oneview-cli 子命令都可以使用 –debug 参数以调试模式运行，如下所示

$ ironic-oneview –debug node-create

功能

### 节点创建

要基于可用的 HPE OneView 服务器硬件 对象创建 Ironic 节点，请使用以下命令

$ ironic-oneview node-create

该工具检索 OneView 中之前创建的所有服务器配置模板。它构建一个包含名称、机架组名称和服务器硬件类型名称（如表中所示）的列表，并为管理员分配一个 ID，管理员可以使用该 ID 选择用于节点创建的 服务器配置模板

Id	Name	Enclosure Group Name	Server Hardware Type Name
1 2	template-dcs-virt-enc3 template-dcs-virt-enc4	virt-enclosure-group virt-enclosure-group	BL460c Gen8 3 BL660c Gen9 1

一旦用户选择了有效的 服务器配置模板，工具将列出与之匹配的可用 服务器硬件，如下表所示

Id	Name	CPUs	内存 MB	本地 GB	Enclosure Group Name	Server Hardware Type Name
1 2	VIRT-enl, bay 5 VIRT-enl, bay 8	8 8	32768 32768	120 120	virt-enclosure-group virt-enclosure-group	BL460c Gen8 3 BL460c Gen8 3

请注意，可以一次创建多个 Ironic 节点。这可以通过选择多个用空格分隔的 服务器硬件 ID 来实现。创建的 Ironic 节点将处于 enroll 配置状态。

此命令还创建一个用于节点的 Ironic 端口，端口创建方式与 port-create 命令（见下文）相同，参数 –mac 也是可选的。

> 注意 > > 如果 os_inspection_enabled = True，则创建的节点将不会在节点属性中设置硬件属性（cpus、memory_mb、local_gb、cpu_arch）。这将在 Ironic 硬件检查期间发现。

或者，可以使用参数 –server-profile-template 和 –server-hardware-uuid 分别指定 服务器配置模板 和 服务器硬件，如下所示

$ ironic-oneview node-create [–server-profile-template | -t <spt>] [–server-hardware-uuid | -s <server_hardware>]

可以使用以下命令批量设置具有相同 服务器配置模板 的节点集合

$ ironic-oneview node-create [–number | -n <number>]

> 注意 > > 您可以同时使用这两个参数。

为了启用 OneView ML2 网络驱动程序，可以使用以下命令创建具有此信息设置为 driver_info 字段的节点

$ ironic-oneview node-create –use-oneview-ml2-driver

有关 Networking OneView ML2 驱动程序 的更多信息，请参阅[此处](https://github.com/HewlettPackard/ironic-driver-oneview/tree/master/networking-oneview).

随着驱动程序组合改革的实施，默认行为是使用硬件类型创建节点。利用此功能，可以将特定硬件类型兼容的接口动态设置到节点，例如：OpenStack 电源接口，OpenStack 管理接口，OpenStack 检查接口，OpenStack 部署接口。使用以下命令创建具有此硬件类型和接口的节点

$ ironic-oneview node-create –os-driver <硬件类型> –os-power-interface <电源接口>

–os-management-interface <管理接口> –os-inspect-interface <检查接口> –os-deploy-interface <部署接口>

如果您想使用经典驱动程序创建节点，请使用以下命令

$ ironic-oneview node-create –classic

有关 驱动程序组合改革 的更多信息，请参阅[此处](https://specs.openstack.org/openstack/ironic-specs/specs/approved/driver-composition-reform.html).

要列出 Ironic 中的所有节点，请使用以下命令

$ openstack baremetal node list

有关创建的 Ironic 节点的更多信息，请使用以下命令

$ openstack baremetal node show <节点>

### 创建口味

为了启动裸金属实例，用户需要指定与可用 Ironic 节点兼容的口味，它直接映射到可用的 服务器硬件。以下交互式命令可以用来创建 Nova 口味

$ ironic-oneview flavor-create

工具将提示一个可能的新口味列表，根据已注册的 Ironic 节点的配置

Id	CPUs	磁盘 GB	内存 MB	服务器配置模板	服务器硬件类型	Enclosure Group Name
1	8	120	8192	second-virt-server-profile-template	BL460c Gen9 1	虚拟机架组

在选择有效的配置后，用户可以可选地指定新口味的名称。如果留空，将使用默认名称。默认情况下，将从服务器硬件类型、机架组和服务器配置模板自动添加附加信息到口味元数据。使用 Horizon 删除机架组信息，例如，以便口味与所有可用机架中的服务器硬件匹配。

或者，您可以通过以下命令设置 Ironic 节点 和可选口味 名称

$ ironic-oneview flavor-create [–node <节点>] [–name <名称>]

要列出 Nova 中的所有口味，请使用以下命令

$ openstack flavor list

有关创建的 Nova 口味的更多信息，请使用以下命令

$ openstack flavor show <口味>

### 创建端口

为现有的 Ironic 节点创建端口。以下交互式命令可以用来创建 Ironic 端口

$ ironic-oneview port-create [–mac | -m <mac>] <节点>

在用户未指定端口的情况下，结果将是 ironic-node 所用 服务器硬件 的第一个 -a 可用端口对应的 Ironic 端口。

要列出 Ironic 中的所有端口，请使用以下命令

$ openstack baremetal port list

有关创建的 Ironic 端口的更多信息，请使用以下命令

$ openstack baremetal port show <端口>

### 服务器配置模板列表

该工具提供了一条命令来列出 服务器配置模板。为此，请使用以下命令

$ ironic-oneview server-profile-template-list

### 服务器硬件列表

该工具提供了一条命令来列出与特定 服务器配置模板 兼容的 服务器硬件。为此，请使用以下命令

$ ironic-oneview server-hardware-list

### 删除节点

该工具还提供删除指定数量 Ironic 节点的选项。为此，请使用以下命令

$ ironic-oneview node-delete –number <数量>

要删除所有讽刺节点，请使用以下命令：

$ ironic-oneview node-delete –all

### 贡献

创建分支，修改，提交，并发起pull-request。我们热衷于改进这个项目，并乐意接受帮助使其变得更好。然而，请注意以下几点：我们保留拒绝我们认为不适合本项目范围的更改的权利。在开始工作之前，请先通过issue讨论功能添加的想法。

### 功能请求

如果您有当前实现未满足的需求，请告知我们（通过新的issue）。此类反馈对我们提供有用的产品至关重要。不要假设我们已经想到了所有可能，因为我们向您保证并非如此。

### 测试

我们已经打包了您需要执行的所有操作以验证代码是否通过测试。tox脚本将单元测试执行与Python 2.7，3.5和pep8验证一起封装。运行以下命令：

$ tox