Browse Source

Added prerequisites and configure IaC extension

Added the following sub-sections to the "Modify your
environment using Git repository section":

- Prerequisites
- Configure the Fuel IaC extension

Change-Id: I437800bc86885ddbe294b12bfd30040e189711be
Svetlana Karslioglu 2 years ago
parent
commit
e92e314b13

+ 5
- 5
userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo.rst View File

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

+ 53
- 3
userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/configure-iac.rst View File

@@ -1,6 +1,56 @@
1 1
 .. _configure-iac:
2 2
 
3
-Configure the IAC extenstion
4
-============================
3
+Configure the Fuel IaC extenstion
4
+=================================
5 5
 
6
-TBA
6
+To be able to deploy changes from a Git repository, you need
7
+to configure the Fuel Infrastructure-as-Code (IaC) extension
8
+on the Fuel Master node. The Fuel Master node must have either
9
+an access to the Internet, or an access to a local repository
10
+mirror with the required ``.rpm`` package.
11
+
12
+**To configure the IaC extension:**
13
+
14
+#. Install the Fuel IaC extension using the ``yum`` command:
15
+
16
+   ::
17
+
18
+     yum install fuel-nailgun-extension-iac
19
+
20
+#. Synchronize the Nailgun database:
21
+
22
+   ::
23
+
24
+     nailgun_syncdb
25
+
26
+#. Restart the Nailgun service:
27
+
28
+   ::
29
+
30
+     systemctl restart nailgun.service
31
+
32
+#. Verify the extension is installed correctly by viewing
33
+   the list of installed extensions:
34
+
35
+   ::
36
+
37
+     fuel2 extension list
38
+
39
+   **Example of system response:**
40
+
41
+   ::
42
+
43
+    +-------------------+---------+-------------------+---------------------+
44
+    | name              | version | description       | provides            |
45
+    +-------------------+---------+-------------------+---------------------+
46
+    | fuel_external_git | 1.0.0   | Nailgun extension | []                  |
47
+    |                   |         | which uses git    |                     |
48
+    |                   |         | repo for config   |                     |
49
+    |                   |         | files.            |                     |
50
+    +-------------------+---------+-------------------+---------------------+
51
+
52
+#. Enable the extension for the required environment:
53
+
54
+   ::
55
+
56
+     fuel2 env extension enable <env_id> -E fuel_external_git

+ 9
- 2
userdocs/fuel-user-guide/post-deployment-conf/lcm-git-repo/lcm-prerequisites.rst View File

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

Loading…
Cancel
Save