Improve terraform documentation

[enolfc]

Short Description of the issue

Add information available at https://docs.google.com/document/d/1FGt15nxZU0Atz6oLxz5sSH_ePU0V-qV132rS1dqzuvA/edit#

Summary of proposed changes

[enolfc]

#378 improved docs
Should we get a more detailed guide on using terraform?

[gwarf]

If the complete example works it's already a good thing, but some pointers/examples on possible usage/ideas may be interesting. That also depends on how much we may wan to highlight/support/promote the usage of this tool (ie first class citizen vs available for courageous people.
We also may not want to have too complex/long doc on this tool, as it would need to be updated too as terraform evolves.

[sebastian-luna-valero]

IMHO, web interfaces (IM Dashboard, VMOps Dashboard) should be the first class citizens to interact with the EGI Federated Cloud, since they are convenient for all (beginner and experienced) users.

If you know how to work with terraform, your are kind of courageous already :). Therefore, the EGI docs should only explain what's required to interact with the Federated Cloud but anything else should point to terraform documentation.

[EGI-ILM]

I agree with Sebastian. We should not deal with Terraform commands, but with Fedcloud stuff.

Actually, I have worked on a documentation to facilitate the use of Terraform with EGI infrastructure.... I can give you permission @enolfc and @gwarf to the draft if you want to have a look. But, in my opinion, this should be a temporary solution. Eventually, the functionality should be integrated into fedcloudclient.