From 7131037cf7665680adee143a0f886e2c7ddd0327 Mon Sep 17 00:00:00 2001 From: Mathieu Mitchell Date: Tue, 6 Sep 2016 16:30:28 -0400 Subject: [PATCH] [install-guide] Import "Bare Metal service overview" Import service overview in the new install-guide and provide a link in the old guide that points to it. Additionally, Swift was added to the list of interactions and Cinder was removed since it is not yet available. Change-Id: Ica6a9aae2c35f293228ffb75b2cf82478eb568a5 Partial-bug: #1612278 --- doc/source/deploy/install-guide.rst | 66 ++-------------- install-guide/source/conf.py | 2 +- install-guide/source/get_started.rst | 77 ++++++++++++++++++- .../common-prerequisites.rst} | 0 install-guide/source/install-obs.rst | 2 +- install-guide/source/install-rdo.rst | 2 +- install-guide/source/install-ubuntu.rst | 2 +- 7 files changed, 83 insertions(+), 68 deletions(-) rename install-guide/source/{common_prerequisites.rst => include/common-prerequisites.rst} (100%) diff --git a/doc/source/deploy/install-guide.rst b/doc/source/deploy/install-guide.rst index 6b1d10d95a..b9642f032b 100644 --- a/doc/source/deploy/install-guide.rst +++ b/doc/source/deploy/install-guide.rst @@ -13,68 +13,10 @@ to look at earlier versions of this document for guidance. Service overview ================ -The Bare Metal service is a collection of components that provides support to -manage and provision physical machines. - -Also known as the ``ironic`` project, the Bare Metal service may, depending -upon configuration, interact with several other OpenStack services. This -includes: - -- the OpenStack Telemetry module (ceilometer) for consuming the IPMI metrics -- the OpenStack Identity service (keystone) for request authentication and to - locate other OpenStack services -- the OpenStack Image service (glance) from which to retrieve images and image meta-data -- the OpenStack Networking service (neutron) for DHCP and network configuration -- the OpenStack Compute service (nova) works with the Bare Metal service and acts as - a user-facing API for instance management, while the Bare Metal service - provides the admin/operator API for hardware management. The OpenStack - Compute service also provides scheduling facilities (matching flavors <-> - images <-> hardware), tenant quotas, IP assignment, and other services which - the Bare Metal service does not, in and of itself, provide. - -- the OpenStack Block Storage (cinder) provides volumes, but this aspect is not - yet available. - -The Bare Metal service includes the following components: - -- ironic-api: A RESTful API that processes application requests by sending - them to the ironic-conductor over RPC. -- ironic-conductor: Adds/edits/deletes nodes; powers on/off nodes with - ipmi or ssh; provisions/deploys/decommissions bare metal nodes. -- ironic-python-agent: A python service which is run in a temporary ramdisk to - provide ironic-conductor service(s) with remote access and in-band hardware - control. -- python-ironicclient: A command-line interface (CLI) for interacting with - the Bare Metal service. - -Additionally, the Bare Metal service has certain external dependencies, which are -very similar to other OpenStack services: - -- A database to store hardware information and state. You can set the database - back-end type and location. A simple approach is to use the same database - back end as the Compute service. Another approach is to use a separate - database back-end to further isolate bare metal resources (and associated - metadata) from users. -- A queue. A central hub for passing messages, such as RabbitMQ. - It should use the same implementation as that of the Compute service. - -Optionally, one may wish to utilize the following associated projects for -additional functionality: - -- ironic-inspector_; An associated service which performs in-band hardware - introspection by PXE booting unregistered hardware into a "discovery ramdisk". -- diskimage-builder_; May be used to customize machine images, create and - discovery deploy ramdisks, if necessary. -- bifrost_; a set of Ansible playbooks that automates the task of deploying a - base image onto a set of known hardware using ironic. - -.. _ironic-inspector: http://docs.openstack.org/developer/ironic-inspector/ -.. _diskimage-builder: http://docs.openstack.org/developer/diskimage-builder/ -.. _bifrost: http://docs.openstack.org/developer/bifrost/ - - -.. todo: include coreos-image-builder reference here, once the split is done +The `service overview`_ section has been moved to the Bare Metal service +Install Guide. +.. _`service overview`: http://docs.openstack.org/project-install-guide/baremetal/draft/get_started.html Install and configure prerequisites =================================== @@ -1399,6 +1341,7 @@ The following sections will describe both methods. with diskimage-builder_ **version >= 0.1.42** or ironic-python-agent_ in the kilo-era. + Enabling local boot with Compute service ---------------------------------------- @@ -2604,3 +2547,4 @@ following command. .. _ironic-python-agent: http://docs.openstack.org/developer/ironic-python-agent/ +.. _diskimage-builder: http://docs.openstack.org/developer/diskimage-builder/ diff --git a/install-guide/source/conf.py b/install-guide/source/conf.py index 14084d4ce2..4f859ca316 100644 --- a/install-guide/source/conf.py +++ b/install-guide/source/conf.py @@ -93,7 +93,7 @@ html_context = {"gitsha": gitsha, "bug_tag": bug_tag, # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. -exclude_patterns = ["common_prerequisites.rst"] +exclude_patterns = ['include'] # The reST default role (used for this markup: `text`) to use for all # documents. diff --git a/install-guide/source/get_started.rst b/install-guide/source/get_started.rst index 1d97d75b32..9fcb1d0e7a 100644 --- a/install-guide/source/get_started.rst +++ b/install-guide/source/get_started.rst @@ -2,8 +2,79 @@ Bare Metal service overview =========================== -The Bare Metal service is a collection of components that provides support to manage and provision physical machines. +The Bare Metal service is a collection of components that provides support to +manage and provision physical machines. -Please read the `Service overview`_ section of the legacy installation guide. +Also known as the ``ironic`` project, the Bare Metal service may, depending +upon configuration, interact with several other OpenStack services. This +includes: + +- the OpenStack Telemetry module (``ceilometer``) for consuming the IPMI + metrics +- the OpenStack Identity service (``keystone``) for request authentication and + to locate other OpenStack services +- the OpenStack Image service (``glance``) from which to retrieve images and + image meta-data +- the OpenStack Networking service (``neutron``) for DHCP and network + configuration +- the OpenStack Compute service (``nova``) works with the Bare Metal service + and acts as a user-facing API for instance management, while the Bare Metal + service provides the admin/operator API for hardware management. The + OpenStack Compute service also provides scheduling facilities (matching + flavors <-> images <-> hardware), tenant quotas, IP assignment, and other + services which the Bare Metal service does not, in and of itself, provide. +- the OpenStack Object Storage (``swift``) provides temporary storage + for the configdrive, user images, deployment logs and inspection data. + +The Bare Metal service includes the following components: + +ironic-api + A RESTful API that processes application requests by sending them to the + ironic-conductor over `remote procedure call (RPC)`_. + +ironic-conductor + Adds/edits/deletes nodes; powers on/off nodes with ipmi or ssh; + provisions/deploys/decommissions bare metal nodes. + +ironic-python-agent + A python service which is run in a temporary ramdisk to provide + ironic-conductor and ironic-inspector services with remote access, in-band + hardware control, and hardware introspection. + +.. _`remote procedure call (RPC)`: https://en.wikipedia.org/wiki/Remote_procedure_call + +Additionally, the Bare Metal service has certain external dependencies, which +are very similar to other OpenStack services: + +- A database to store hardware information and state. You can set the database + back-end type and location. A simple approach is to use the same database + back end as the Compute service. Another approach is to use a separate + database back-end to further isolate bare metal resources (and associated + metadata) from users. +- An oslo.messaging compatible queue, such as RabbitMQ. It may use the same + implementation as that of the Compute service, but that is not a requirement. + +Optionally, one may wish to utilize the following associated projects for +additional functionality: + +python-ironicclient_ + A command-line interface (CLI) and python bindings for interacting with the + Bare Metal service. + +ironic-inspector_ + An associated service which performs in-band hardware introspection by + PXE booting unregistered hardware into the ironic-python-agent ramdisk. + +diskimage-builder_ + A related project to help facilitate the creation of ramdisks and machine + images, such as those running the ironic-python-agent. + +bifrost_ + A set of Ansible playbooks that automates the task of deploying a base image + onto a set of known hardware using ironic in a standalone mode. + +.. _python-ironicclient: http://docs.openstack.org/developer/python-ironicclient/ +.. _ironic-inspector: http://docs.openstack.org/developer/ironic-inspector/ +.. _diskimage-builder: http://docs.openstack.org/developer/diskimage-builder/ +.. _bifrost: http://docs.openstack.org/developer/bifrost/ -.. _Service overview: http://docs.openstack.org/developer/ironic/deploy/install-guide.html#service-overview diff --git a/install-guide/source/common_prerequisites.rst b/install-guide/source/include/common-prerequisites.rst similarity index 100% rename from install-guide/source/common_prerequisites.rst rename to install-guide/source/include/common-prerequisites.rst diff --git a/install-guide/source/install-obs.rst b/install-guide/source/install-obs.rst index 0a48de2cec..96b1e30c2d 100644 --- a/install-guide/source/install-obs.rst +++ b/install-guide/source/install-obs.rst @@ -7,7 +7,7 @@ Install and configure for openSUSE and SUSE Linux Enterprise This section describes how to install and configure the Bare Metal service for openSUSE Leap 42.1 and SUSE Linux Enterprise Server 12 SP1. -.. include:: common_prerequisites.rst +.. include:: include/common-prerequisites.rst Install and configure components -------------------------------- diff --git a/install-guide/source/install-rdo.rst b/install-guide/source/install-rdo.rst index 4e333f9f8d..a24d4d45eb 100644 --- a/install-guide/source/install-rdo.rst +++ b/install-guide/source/install-rdo.rst @@ -7,7 +7,7 @@ Install and configure for Red Hat Enterprise Linux and CentOS This section describes how to install and configure the Bare Metal service for Red Hat Enterprise Linux 7 and CentOS 7. -.. include:: common_prerequisites.rst +.. include:: include/common-prerequisites.rst Install and configure components -------------------------------- diff --git a/install-guide/source/install-ubuntu.rst b/install-guide/source/install-ubuntu.rst index dbc715b6ae..459898a07d 100644 --- a/install-guide/source/install-ubuntu.rst +++ b/install-guide/source/install-ubuntu.rst @@ -6,7 +6,7 @@ Install and configure for Ubuntu This section describes how to install and configure the Bare Metal service for Ubuntu 14.04 (LTS). -.. include:: common_prerequisites.rst +.. include:: include/common-prerequisites.rst Install and configure components --------------------------------