Update to the Pike document structure
In this change the documents folder changed in the following way: - Folder structure follows the Pike structure defined in [1] - Structure of Install guide is added as it is moved into the doc folder. [1]: http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html Change-Id: Ia58725958d64fba81a5c4661b2686cd643eaa426 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Signed-off-by: csatari <gergely.csatari@nokia.com>
This commit is contained in:
parent
622da75739
commit
c960f26098
|
@ -1,5 +1,6 @@
|
|||
{
|
||||
"module_name": "replace with the name of the python module",
|
||||
"service": "replace with the service it implements",
|
||||
"repo_group": "openstack",
|
||||
"repo_name": "replace with the name for the git repo",
|
||||
"launchpad_project": "replace with the name of the project on launchpad",
|
||||
|
|
|
@ -0,0 +1,5 @@
|
|||
====================
|
||||
Administrators guide
|
||||
====================
|
||||
|
||||
Administrators guide of {{ cookiecutter.repo_name }}.
|
|
@ -0,0 +1,5 @@
|
|||
================================
|
||||
Command line interface reference
|
||||
================================
|
||||
|
||||
CLI reference of {{ cookiecutter.repo_name }}.
|
|
@ -0,0 +1,5 @@
|
|||
=============
|
||||
Configuration
|
||||
=============
|
||||
|
||||
Configuration of {{ cookiecutter.repo_name }}.
|
|
@ -1,10 +1,19 @@
|
|||
{%- macro set_header_markup(header_text_length) -%}
|
||||
{%- set module_name_length = cookiecutter.module_name|length -%}
|
||||
{%- for _ in range(0, module_name_length + header_text_length) -%}={%- endfor -%}
|
||||
{%- endmacro -%}
|
||||
{%- macro set_header(header_text) -%}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{{header_text}}{{cookiecutter.module_name}}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{%- endmacro -%}
|
||||
|
||||
.. {{ cookiecutter.repo_name }} documentation master file, created by
|
||||
sphinx-quickstart on Tue Jul 9 22:26:36 2013.
|
||||
You can adapt this file completely to your liking, but it should at least
|
||||
contain the root `toctree` directive.
|
||||
|
||||
Welcome to {{ cookiecutter.repo_name }}'s documentation!
|
||||
========================================================
|
||||
{{ set_header("Welcome to the documentation of ") }}
|
||||
|
||||
Contents:
|
||||
|
||||
|
@ -15,6 +24,11 @@ Contents:
|
|||
install/index
|
||||
library/index
|
||||
contributor/index
|
||||
configuration/index
|
||||
cli/index
|
||||
user/index
|
||||
admin/index
|
||||
reference/index
|
||||
|
||||
Indices and tables
|
||||
==================
|
||||
|
@ -22,4 +36,3 @@ Indices and tables
|
|||
* :ref:`genindex`
|
||||
* :ref:`modindex`
|
||||
* :ref:`search`
|
||||
|
||||
|
|
|
@ -0,0 +1,10 @@
|
|||
2. Edit the ``/etc/{{cookiecutter.module_name}}/{{cookiecutter.module_name}}.conf`` file and complete the following
|
||||
actions:
|
||||
|
||||
* In the ``[database]`` section, configure database access:
|
||||
|
||||
.. code-block:: ini
|
||||
|
||||
[database]
|
||||
...
|
||||
connection = mysql+pymysql://{{cookiecutter.module_name}}:{{cookiecutter.module_name|upper}}_DBPASS@controller/{{cookiecutter.module_name}}
|
|
@ -0,0 +1,75 @@
|
|||
Prerequisites
|
||||
-------------
|
||||
|
||||
Before you install and configure the {{cookiecutter.service}} service,
|
||||
you must create a database, service credentials, and API endpoints.
|
||||
|
||||
#. To create the database, complete these steps:
|
||||
|
||||
* Use the database access client to connect to the database
|
||||
server as the ``root`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ mysql -u root -p
|
||||
|
||||
* Create the ``{{cookiecutter.module_name}}`` database:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
CREATE DATABASE {{cookiecutter.module_name}};
|
||||
|
||||
* Grant proper access to the ``{{cookiecutter.module_name}}`` database:
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
GRANT ALL PRIVILEGES ON {{cookiecutter.module_name}}.* TO '{{cookiecutter.module_name}}'@'localhost' \
|
||||
IDENTIFIED BY '{{cookiecutter.module_name|upper}}_DBPASS';
|
||||
GRANT ALL PRIVILEGES ON {{cookiecutter.module_name}}.* TO '{{cookiecutter.module_name}}'@'%' \
|
||||
IDENTIFIED BY '{{cookiecutter.module_name|upper}}_DBPASS';
|
||||
|
||||
Replace ``{{cookiecutter.module_name|upper}}_DBPASS`` with a suitable password.
|
||||
|
||||
* Exit the database access client.
|
||||
|
||||
.. code-block:: none
|
||||
|
||||
exit;
|
||||
|
||||
#. Source the ``admin`` credentials to gain access to
|
||||
admin-only CLI commands:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ . admin-openrc
|
||||
|
||||
#. To create the service credentials, complete these steps:
|
||||
|
||||
* Create the ``{{cookiecutter.module_name}}`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack user create --domain default --password-prompt {{cookiecutter.module_name}}
|
||||
|
||||
* Add the ``admin`` role to the ``{{cookiecutter.module_name}}`` user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack role add --project service --user {{cookiecutter.module_name}} admin
|
||||
|
||||
* Create the {{cookiecutter.module_name}} service entities:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack service create --name {{cookiecutter.module_name}} --description "{{cookiecutter.service}}" {{cookiecutter.service|lower}}
|
||||
|
||||
#. Create the {{cookiecutter.service}} service API endpoints:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack endpoint create --region RegionOne \
|
||||
{{cookiecutter.service|lower}} public http://controller:XXXX/vY/%\(tenant_id\)s
|
||||
$ openstack endpoint create --region RegionOne \
|
||||
{{cookiecutter.service|lower}} internal http://controller:XXXX/vY/%\(tenant_id\)s
|
||||
$ openstack endpoint create --region RegionOne \
|
||||
{{cookiecutter.service|lower}} admin http://controller:XXXX/vY/%\(tenant_id\)s
|
|
@ -0,0 +1,16 @@
|
|||
{%- macro set_header_markup(header_text_length) -%}
|
||||
{%- set servicelength = cookiecutter.service|length -%}
|
||||
{%- for _ in range(0, servicelength + header_text_length) -%}={%- endfor -%}
|
||||
{%- endmacro -%}
|
||||
{%- macro set_header(header_text) -%}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{{cookiecutter.service}}{{header_text}}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{%- endmacro -%}
|
||||
{{ set_header(" service overview") }}
|
||||
The {{cookiecutter.service}} service provides...
|
||||
|
||||
The {{cookiecutter.service}} service consists of the following components:
|
||||
|
||||
``{{cookiecutter.module_name}}-api`` service
|
||||
Accepts and responds to end user compute API calls...
|
|
@ -1,12 +1,24 @@
|
|||
============
|
||||
Installation
|
||||
============
|
||||
{%- macro set_header_markup(header_text_length) -%}
|
||||
{%- set servicelength = cookiecutter.service|length -%}
|
||||
{%- for _ in range(0, servicelength + header_text_length) -%}={%- endfor -%}
|
||||
{%- endmacro -%}
|
||||
{%- macro set_header(header_text) -%}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{{cookiecutter.service}}{{header_text}}
|
||||
{{ set_header_markup(header_text|length) }}
|
||||
{%- endmacro -%}
|
||||
{{ set_header(" service installation guide") }}
|
||||
|
||||
At the command line::
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
$ pip install {{ cookiecutter.repo_name }}
|
||||
get_started.rst
|
||||
install.rst
|
||||
verify.rst
|
||||
next-steps.rst
|
||||
|
||||
Or, if you have virtualenvwrapper installed::
|
||||
The {{cookiecutter.service}} service ({{cookiecutter.module_name}}) provides...
|
||||
|
||||
$ mkvirtualenv {{ cookiecutter.repo_name }}
|
||||
$ pip install {{ cookiecutter.repo_name }}
|
||||
This chapter assumes a working setup of OpenStack following the
|
||||
`OpenStack Installation Tutorial
|
||||
<https://docs.openstack.org/project-install-guide/ocata/>`_.
|
||||
|
|
|
@ -0,0 +1,34 @@
|
|||
.. _install-obs:
|
||||
|
||||
|
||||
Install and configure for openSUSE and SUSE Linux Enterprise
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This section describes how to install and configure the {{cookiecutter.service}} service
|
||||
for openSUSE Leap 42.1 and SUSE Linux Enterprise Server 12 SP1.
|
||||
|
||||
.. include:: common_prerequisites.rst
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
#. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# zypper --quiet --non-interactive install
|
||||
|
||||
.. include:: common_configure.rst
|
||||
|
||||
|
||||
Finalize installation
|
||||
---------------------
|
||||
|
||||
Start the {{cookiecutter.service}} services and configure them to start when
|
||||
the system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-{{cookiecutter.module_name}}-api.service
|
||||
|
||||
# systemctl start openstack-{{cookiecutter.module_name}}-api.service
|
|
@ -0,0 +1,33 @@
|
|||
.. _install-rdo:
|
||||
|
||||
Install and configure for Red Hat Enterprise Linux and CentOS
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
This section describes how to install and configure the {{cookiecutter.service}} service
|
||||
for Red Hat Enterprise Linux 7 and CentOS 7.
|
||||
|
||||
.. include:: common_prerequisites.rst
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
#. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install
|
||||
|
||||
.. include:: common_configure.rst
|
||||
|
||||
Finalize installation
|
||||
---------------------
|
||||
|
||||
Start the {{cookiecutter.service}} services and configure them to start when
|
||||
the system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# systemctl enable openstack-{{cookiecutter.module_name}}-api.service
|
||||
|
||||
# systemctl start openstack-{{cookiecutter.module_name}}-api.service
|
|
@ -0,0 +1,31 @@
|
|||
.. _install-ubuntu:
|
||||
|
||||
Install and configure for Ubuntu
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This section describes how to install and configure the {{cookiecutter.service}}
|
||||
service for Ubuntu 14.04 (LTS).
|
||||
|
||||
.. include:: common_prerequisites.rst
|
||||
|
||||
Install and configure components
|
||||
--------------------------------
|
||||
|
||||
#. Install the packages:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# apt-get update
|
||||
|
||||
# apt-get install
|
||||
|
||||
.. include:: common_configure.rst
|
||||
|
||||
Finalize installation
|
||||
---------------------
|
||||
|
||||
Restart the {{cookiecutter.service}} services:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# service openstack-{{cookiecutter.module_name}}-api restart
|
|
@ -0,0 +1,20 @@
|
|||
.. _install:
|
||||
|
||||
Install and configure
|
||||
~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
This section describes how to install and configure the
|
||||
{{cookiecutter.service}} service, code-named {{cookiecutter.module_name}}, on the controller node.
|
||||
|
||||
This section assumes that you already have a working OpenStack
|
||||
environment with at least the following components installed:
|
||||
.. (add the appropriate services here and further notes)
|
||||
|
||||
Note that installation and configuration vary by distribution.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
install-obs.rst
|
||||
install-rdo.rst
|
||||
install-ubuntu.rst
|
|
@ -0,0 +1,9 @@
|
|||
.. _next-steps:
|
||||
|
||||
Next steps
|
||||
~~~~~~~~~~
|
||||
|
||||
Your OpenStack environment now includes the {{cookiecutter.module_name}} service.
|
||||
|
||||
To add additional services, see
|
||||
https://docs.openstack.org/project-install-guide/ocata/.
|
|
@ -0,0 +1,24 @@
|
|||
.. _verify:
|
||||
|
||||
Verify operation
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
Verify operation of the {{cookiecutter.service}} service.
|
||||
|
||||
.. note::
|
||||
|
||||
Perform these commands on the controller node.
|
||||
|
||||
#. Source the ``admin`` project credentials to gain access to
|
||||
admin-only CLI commands:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ . admin-openrc
|
||||
|
||||
#. List service components to verify successful launch and registration
|
||||
of each process:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ openstack {{cookiecutter.service|lower}} service list
|
|
@ -0,0 +1,5 @@
|
|||
==========
|
||||
References
|
||||
==========
|
||||
|
||||
References of {{ cookiecutter.repo_name }}.
|
|
@ -0,0 +1,5 @@
|
|||
===========
|
||||
Users guide
|
||||
===========
|
||||
|
||||
Users guide of {{ cookiecutter.repo_name }}.
|
Loading…
Reference in New Issue