It may be appropriate to provide some information on how to use python virtualenv

[gwarf]

If people blindly follow the instructions on https://docs.egi.eu/users/cloud-compute/openstack/ using python may be confusing, leading to doing system-wide install, and may not always work as expected.

As python3 natively supports virtualenvs with just a couple of commands it may be helpful to provide some short info like on how to setup and use a virtualenv to do things cleanly:

mkdir ~/.virtualenvs
# or python depending on the name of your python 3 binary
python3 -m venv ~/.virtualenvs/fedcloud
# This command will have to be run to enable the fedcloud virtualenv and access the fedcloud commands
source  ~/.virtualenvs/fedcloud/bin/activate

[sebastian-luna-valero]

I would even go a step further:

# one-off install at the beginning:
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh -b -p egifedcloud
source egifedcloud/etc/profile.d/conda.sh 
conda create -n openstack python-openstackclient -c conda-forge --yes
conda activate openstack
openstack --help

# activation everytime you want to use it aftewards:
source egifedcloud/etc/profile.d/conda.sh 
conda activate openstack
openstack --help

The only change to work on OSX would be wget command with the relevant link to Miniconda from:
https://docs.conda.io/en/latest/miniconda.html

Best regards,
Sebastian

[EGI-ILM]

(And perhaps consider to mention the deactivate to clean things up)

[gwarf]

I would even go a step further:

# one-off install at the beginning:
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh -b -p egifedcloud
source egifedcloud/etc/profile.d/conda.sh 
conda create -n openstack python-openstackclient -c conda-forge --yes
conda activate openstack
openstack --help

# activation everytime you want to use it aftewards:
source egifedcloud/etc/profile.d/conda.sh 
conda activate openstack
openstack --help

The only change to work on OSX would be wget command with the relevant link to Miniconda from: https://docs.conda.io/en/latest/miniconda.html

Best regards, Sebastian

This is more elaborated stuff to be added, and adding other stuff like conda usage (that I've never used) may add some complexity and more possible problems, and would need to document more third parties things.
I'm usually more for trying to promote using only basic stuff, like the native python3 venv, without relying on much additional components that may cause other unexpected issues.

That said it's on my current personal feeling.

[EGI-ILM]

Windows is slightly different because it calls a BAT file, but I am not sure if Windows has to be considered