python-ironicclient/doc/source/cli/standalone.rst

baremetal Standalone Command-Line Interface (CLI)

baremetal

Synopsis

baremetal [options] <command> [command-options]

baremetal help <command>

Description

The standalone baremetal tool allows interacting with the Bare Metal service without installing the OpenStack Client tool as in osc_plugin_cli.

The standalone tool is mostly identical to its OSC counterpart, with two exceptions:

1. No need to prefix commands with openstack.
2. No authentication is assumed by default.

Check the OSC CLI reference </cli/osc/v1/index> for a list of available commands.

Inspector support

The standalone baremetal tool optionally supports the low-level bare metal introspection API provided by ironic-inspector. If ironic-inspector-client is installed, its commands are automatically available (also without the openstack prefix).

Standalone usage

To use the CLI with a standalone bare metal service, you need to provide an endpoint to connect to. It can be done in three ways:

1. Provide an explicit --os-endpoint argument, e.g.:

   $ baremetal --os-endpoint https://ironic.host:6385 node list

2. Set the corresponding environment variable, e.g.:

   $ export OS_ENDPOINT=https://ironic.host:6385
   $ baremetal node list

3. Populate a clouds.yaml file, setting baremetal_endpoint_override, e.g.:

   $ cat ~/.config/openstack/clouds.yaml
   clouds:
     ironic:
       auth_type: none
       baremetal_endpoint_override: http://127.0.0.1:6385
   $ export OS_CLOUD=ironic
   $ baremetal node list

Inspector support works similarly, but the clouds.yaml option is called baremetal_introspection_endpoint_override. The two endpoints can be configured simultaneously, e.g.:

$ cat ~/.config/openstack/clouds.yaml
clouds:
  ironic:
    auth_type: none
    baremetal_endpoint_override: http://127.0.0.1:6385
    baremetal_introspection_endpoint_override: http://127.0.0.1:5050
$ export OS_CLOUD=ironic
$ baremetal node list
$ baremetal introspection list

Usage with OpenStack

The standalone CLI can also be used with the Bare Metal service installed as part of OpenStack. See osc-auth for information on the required input.