OneDeploy missing document changes for hatch vs poetry?

Hello,

short question: Will these documents for OneDeploy steps be updated to include python hatch steps to match code changed added Jan 29th to onedeploy git repo?
Tutorial: Automated Cloud Deployment with Shared Storage — OpenNebula 6.10.2 documentation

I’ve had done an fresh install on Ubuntu24.04 using OneDeploy for the first time on Jan 2nd 2025. It went well, I’m now attempting it again to fix some mistakes I made to get a clean new setup.

I hit the following right away, unless I’ve done something different, wasn’t there before. I’m using exact same fresh setup from the same Ubuntu24.04 ISO.

root@onedeploy-1:/home/luser/one-deploy# make requirements
pip3 install --requirement /home/luser/one-deploy/requirements.txt
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.12/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.
make: *** [Makefile:64: requirements-python] Error 1
root@onedeploy-1:/home/luser/one-deploy#

I worked around this with:

root@onedeploy-1:/home/luser/one-deploy# apt-get install  python3-venv
root@onedeploy-1:/home/luser/one-deploy# python3 -m venv .venv
root@onedeploy-1:/home/luser/one-deploy# source .venv/bin/activate


(.venv) root@onedeploy-1:/home/luser/one-deploy# make requirements
pip3 install --requirement /home/luser/one-deploy/requirements.txt
Collecting molecule (from -r /home/luser/one-deploy/requirements.txt (line 1))
  Downloading molecule-25.2.0-py3-none-any.whl.metadata (6.0 kB)

Following the online OneDeploy v6.10 steps here:
Tutorial: Automated Cloud Deployment with Shared Storage — OpenNebula 6.10.2 documentation

However, the Poetry steps aren’t working and I no longer see poetry in the Makefile.

It seem yesterday Jan 29th 2025 there are git changes for OneDeploy. In particular related to the 1st step of “make requirements”.

some repo checkin comments

requirements.txt

F #109 #72: Replace poetry with hatch/uv (#112)

I have also noticed steps for pipx on this wiki

sys_reqs · OpenNebula/one-deploy Wiki · GitHub

Those seem to have same issue. Can you point me at the proper document to go with the latest OneDeploy code?

Thanks,

–Ken

pipx

root@onedeploy-1:/home/luser/one-deploy# pipx ensurepath
Success! Added /root/.local/bin to the PATH environment variable.

Consider adding shell completions for pipx. Run 'pipx completions' for instructions.

You will need to open a new terminal or re-login for the PATH changes to take effect.

Otherwise pipx is ready to go! ✨ 🌟 ✨
root@onedeploy-1:/home/luser/one-deploy# source ~/.bashrc
root@onedeploy-1:/home/luser/one-deploy# make requirements
pip3 install --requirement /home/luser/one-deploy/requirements.txt
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.12/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.
make: *** [Makefile:64: requirements-python] Error 1
root@onedeploy-1:/home/luser/one-deploy# 

Hello @kemcfarl,

Thank you for reaching out!

Please note that the documentation has not yet been updated to reflect the recent changes in master, specifically regarding the replacement of Poetry with Hatch and UV. It will be updated with the upcoming release of one-deploy 1.2.1.

In the meantime, I recommend referring to the following documentation, where Hatch is used to install OneDeploy in the Front-end.