djpbessems/ContainerImage.Pinniped
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
349d3dad83
ContainerImage.Pinniped/site/content/docs/howto/install-supervisor.md
Matt Moyer 520eb43bfd
Replace all references to "a specific version" with v0.8.0. 
The documentation was a bit confusing before, and it was easy to accidentally install a very outdated version if you weren't reading carefully.

We could consider writing a post-release CI job to update these references automatically (perhaps using a Hugo macro?), but for now a manual update seems sufficient.

Signed-off-by: Matt Moyer <moyerm@vmware.com>
2021-05-24 11:50:16 -05:00

2.1 KiB
Raw Blame History

title description cascade menu
Install the Pinniped Supervisor Install the Pinniped Supervisor service in a Kubernetes cluster.
layout
docs
docs
name weight parent
Install Supervisor 30 howtos

This guide shows you how to install the Pinniped Supervisor, which allows seamless login across one or many Kubernetes clusters. You should have a supported Kubernetes cluster with working HTTPS ingress capabilities.

With default options

  1. Install the latest version of the Supervisor into the pinniped-supervisor namespace with default options:

    • kubectl apply -f https://get.pinniped.dev/latest/install-pinniped-supervisor.yaml

With specific version and default options

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

  2. Install the Supervisor into the pinniped-supervisor namespace with default options:

    • kubectl apply -f https://get.pinniped.dev/v0.8.0/install-pinniped-supervisor.yaml

      Replace v0.8.0 with your preferred version number.

With custom options

Pinniped uses ytt from Carvel as a templating system.

  1. Install the ytt command-line tool using the instructions from the Carvel documentation.

  2. Clone the Pinniped GitHub repository and visit the deploy/supervisor directory:

    • git clone git@github.com:vmware-tanzu/pinniped.git
    • cd pinniped/deploy/supervisor

  3. Customize configuration parameters:

    • Edit values.yaml with your custom values.
    • See the default values for documentation about individual configuration parameters.

  4. Render templated YAML manifests:

    • ytt --file .

  5. Deploy the templated YAML manifests:

    • If you're using kubectl:

      ytt --file . | kubectl apply -f -

    • If you're using kapp from Carvel:

      ytt --file . | kapp deploy --yes --app pinniped-supervisor --diff-changes --file -