update documentation

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.

docs/docs_files/02-iem.rst

+.. _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
+```