26d90b2d40
The README file needs to have links to the project documentation and bug tracker in a parsable format in order for some of the release tools scripts to work (particularly the one that prints the release note email). Change-Id: I37e0acc5ed8e1af565359290fa622456901c735e
81 lines
2.6 KiB
ReStructuredText
81 lines
2.6 KiB
ReStructuredText
Python bindings for the Ironic API
|
|
==================================
|
|
|
|
This is a client for the OpenStack `Ironic
|
|
<https://wiki.openstack.org/wiki/Ironic>`_ API. It provides a Python API (the
|
|
``ironicclient`` module) and a command-line interface (``ironic``).
|
|
|
|
Development takes place via the usual OpenStack processes as outlined in the
|
|
`developer guide <http://docs.openstack.org/infra/manual/developers.html>`_. The master
|
|
repository is on `git.openstack.org
|
|
<https://git.openstack.org/cgit/openstack/python-ironicclient>`_.
|
|
|
|
``python-ironicclient`` is licensed under the Apache License like the rest
|
|
of OpenStack.
|
|
|
|
|
|
.. contents:: Contents:
|
|
:local:
|
|
|
|
Python API
|
|
----------
|
|
|
|
Quick-start Example::
|
|
>>> from ironicclient import client
|
|
>>>
|
|
>>> kwargs = {'os_auth_token': '3bcc3d3a03f44e3d8377f9247b0ad155'
|
|
>>> 'ironic_url': 'http://ironic.example.org:6385/'}
|
|
>>> ironic = client.get_client(1, **kwargs)
|
|
|
|
|
|
Command-line API
|
|
----------------
|
|
|
|
This package will install the ``ironic`` command line interface that you
|
|
can use to interact with the ``ironic`` API.
|
|
|
|
In order to use the ``ironic`` CLI you'll need to provide your OpenStack
|
|
tenant, username, password and authentication endpoint. You can do this with
|
|
the ``--os-tenant-name``, ``--os-username``, ``--os-password`` and
|
|
``--os-auth-url`` parameters, though it may be easier to set them
|
|
as environment variables::
|
|
|
|
export OS_TENANT_NAME=project
|
|
export OS_USERNAME=user
|
|
export OS_PASSWORD=pass
|
|
export OS_AUTH_URL=http://auth.example.com:5000/v2.0
|
|
|
|
To use a specific Ironic API endpoint::
|
|
|
|
export IRONIC_URL=http://ironic.example.com:6385
|
|
|
|
An example of how to create a basic node with the pxe_ipmitool driver::
|
|
|
|
ironic node-create -d pxe_ipmitool
|
|
|
|
An example of creating a port on a node::
|
|
|
|
ironic port-create -a AA:BB:CC:DD:EE:FF -n nodeUUID
|
|
|
|
An example of updating driver properties for a node::
|
|
|
|
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>
|
|
|
|
|
|
For more information about the ``ironic`` command and the subcommands
|
|
available, run::
|
|
|
|
ironic help
|
|
|
|
* License: Apache License, Version 2.0
|
|
* Documentation: http://docs.openstack.org/developer/python-ironicclient
|
|
* Source: http://git.openstack.org/cgit/openstack/python-ironicclient
|
|
* Bugs: http://bugs.launchpad.net/python-ironicclient
|
|
|
|
Change logs with information about specific versions (or tags) are
|
|
available at:
|
|
|
|
`<http://git.openstack.org/cgit/openstack/python-ironicclient/>`_.
|