python-ironicclient 2.8.0

团队和存储库标记

概述

这是openstackBare Metal API的客户端。它提供：

• python api:theironicclient模块，和
• 两个命令行接口：openstack baremetal和ironic （已弃用，请使用openstack baremetal）。

开发通过通常的openstack进程进行，如 developer guide。 主存储库位于opendev.org。

python-ironicclient是根据apache许可证2.0版授权的， 就像OpenStack的其他部分一样。

项目资源

• 文档：https://docs.openstack.org/python-ironicclient/latest/
• 来源：https://opendev.org/openstack/python-ironicclient
• 错误：https://storyboard.openstack.org/#!/project/959
• 发行说明：https://docs.openstack.org/releasenotes/python-ironicclient/

python api

快速入门示例：

>>> from ironicclient import client
>>>
>>> kwargs = {'os_auth_token': '3bcc3d3a03f44e3d8377f9247b0ad155',
>>>           'ironic_url': 'http://ironic.example.org:6385/'}
>>> ironic = client.get_client(1, **kwargs)

openstack baremetalcli

当 金属插件（包含在这个包中）与OpenStackClient一起使用。

有两种方法可以安装openstackclient（python openstackclient） 套餐：

• 与此python ironicclient包一起：

  # pip install python-ironicclient[cli]
  

• 直接：

  # pip install python-openstackclient
  

使用ipmi驱动程序创建基本节点的示例：

$ openstack baremetal node create --driver ipmi

在节点上创建端口的示例：

$ openstack baremetal port create --node <UUID> AA:BB:CC:DD:EE:FF

更新节点的驱动程序属性的示例：

$ openstack baremetal node set --driver-info ipmi_address=<IPaddress> <UUID or name>

有关openstack baremetal命令和 可用的子命令，运行：

$ openstack help baremetal

ironiccli（不推荐）

这已弃用，并将在S*版本中删除。请使用 openstack baremetalcli代替。

这个包将安装ironic命令行接口 可用于与ironicapi交互。

为了使用ironiccli，您需要提供openstack 租户、用户名、密码和身份验证终结点。你可以这样做 --os-tenant-name，--os-username，--os-password和 --os-auth-url参数，尽管设置它们可能更容易 作为环境变量：

$ export OS_PROJECT_NAME=project
$ export OS_USERNAME=user
$ export OS_PASSWORD=pass
$ export OS_AUTH_URL=http://auth.example.com:5000/v2.0

要使用特定的讽刺api端点：

$ export IRONIC_URL=http://ironic.example.com:6385

使用ipmi驱动程序创建基本节点的示例：

$ ironic node-create -d ipmi

在节点上创建端口的示例：

$ ironic port-create -a AA:BB:CC:DD:EE:FF -n nodeUUID

更新节点的驱动程序属性的示例：

$ ironic node-update nodeUUID add driver_info/ipmi_address=<IPaddress>
$ ironic node-update nodeUUID add driver_info/ipmi_username=<username>
$ ironic node-update nodeUUID add driver_info/ipmi_password=<password>

有关ironic命令和子命令的详细信息 可用，运行：

$ ironic help