Project

General

Profile

Actions

Support #20838

open

Discontinue OS packages of client tools in favor of pypi/rubygems only

Added by Peter Amstutz over 1 year ago. Updated 11 months ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
Deployment
Target version:
Due date:
Story points:
-

Description

End users generally install from PyPi or Rubygems instead of using OS packages for client tools. This is because the OS packages have more friction: they require setting up the Arvados package repository and being root in order to install.

Meanwhile, building client packages for older OS versions with older Python/Ruby interpreters is a hassle. For example, a Python dependency drops support for an out-of-support Python (e.g. 3.6) then we have to pin an older version, fork the package, or resolve it some other way.

This is less of a problem for services -- we don't have any services that use Python, and our installer installs a specific Ruby version using rvm.

Specifically, this includes

  • python3-arvados-python-client
  • python3-arvados-cwl-runner
  • python3-arvados-fuse
  • python3-crunchstat-summary
  • python3-arvados-user-activity (I don't think this one is on PyPi yet)
  • python3-cwltest (IDK why we are packaging this in the first place)

Tasks:

  1. Announce that the client OS packages will no longer be published
  2. Remove them from the build scripts
  3. Update the documentation to only provide instructions to install from PyPi

Related issues

Related to Arvados - Idea #20727: Publish standalone binaries for arvados-client, other Go client toolsNewActions
Related to Arvados Epics - Idea #20344: Arvados 3.0Resolved08/01/202310/31/2024Actions
Related to Arvados - Bug #21087: Python 3.7 deprecationResolvedBrett SmithActions
Related to Arvados - Idea #21263: Delist or document deprecated PyPI packagesNewActions
Blocked by Arvados - Support #20875: Deprecate OS packages for client toolsFeedbackPeter AmstutzActions
Actions #1

Updated by Peter Amstutz over 1 year ago

  • Category set to Deployment
Actions #2

Updated by Peter Amstutz over 1 year ago

  • Related to Idea #20727: Publish standalone binaries for arvados-client, other Go client tools added
Actions #3

Updated by Peter Amstutz over 1 year ago

Actions #4

Updated by Peter Amstutz over 1 year ago

  • Description updated (diff)
Actions #5

Updated by Peter Amstutz over 1 year ago

  • Description updated (diff)
Actions #6

Updated by Peter Amstutz over 1 year ago

  • Blocked by Support #20875: Deprecate OS packages for client tools added
Actions #7

Updated by Brett Smith over 1 year ago

What is the plan for installing shell nodes after this ticket is done? If these tools get installed via pip/gem there now too, how do the tools get into users' $PATH?

What about arvados-docker-cleaner? That's a Python service, installed on compute nodes.

Actions #8

Updated by Brett Smith about 1 year ago

  • Related to Bug #21087: Python 3.7 deprecation added
Actions #9

Updated by Brett Smith 12 months ago

  • Related to Idea #21263: Delist or document deprecated PyPI packages added
Actions #10

Updated by Peter Amstutz 12 months ago

I want to reconsider this. I think there's still value in having OS packages even when most users will prefer the PyPi route. If there is a distribution we want to support which lacks a compatible Python version, we could look in to using PyInstaller (#20893) to build self-contained packages that don't rely on system Python at all.

Actions #11

Updated by Brett Smith 11 months ago

Peter Amstutz wrote in #note-10:

If there is a distribution we want to support which lacks a compatible Python version, we could look in to using PyInstaller (#20893) to build self-contained packages that don't rely on system Python at all.

Given our plan to support latest and previous Debian stable, and latest and previous Ubuntu LTS, the only distro we want to support that ships with too-old Python is the RHEL 8 variants. And by far the easiest way to build packages for it would be to build against the python39 appstream included with the 8.8 release.

I do think we should at least prioritize PyPI installation in the sense of making it the first documented way to install, and generally recommended. I think most users will prefer that both because it's what they're allowed to use and because they're familiar with the tools. I think we should consider the packages to be more administrator-focused, and have our documentation reflect that.

Actions #12

Updated by Brett Smith 11 months ago

Brett Smith wrote in #note-11:

Given our plan to support latest and previous Debian stable, and latest and previous Ubuntu LTS, the only distro we want to support that ships with too-old Python is the RHEL 8 variants. And by far the easiest way to build packages for it would be to build against the python39 appstream included with the 8.8 release.

Agreed at grooming meeting we will do this. I think #21273 is the best fit for this much-narrower-in-scope ticket.

After that, all that remains of this ticket is potential documentation changes to prioritize PyPI installs over distro ones:

I do think we should at least prioritize PyPI installation in the sense of making it the first documented way to install, and generally recommended. I think most users will prefer that both because it's what they're allowed to use and because they're familiar with the tools. I think we should consider the packages to be more administrator-focused, and have our documentation reflect that.

Actions

Also available in: Atom PDF