Update dependecies

[Nils-ChristianIseke]

Use noble for CI.

[Nils-ChristianIseke]

@christophebedard some open questions from my side. Happy if you could have a look?

[christophebedard]

I will take a look once I'm back from vacation on Tuesday-ish!

[christophebedard]

Sorry for the delay. I have some comments and suggestions.

[Nils-ChristianIseke]

Thank you @christophebedard !

[fujitatomoya]

thanks for the PR. a couple of comments.

[christophebedard]

from my end, I think we just need to clarify how the constraints.txt file was updated, and then we're good.

[christophebedard]

@Nils-ChristianIseke do you plan to continue working on this PR? The only thing missing is documenting how you generated the constraints.txt file: #5595 (comment).

If you don't have time, that's OK, I can take over.

[christophebedard]

Ah, I think it was missing the context, since previously requirements.txt and constraints.txt weren't COPYied during the image build. And the postCreateCommand needed to be updated.

The only other "issue" left is that the venv isn't sourced when you open a terminal, so you need to source it manually (. /opt/ros2doc/bin/activate) before building (make html). Do you know how to make it source this automatically?

[fujitatomoya]

i think that we need to rely on the shell in the userland of container, devcontainer does not have control this user environment.

before adding this change, how come do we need the python venv in the 1st place? having docker build environment is kinda dedicated and containerized environment for this specific task? then why do we need python venv??? what is the benefit to have python venv? i maybe missed some context here...

[christophebedard]

I think it was meant to be a cleaner/more modern alternative to using --break-system-packages (to get rid of the corresponding error in the Python version shipped with 24.04). And having to install pip dependencies as the user (not simply in a venv) inside the Docker container makes dealing with user/UID a bit more complicated. However, it seems to work, so I guess we can go with that.

[christophebedard]

But, in my opinion, there are too many ways to build the docs:

1. Locally using venv (simplest)
2. GitHub Codespaces
3. Devcontainer
4. Docker image (what's used by CI)

I think the Codespace and devcontainer options are secondary, and I wouldn't necessarily avoid using venvs (and use a more fragile & less modern approach) in the 4th option just to avoid running 1 command in a devcontainer terminal.

[fujitatomoya]

@christophebedard thanks for fixing up.

i usually use devcontainer to build and test the documentation, Codespaces is actually devcontainer.
AFAIK, we do not really promote using docker directly to the user, right? that means, we actually maintain 2 ways to build the documentation, i say that is not bad ... 🤔

anyway, lgtm 👍 i think we can address minor adjustment if there are, once we upgrade the base system to ubuntu 24.04. again, thanks for addressing the comments.

[christophebedard]

I'll run a test doc build/deployment job again (after my last changes) tomorrow just to make sure it's still good.

[claraberendsen]

Merging this PR will just make the existing build.ros.org/job/doc_ros2doc/ job use the updated 24.04 Docker image to build the docs instead of a 22.04 image. Does that sound good to you?

Yes! Thanks for the work here, it's separate but part of the same migration and I was trying to land both so we can push everything to 24.04.

[christophebedard]

I tested again locally + using a test job, it looks good. Let's merge this!

[christophebedard]

I'm backporting this, because we generally keep the same build setup on all branches. The actual CI job that builds docs only uses the rolling branch, but other branches may be used by someone making a single-branch build from the humble branch, for example.

[christophebedard]

I did a quick check. The doc_ros2doc job on build.ros.org has been working fine with an Ubuntu 24.04-based image (to build the docs) for a couple of days now, so all good: https://build.ros.org/job/doc_ros2doc/1868/consoleFull#console-section-9

[fujitatomoya]

@christophebedard thanks for checking that, that is good to know 👍