mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-10-18 19:33:42 +00:00
Rodrigo Caballero
a4b61aecf9
Changed the file structure to allow for easier and better maintenance of the docs. Files were renamed as needed and following a consistent convention. Added a index.rst to every folder allowing for partial builds of the docs. Included content previously left out of the docs build. The commit also performs minimal housekeeping. Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
62 lines
2.1 KiB
ReStructuredText
62 lines
2.1 KiB
ReStructuredText
.. _openstack_env_inventory_file:
|
|
|
|
The "hosts" file
|
|
################
|
|
|
|
The :file:`hosts` file is an inventory file where you specify, via
|
|
``ini`` format, the roles your machine plays.
|
|
|
|
The :file:`hosts` file can be structured with different groups, where each
|
|
group plays a specific role in your environment and network mapping.
|
|
|
|
Consider the following example::
|
|
|
|
[openstack_identity]
|
|
192.168.50.13
|
|
|
|
Here, the role ``[openstack_identity]`` syntax defines the group, and
|
|
``192.168.50.13`` specifies the machine(s) that possess that role. You
|
|
may define multiple machines in the same group; this is a standard
|
|
configuration for role ``[openstack_compute]`` nodes::
|
|
|
|
[openstack_compute]
|
|
192.168.50.16
|
|
192.168.50.17
|
|
|
|
|
|
Inventory file groups
|
|
---------------------
|
|
|
|
Below you will find the description of each group in the `hosts` file.
|
|
|
|
.. csv-table:: "Inventory File Groups"
|
|
:header: "Group", "Components", "Comments"
|
|
:widths: 40, 40, 300
|
|
|
|
"[dbservers]", "MariaDB", ""
|
|
"[messaging_servers]", "RabbitMQ", ""
|
|
"[openstack_identity]", "Keystone, Horizon", ""
|
|
"[openstack_image]", "Glance", ""
|
|
"[openstack_compute_controller]", "Nova", ""
|
|
"[openstack_compute]", "Nova", "Accepts multiple entries to have multiple compute nodes. You can add more entries and re-run the installer to add them to your environment."
|
|
"[openstack_networking]", "Neutron", ""
|
|
"[openstack_orchestration]", "Heat", ""
|
|
"[openstack_object_storage_controller]", "Swift", "The Swift storage controller. It runs the swift proxy server and the memcache server"
|
|
"[openstack_object_storage]", "Swift", "The Swift Storage nodes. Accepts multiple entries to have multiple storage nodes"
|
|
|
|
|
|
Important notes
|
|
---------------
|
|
|
|
* To omit any role, do not add an entry under its group section.
|
|
|
|
* To create an ``All In One`` scenario, specify the same machine name or IPv4
|
|
Address under all of the groups.
|
|
|
|
For further reference, check out the `Ansible`_ documentation.
|
|
|
|
|
|
**Back to Configuration Section** :ref:`configure_openstack_environment`
|
|
|
|
.. _Ansible: http://docs.ansible.com/ansible/intro_inventory.html
|