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

UX refinements #46

Closed
jonatasbaldin opened this issue Oct 11, 2019 · 9 comments · Fixed by #59
Closed

UX refinements #46

jonatasbaldin opened this issue Oct 11, 2019 · 9 comments · Fixed by #59

Comments

@jonatasbaldin
Copy link
Contributor

Expected Behaviour

Copy and paste the commands from the Installation instructions in README.md would work.

Current Behaviour

The first line from the installation instructions gives me the k3sup-$arch binary and correct instructions:

$ curl -sLS https://get.k3sup.dev | sh
=========================================================
==    As the script was run as a non-root user the     ==
==    following commands may need to be run manually   ==
=========================================================

  sudo cp k3sup-darwin /usr/local/bin/k3sup

But the second command in the instructions fails, because the binary name is different:

$ sudo install k3sup /usr/local/bin/
install: k3sup: No such file or directory

Possible Solution

  1. Remove second line of installation, letting the user follow the instructions from the get.sh output
  2. After downloading the binary, rename it from k3sup-$arch to k3sup and adjust the instructions in the get.sh output to sudo cp k3sup /usr/local/bin/k3sup

Steps to Reproduce (for bugs)

  1. Execute exactly the installation instructions

Context

A quick change to yield a better experience when installing the binary. The first impression sticks 😅

Your Environment

  • MacOS.
@alexellis
Copy link
Owner

You should type in this though? sudo cp k3sup-darwin /usr/local/bin/k3sup

@alexellis
Copy link
Owner

Worked for me

space-mini:tmp alex$ curl -sLS https://get.k3sup.dev | sh

You already have the k3sup cli!
Overwriting in 1 seconds.. Press Control+C to cancel.

Downloading package https://github.com/alexellis/k3sup/releases/download/0.4.2/k3sup-darwin as /tmp/k3sup-darwin
Download complete.

=========================================================
==    As the script was run as a non-root user the     ==
==    following commands may need to be run manually   ==
=========================================================

  sudo cp k3sup-darwin /usr/local/bin/k3sup

space-mini:tmp alex$   sudo cp k3sup-darwin /usr/local/bin/k3sup
Password:
space-mini:tmp alex$ 

@jonatasbaldin
Copy link
Contributor Author

jonatasbaldin commented Oct 11, 2019

Yeah, if I follow the instructions it work, but if I just copy and paste the instructions from the README.md, it doesn't:

# Instructions from README.md
curl -sLS https://get.k3sup.dev | sh
sudo install k3sup /usr/local/bin/

k3sup --help

# output

You already have the k3sup cli!
Overwriting in 1 seconds.. Press Control+C to cancel.

Downloading package https://github.com/alexellis/k3sup/releases/download/0.4.2/k3sup-darwin as /Users/jonatasbaldin/scratch/test-k3s/k3sup-darwin
Download complete.

=========================================================
==    As the script was run as a non-root user the     ==
==    following commands may need to be run manually   ==
=========================================================

  sudo cp k3sup-darwin /usr/local/bin/k3sup

Password:
install: k3sup: No such file or directory

The second line from the README instruction fails.

@alexellis
Copy link
Owner

This is the normal way to download with the suffix still in-tact, but if you want, we could change it. I'd accept a �PR

@alexellis
Copy link
Owner

The point was to show one example of how to install, the example in the README is for Linux where there is no suffix, you're using Darwin, so you need to follow the output instead :-)

@jonatasbaldin
Copy link
Contributor Author

I can make a PR, I have three ideas (in the order that I most like them):

  1. Remove second line from README.md and add sudo before the first line, will always work
  2. Remove second line from README.md, let the user read the instructions
  3. Change the get.sh script to download the file as k3sup instead of k3sup-$suffix

What do u think?

@alexellis
Copy link
Owner

I think 3. sounds fine, if you'd like to implement it.

@alexellis
Copy link
Owner

/set title: UX refinements

@derek derek bot changed the title Following the installation scripts fails UX refinements Oct 20, 2019
@jonatasbaldin
Copy link
Contributor Author

Went with 3 :D

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants