Merge "Added prerequisites and configure IaC extension"

This commit is contained in:
Jenkins 2016-12-02 16:37:09 +00:00 committed by Gerrit Code Review
commit aac5cb4aad
3 changed files with 66 additions and 9 deletions

View File

@ -9,12 +9,12 @@ configurations in this repository and apply changes to your
environments. This approach enables you to modify the settings environments. This approach enables you to modify the settings
you typically cannot modify through the Fuel web UI. you typically cannot modify through the Fuel web UI.
The functionality is implemented through an additional Infrastructure-as- The functionality is implemented through an additional Infrastructure-as-Code
a-Code extension to Fuel. You need to clone the (IaC) extension to Fuel. The extension is distributed as an ``.rpm`` package.
``fuel-nailgun-extension-iac`` repository Therefore, you need to download and install the package on your Fuel Master
on your Fuel Master node before you can use this feature. node before you can use this feature.
With the Infrastructure-as-a-Code extension to Fuel you can: With the Infrastructure-as-Code extension to Fuel you can:
* Associate a Git repository with a specific OpenStack environment. * Associate a Git repository with a specific OpenStack environment.
* Perform management operations, such as create, read, update, and delete * Perform management operations, such as create, read, update, and delete

View File

@ -1,6 +1,56 @@
.. _configure-iac: .. _configure-iac:
Configure the IAC extenstion Configure the Fuel IaC extenstion
============================ =================================
TBA To be able to deploy changes from a Git repository, you need
to configure the Fuel Infrastructure-as-Code (IaC) extension
on the Fuel Master node. The Fuel Master node must have either
an access to the Internet, or an access to a local repository
mirror with the required ``.rpm`` package.
**To configure the IaC extension:**
#. Install the Fuel IaC extension using the ``yum`` command:
::
yum install fuel-nailgun-extension-iac
#. Synchronize the Nailgun database:
::
nailgun_syncdb
#. Restart the Nailgun service:
::
systemctl restart nailgun.service
#. Verify the extension is installed correctly by viewing
the list of installed extensions:
::
fuel2 extension list
**Example of system response:**
::
+-------------------+---------+-------------------+---------------------+
| name | version | description | provides |
+-------------------+---------+-------------------+---------------------+
| fuel_external_git | 1.0.0 | Nailgun extension | [] |
| | | which uses git | |
| | | repo for config | |
| | | files. | |
+-------------------+---------+-------------------+---------------------+
#. Enable the extension for the required environment:
::
fuel2 env extension enable <env_id> -E fuel_external_git

View File

@ -3,6 +3,13 @@
Prerequisites Prerequisites
============= =============
TBA To apply changes using ``.yaml`` files from a Git repository,
your environment must meet the following prerequisites:
* A Git repository that has a structure similar to the described in
:ref:`repo-structure`.
* The Fuel Master node must have an access to the Git
repository with the structure and to the repository with the Fuel
IaC extension..
* Your environment must run Mirantis OpenStack 9.2 or later.