Feature #21572
closed
Reorganize doc/user/getting_started/setup-cli.html to prioritize installing as much as possible
Added by Brett Smith 9 months ago.
Updated 3 months ago.
Release relationship:
Auto
Description
User requested that this page just have a block of commands they can copy and paste to set everything up. I don't know if we can get 100% there right now, but we could probably get a lot closer, and good enough, with reasonable effort. Right now the page expects you to read a separate install page for each tool, which is a lot of hoop-jumping. Planned sections:
- Install with Debian/Ubuntu packages: Set up the apt repository, update, install all the client tool packages
- Install with RHEL family packages: Set up the yum repository, update, install all the client tool packages
- Install without privileges: Probably break this up into subsections to go from what most people will find easiest vs. hardest. Explain what you get at each step and let users know they can jump off whenever.
- The Python tools: run
python3 -m venv, pip install arvados-cwl-runner arvados_fuse crunchstat_summary
- If #20727 is done: Download
arvados-client to the right place
- The Ruby tools:
gem install arvados-cli—I'm less sure what's an appropriate incantation for this
The page can then link to separate pages for individual tools, for more information or for people who want to be more selective for whatever reason.
- Description updated (diff)
- Target version set to Development 2024-03-27 sprint
- Assigned To set to Brett Smith
- Target version changed from Development 2024-03-27 sprint to Development 2024-04-10 sprint
- Target version changed from Development 2024-04-10 sprint to Development 2024-04-24 sprint
- Target version changed from Development 2024-04-24 sprint to Development 2024-05-22 sprint
- Target version changed from Development 2024-05-22 sprint to Development 2024-06-05 sprint
- Target version changed from Development 2024-06-05 sprint to 439
- Target version changed from 439 to Development 2024-06-05 sprint
- Target version changed from Development 2024-06-05 sprint to Development 2024-06-19 sprint
- Status changed from New to In Progress
Brett Smith wrote:
- Install without privileges: Probably break this up into subsections to go from what most people will find easiest vs. hardest. Explain what you get at each step and let users know they can jump off whenever.
I'm starting to think it doesn't make sense to do this in the abstract, because realistically you'll need privileges to install build tools and headers for curl and FUSE. At that point, the instructions are so much more complicated for such a narrow use case, I don't think the effort is justified.
What might make sense is a higher-level generic "how to add Arvados Python packages to your development environment." But then it probably makes sense to have that documentation in the Python package(s) specifically, rather than this generic "setup client tools" page.
21572-user-packages @ c053155a074d202cc4a52a4a5829bd0083a3a69f - developer-run-tests: #4282 
- All agreed upon points are implemented / addressed.
- More or less, see the caveat above
- Anything not implemented (discovered or discussed during work) has a follow-up story.
- Code is tested and passing, both automated and manual, what manual testing was done is described
- See above. Also tested the install instructions by hand in Docker containers of focal (the oldest deb-based distro we support) and Rocky 8.8.
- Documentation has been updated.
- Behaves appropriately at the intended scale (describe intended scale).
- N/A for a pure documentation branch
- Considered backwards and forwards compatibility issues between client and server.
- Follows our coding standards and GUI style guidelines.
- N/A (no documentation style guide)
This makes it a lot less cumbersome. LGTM, thanks!
- Status changed from In Progress to Resolved
Also available in: Atom
PDF
Updated by 
Updated by 
Updated by