From 9672d005a9c4afade8df1b4c0d2ba0c7b6357e7c Mon Sep 17 00:00:00 2001
From: "Diaz de Arcaya Serrano, Josu" <josu.diazdearcaya@tecnalia.com>
Date: Thu, 8 Sep 2022 14:22:44 +0200
Subject: [PATCH] update documentation

---
 docs/docs_files/01-intro.rst |  7 +++---
 docs/docs_files/02-iem.rst   | 46 ++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 4 deletions(-)
 create mode 100644 docs/docs_files/02-iem.rst

diff --git a/docs/docs_files/01-intro.rst b/docs/docs_files/01-intro.rst
index 45533a1..d3563bc 100644
--- a/docs/docs_files/01-intro.rst
+++ b/docs/docs_files/01-intro.rst
@@ -4,7 +4,6 @@
 Introduction
 ************
 
-..
-    TODO Provide a brief description of the component here. Outline its goals, functionalities, etc.;
-    Mention subcomponents or extra delivered tools etc., with rst references to adequate sections.
-    
\ No newline at end of file
+The IaC Execution Manager utilizes different technologies that can be used for the provisioning, configuration, and orchestration of the different infrastructural devices that can be found in a production deployment. This has served us to provide evidence and reasoning for the selection of the technologies that the IEM prototype is going to utilize.
+
+This prototype is viable for the deployment of different IaC technologies that cover the provisioning and the configuration of the infrastructural devices required for the projects utilizing the PIACERE framework. It provides a unified interface for other components so they can interact with the IEM in a unified manner. It can also be deployed in production utilizing container-based technologies which makes this prototype viable to be operationalized in public and private cloud provides, and on premises. For this prototype, the IEM supports two well established technologies (i.e. Ansible and Terraform) that are able to provision the different infrastructural devices required by the use cases, and the configuration of each of these infrastructural devices so they can accommodate the applications to be allocated.
diff --git a/docs/docs_files/02-iem.rst b/docs/docs_files/02-iem.rst
new file mode 100644
index 0000000..fba4b99
--- /dev/null
+++ b/docs/docs_files/02-iem.rst
@@ -0,0 +1,46 @@
+.. _iem:
+
+*********************
+IaC Execution Manager
+*********************
+
+Running the server
+```bash
+uvicorn main:app --reload
+```
+
+###### Containers
+
+Containerize the IEM
+```bash
+docker build --build-arg API_KEY=$API_KEY -t optima-piacere-docker-dev.artifact.tecnalia.com/wp5/iem-api:y1 .
+```
+
+Similarly, docker compose can be used to build both
+```bash
+docker-compose build
+```
+
+It can also be used to push them to the registry
+```bash
+docker-compose push
+```
+
+Run the IEM
+```bash
+docker run -p 8000:8000 optima-piacere-docker-dev.artifact.tecnalia.com/wp5/iem-api:y1
+```
+
+###### Tests
+
+Run all tests
+
+```bash
+nose2 -v
+```
+
+Run a single test
+
+```bash
+nose2 -v tests.core.test_iem.TestIem.test_deploy_destroy_openstack
+```
-- 
GitLab