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

Better documentation for kubectl and azad-proxy plugin #179

Open
simongottschlag opened this issue Dec 12, 2022 · 3 comments
Open

Better documentation for kubectl and azad-proxy plugin #179

simongottschlag opened this issue Dec 12, 2022 · 3 comments

Comments

@simongottschlag
Copy link
Member

simongottschlag commented Dec 12, 2022

When following the installation guide, it's not obvious how to install kubectl and the azad-proxy plugin installation from krew is a bit down in the azad-kube-proxy documentation. We should add som docs to make this process easier to follow.

I've added some comments about how I got it working on a Windows 11 machine.

@simongottschlag
Copy link
Member Author

We should recommend installing winget for Windows: https://apps.microsoft.com/store/detail/app-installer/9NBLGGH4NNS1

Then it's just running winget install -e --id Kubernetes.kubectl to install the kubectl client.

@simongottschlag
Copy link
Member Author

Krew requires git wich isn't installed by default on Windows, but can easily be installed if you have winget using: winget install -e --id Git.Git

@simongottschlag
Copy link
Member Author

Krew can't be installed using winget, but easily done using:

$latestVersion = (Invoke-WebRequest "https://github.com/kubernetes-sigs/krew/releases/latest").BaseResponse.ResponseUri.OriginalString.split('/')[-1]
curl.exe -LO "https://github.com/kubernetes-sigs/krew/releases/download/$latestVersion/krew.exe"
curl.exe -LO "https://github.com/kubernetes-sigs/krew/releases/download/$latestVersion/krew.exe.sha256"

Now validate that the downloaded version have the correct hash: $(Get-FileHash -Algorithm SHA256 .\krew.exe).Hash -eq $(Get-Content .\krew.exe.sha256)

Then continue with the install:

.\krew.exe install krew
rm krew.exe*
[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";%USERPROFILE%\.krew\bin", [EnvironmentVariableTarget]::User)

Restart the shell/terminal and then install azad-proxy:

kubectl krew install azad-proxy

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

No branches or pull requests

1 participant