Doc improvements

[lecorguille]

I'm starting the test as a naive user (easy for me)

Some improvements - Part I:

• Add a link on the doc front page to this repository
• Add the OS supported in the requirements
• Suggest a size of VM at least to handle the demo in the requirements
• Remove Usage from the Installation -> Usage should be the steps of configuration of the 3 roles

[lecorguille]

Some improvements - Part II:

• Explain the hosts you need in development/hosts
• Add link to the github repo here
• Explain that Terraform is handle by the localhost and should be configure in group_vars/localhost/terraform.yml
• Can you have give some clues how to find the different Terroform settings (On GenOuest OpenStacks it's in API Access -> View Credentials). I don't know if it's the case everywhere.
• [Code] Add some comments in your variable if the variable is only dedicated to OpenStacks to prepare the support of other providers
• https://gga-cloud.readthedocs.io/en/latest/installation/index.html#usage <- the playbook filename aren't correct

[lecorguille]

Fail 1:

TASK [abims-sbr.gga_terraform : Run terraform] *********************************************************************************************************************************************************************************************************************************
fatal: [127.0.0.1]: FAILED! => {"changed": false, "msg": "Failed to find required executable \"terraform\" in paths: /home/genouest/cnrs_fr2424/lecorguille/venv_ansible/bin:/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin"}

Suggestions

Suggestions 1

A possibility could be a variable the user can switch to install Terraform via Miniconda in the Terraform role?

Suggestions 2 (maybe more easy)

Or suggest in the installation steps a full miniconda approach to install both Ansible and Terraform

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
. miniconda3/bin/activate gga_env

[lecorguille]

Fail 2:

TASK [abims-sbr.gga_terraform : Run terraform] *********************************************************************************************************************************************************************************************************************************
fatal: [127.0.0.1]: FAILED! => {"changed": false, "msg": "Failed to initialize Terraform modules:\r\n\u001b[31m\u001b[0mThere are some problems with the configuration, described below.\n\nThe Terraform configuration must be valid before initialization so that\nTerraform can determine which modules and providers need to be installed.\u001b[0m\u001b[0m\n\u001b[31m\u001b[31m╷\u001b[0m\u001b[0m\n\u001b[31m│\u001b[0m \u001b[0m\u001b[1m\u001b[31mError: \u001b[0m\u001b[0m\u001b[1mDuplicate resource \"openstack_compute_volume_attach_v2\" configuration\u001b[0m\n\u001b[31m│\u001b[0m \u001b[0m\n\u001b[31m│\u001b[0m \u001b[0m\u001b[0m  on resource.tf line 32:\n\u001b[31m│\u001b[0m \u001b[0m  32: \u001b[4mresource \"openstack_compute_volume_attach_v2\" \"vol_attach\"\u001b[0m {\u001b[0m\n\u001b[31m│\u001b[0m \u001b[0m\n\u001b[31m│\u001b[0m \u001b[0mA openstack_compute_volume_attach_v2 resource named \"vol_attach\" was\n\u001b[31m│\u001b[0m \u001b[0malready declared at resource.tf:26,1-59. Resource names must be unique per\n\u001b[31m│\u001b[0m \u001b[0mtype in each module.\n\u001b[31m╵\u001b[0m\u001b[0m\n\u001b[0m\u001b[0m\n"}

I have clearly an issue with the config... maybe somewhere in the credentials?

[lecorguille]

• Add a doc about the need of ssh.cfg (<- ansible-playbook playbook_gga_install.yml)