56 lines
1.5 KiB
ReStructuredText
56 lines
1.5 KiB
ReStructuredText
Deployment and Scheduling tool for Bare Metal
|
|
=============================================
|
|
|
|
Overview
|
|
--------
|
|
|
|
This is a simple tool to provision bare metal machines using `OpenStack Bare
|
|
Metal Service (ironic) <https://docs.openstack.org/ironic/latest/>`_,
|
|
`OpenStack Image Service (glance) <https://docs.openstack.org/glance/latest/>`_
|
|
and `OpenStack Networking Service (neutron)
|
|
<https://docs.openstack.org/neutron/latest/>`_.
|
|
|
|
Installation
|
|
------------
|
|
|
|
::
|
|
|
|
pip install --user metalsmith
|
|
|
|
Usage
|
|
-----
|
|
|
|
Start with sourcing your OpenStack credentials, for example::
|
|
|
|
. ~/stackrc
|
|
|
|
Generic usage is as follows::
|
|
|
|
metalsmith deploy --image <GLANCE IMAGE> --network <NEUTRON NET> \
|
|
--ssh-public-key <PATH TO SSH PUBLIC KEY> <RESOURCE CLASS>
|
|
|
|
This is an example suitable for TripleO (replace ``compute`` with the profile
|
|
you want to deploy)::
|
|
|
|
metalsmith deploy --image overcloud-full --network ctlplane \
|
|
--capability profile=compute --ssh-public-key ~/.ssh/id_rsa.pub baremetal
|
|
|
|
To remove the deployed instance::
|
|
|
|
metalsmith undeploy <NODE UUID>
|
|
|
|
For all possible options see the built-in help::
|
|
|
|
metalsmith --help
|
|
|
|
Contributing
|
|
------------
|
|
|
|
* Pull requests: `Gerrit
|
|
<https://review.openstack.org/#/q/project:openstack/metalsmith>`_
|
|
(see `developer's guide
|
|
<https://docs.openstack.org/infra/manual/developers.html>`_)
|
|
* Bugs and RFEs: `StoryBoard
|
|
<https://storyboard.openstack.org/#!/project/1000>`_
|
|
(please do NOT report bugs to Github)
|