Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[setup] Rewrite Ubuntu install_prereqs from the ground up #22055

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

jwnimmer-tri
Copy link
Collaborator

@jwnimmer-tri jwnimmer-tri commented Oct 17, 2024

This change is Reviewable

@jwnimmer-tri jwnimmer-tri changed the title [setup] Add --developer flag to install_prereqs [setup] Rewrite Ubuntu install_prereqs from the ground up Nov 4, 2024
@jwnimmer-tri jwnimmer-tri force-pushed the setup-txt-accuracy branch 2 times, most recently from bbf37ee to ef6931b Compare November 4, 2024 17:23
Copy link
Collaborator Author

@jwnimmer-tri jwnimmer-tri left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed 13 of 15 files at r1, 28 of 30 files at r2, 2 of 3 files at r3, 2 of 3 files at r4.
Reviewable status: 2 unresolved discussions, needs platform reviewer assigned, needs at least two assigned reviewers, commits need curation (https://drake.mit.edu/reviewable.html#curated-commits), missing label for release notes


doc/_pages/from_source.md line 42 at r5 (raw file):

require a working display server. Most personal computers will have this
already built in, but some cloud or docker environments may require extra
setup steps.

Working

Refresh our advice re: display servers now that we use EGL by default.


doc/_pages/installation.md line 40 at r5 (raw file):

require a working display server.  Most personal computers will have this
already built in, but some cloud or docker environments may require extra
setup steps.

Working

Refresh our advice re: display servers now that we use EGL by default.

The existing from-source setup scripts are deprecated and will be
removed after 2025-06-01:
- setup/ubuntu/install_prereqs.sh
- setup/ubuntu/source_distribution/install_prereqs_user_environment.sh

Instead, users and developers should run setup/install_prereqs (not as
root).

Usability changes:
- Fine-tuned log output, with option for --verbose (e.g., in CI).
- Skip unnecessary steps; incremental runs are typically sub-second.

Maintainability changes:
- Always use files, not heredocs. (The pkg-config etc in a heredoc were
  documented as unwanted when using Drake's Debian packages, but that
  was wrong; we always want those deps even in Debian packages.)

Website changes:
- Major updates to from_source that explain how to install from CMake.

A few cleanups macOS come along for the ride:
- Remove useless binary_distribution_called_update shenanigans.
- Remove vestigial i386 rcfile.
- Abandon all hope of supporting 'brew install drake'.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant