ContainerImage.Pinniped/install-cli.md at 52409f86e85e68adb514d08729a157b585c3dcfa

- Remove all the "latest" links and replace them with our new shortcode so they point at the latest release in a more explicit way.
  This also eliminates one of the sections in our Concierge and Supervisor install guides, since you're always installing a specific version.

- Provide instructions for installing with both kapp (one step) and kubectl (two steps for the Concierge).

- Minor wording changes. Mainly we are now a bit less verbose about reminding people they can choose a different version (once per page instead of in each step).

- When we give an example `kapp deploy` command, don't suggest `--yes` and `--diff-changes`.
  Users can still use these but it seems overly verbose for an example command.

Signed-off-by: Matt Moyer <moyerm@vmware.com>

2021-07-29 08:45:19 -05:00

2.7 KiB

Raw Blame History

title

description

cascade

Install the Pinniped command-line tool

Download and set up the `pinniped` command-line tool on macOS, Linux, or Windows clients.

layout
docs

docs

name	weight	parent
Install CLI	10	howtos

The pinniped command-line tool is used to generate Pinniped-compatible kubeconfig files, and is also an important part of the Pinniped-based login flow.

It must be installed by administrators setting up a Pinniped cluster as well as by users accessing a Pinniped-enabled cluster.

Install using Homebrew on macOS or Linux

Use Homebrew to install from the Pinniped tap:

brew install vmware-tanzu/pinniped/pinniped-cli

Download binaries

Find the appropriate binary for your platform from the latest release:

{{< buttonlink filename="pinniped-cli-darwin-amd64" >}}Download {{< latestversion >}} for macOS/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}

{{< buttonlink filename="pinniped-cli-linux-amd64" >}}Download {{< latestversion >}} for Linux/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}

{{< buttonlink filename="pinniped-cli-windows-amd64.exe" >}}Download {{< latestversion >}} for Windows/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}

You should put the command-line tool somewhere on your $PATH, such as /usr/local/bin on macOS/Linux. You'll also need to mark the file as executable.

To find specific versions or view all available platforms and architectures, visit the releases page.

Gatekeeper

If you are using macOS, you may get an error dialog when you first run pinniped that says “pinniped” cannot be opened because the developer cannot be verified. Cancel this dialog, open System Preferences, click Security & Privacy, and click the Allow Anyway button next to the Pinniped message.

Run the command again and another dialog appears saying macOS cannot verify the developer of “pinniped”. Are you sure you want to open it?. Click Open to allow the command to proceed.

Install a specific version via script

Choose your preferred release and use it to replace the version number in the URL below.

For example, to install {{< latestversion >}} on Linux/amd64:

curl -Lso pinniped https://get.pinniped.dev/{{< latestversion >}}/pinniped-cli-linux-amd64 \
  && chmod +x pinniped \
  && sudo mv pinniped /usr/local/bin/pinniped

Next steps

Next, [install the Supervisor]({{< ref "install-supervisor.md" >}}) and/or [install the Concierge]({{< ref "install-concierge.md" >}})!

2.7 KiB Raw Blame History