Closed Bug 1822631 Opened 1 year ago Closed 1 year ago

Add documentation to recommend using pyenv for local python management for MacOS

Categories

(Testing :: Raptor, enhancement, P1)

Default
enhancement

Tracking

(firefox117 fixed)

RESOLVED FIXED
117 Branch
Tracking Status
firefox117 --- fixed

People

(Reporter: kshampur, Assigned: kshampur)

References

(Blocks 1 open bug)

Details

(Whiteboard: [fxp])

Attachments

(1 file)

Over the past year, there has been quite a handful of Mac users having issues using the performance testing harnesses (Usually Raptor, but could apply to Talos as well).

Almost always it was an issue with the Mac's system python not playing well with how mozilla central + perftest configures all the environments locally.

We could add a quick blurb/FAQ section to the documentation suggesting pyenv (or other choice) to manage the local python version, as that seems to have solved peoples issues

Ideally we could also spend time digging into our code when all the packages get set up and figuring out why exactly system python doesn't play well (this would likely take much longer)

We can probably just add a link that points to build component making mention of pyenv (and other things)
e.g. https://firefox-source-docs.mozilla.org/build/buildsystem/python.html#installing-python-manually

Blocks: dev-pain
Assignee: nobody → kshampur
Status: NEW → ASSIGNED
Priority: P3 → P1

This patch updates the debugging section of the raptor perfdocs with a quick blurb about recommending pyenv (or other alternative) for managing local Python versioning.
Over the past year, there have been quite a handful of macOS (and sometimes Linux) users having issues using the performance testing harnesses due to the Python environment suddenly breaking.
I consistently found that something like pyenv resolves this issue.

Attachment #9344490 - Attachment description: WIP: Bug 1822631 - Add documentation to recommend using alternative options for local python version management. r?#perftest → Bug 1822631 - Add documentation to recommend using alternative options for local python version management. r?#perftest
Pushed by kshampur@mozilla.com:
https://hg.mozilla.org/integration/autoland/rev/d05e7eb6194b
Add documentation to recommend using alternative options for local python version management. r=perftest-reviewers,sparky DONTBUILD
Status: ASSIGNED → RESOLVED
Closed: 1 year ago
Resolution: --- → FIXED
Target Milestone: --- → 117 Branch
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Created:
Updated:
Size: