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

Documentation issue: Installing Bazel on Arm #11994

Closed
mattsplats opened this issue Aug 22, 2020 · 7 comments
Closed

Documentation issue: Installing Bazel on Arm #11994

mattsplats opened this issue Aug 22, 2020 · 7 comments
Assignees
Labels
P2 We'll consider working on this in future. (Assignee optional) team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website type: documentation (cleanup)

Comments

@mattsplats
Copy link
Contributor

mattsplats commented Aug 22, 2020

Documentation URL: https://docs.bazel.build/versions/master/install-ubuntu.html

Install instructions cover using the Debian repo, but do not mention that this will not work for arm64 systems. arch is specified as amd64, but specifying arm64 will also fail because the Debian repo does not contain this build currently.

Instructions should state that the Debian repo and build scripts are not available for arm64 systems. Bazelisk, the pre-built binary, or building from source should be used instead.

Perhaps:

Install Bazel on Ubuntu using one of the following methods:
- Use Bazelisk (recommended)
- Use our custom APT repository
- Use the binary installer
- Compile Bazel from source

APT installation is not available for Arm-based systems. Instead, use one of the following methods:
- Use Bazelisk (recommended)
- Use the pre-built arm64 binary
- Compile Bazel from source
@jin jin added team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website type: documentation (cleanup) untriaged labels Aug 22, 2020
@jin
Copy link
Member

jin commented Aug 22, 2020

cc @philwo

@mattsplats
Copy link
Contributor Author

Related: should make it clear that Bazelisk will work for Redhat-based and other distros. Another page may be useful for this.

@philwo philwo self-assigned this Sep 21, 2020
@philwo philwo added P2 We'll consider working on this in future. (Assignee optional) and removed untriaged labels Sep 21, 2020
@mattsplats
Copy link
Contributor Author

Just following up on this - I can submit a PR if it would help. Thanks!

@philwo
Copy link
Member

philwo commented Oct 5, 2020

@mattsplats Thank you! Sorry, I didn't get around to update the docs myself, but I'd be happy to review a PR.

@mattsplats
Copy link
Contributor Author

No worries. There seems to be a delta between the Github readme and the web instructions - is there a pipeline that should publish the document? I can submit changes but want to be sure they make it to the website.

@philwo
Copy link
Member

philwo commented Oct 6, 2020

@mattsplats This part of the webseite is versioned together with Bazel and the linked commit came after Bazel 3.5.x was cut from the master branch. If you switch the shown version to master in the drop-down in the top-left corner of the website, it should show the latest version. :)

@mattsplats
Copy link
Contributor Author

Ahh, got it, thanks.

bazel-io pushed a commit that referenced this issue Oct 9, 2020
See #11994.

Looks like a simple note is all that's needed now for installing on Ubuntu.

Also, I noticed the Fedora/CentOS instructions don't work on Amazon Linux 2, so I added a reference to Bazelisk - let me know what you think. Could call out AL2 specifically.

Closes #12232.

PiperOrigin-RevId: 336358670
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
P2 We'll consider working on this in future. (Assignee optional) team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website type: documentation (cleanup)
Projects
None yet
Development

No branches or pull requests

3 participants