search

kubernetes / website

Kubernetes website and documentation repo:
https://kubernetes.io
Creative Commons Attribution 4.0 International
4.48k stars 14.4k forks source link

Task page for installing kubectl should explain how to find direct download link #47614

Closed crsadun closed 2 months ago

crsadun commented 2 months ago

There's million users which have no direct internet access from the workplace other than downloading from HTTP/HTTPS websites for security reasons. Others do not have chocolatey installed or cannot copy/paste curl commands from an external website to their local workstation, also for security reasons.

Currently the HTTP link to download kubectl is inside a curl command. It could be possible to provide a more explicit HTML link, for clarity.

k8s-ci-robot commented 2 months ago

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
sftim commented 2 months ago

We could have the kubectl install pages link to https://kubernetes.io/releases/download/#binaries

Historically, we had this guide to installing kubectl before https://kubernetes.io/releases/download/#binaries existed. Now that https://kubernetes.io/releases/download/#binaries is a thing, we can link to it.

@crsadun would that suit you?

/retitle Task page for installing kubectl should explain how to find direct download link /kind feature /language en

sftim commented 2 months ago

This was originally filed about https://k8s.io/docs/tasks/tools/install-kubectl-windows/

sftim commented 2 months ago

I did read that page and I can see that there's already a direct download link for https://dl.k8s.io/release/v1.31.0/bin/windows/amd64/kubectl.exe

This is under a slightly misleading heading; the text

Download the latest 1.31 patch release: kubectl 1.31.0

is headed:

Install kubectl binary with curl on Windows

so maybe we'd like to change the heading as well? I still recommend linking to the list of binaries you can download.

The existing link does assume amd64 architecture; on the other hand, AMD processors (and Intel clones) are the market leader.

/priority awaiting-more-evidence

crsadun commented 2 months ago

Thank you yes the misleading text is probably the main problem - but the list of binaries can also be very useful as the organizations who prevent direct internet access are often the ones who don't run the latest version of any tool :)

The idea is to make it as clearer as possible as it's gonna be the first option for many as opposite to run curs or package managers which aren't so common on Windows.

sftim commented 2 months ago

OK, so: which fix do you advocate @crsadun ? We should recommend one so that someone picking up this work knows what approach to take.

network-charles commented 2 months ago

Hey @sftim, I'd like to work on this.

Based on the discussion, here are my suggestions:

/assign