djpbessems/ContainerImage.Pinniped
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
f18cbcd9a6
ContainerImage.Pinniped/site/content/docs/howto/install-supervisor.md
Matt Moyer fd5ed2e5da
Rework "install" sections of our docs. 
- 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.5 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 60 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.

In the examples below, you can replace {{< latestversion >}} with your preferred version number. You can find a list of Pinniped releases on GitHub.

With default options

Using kapp

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

    • kapp deploy --app pinniped-supervisor --file https://get.pinniped.dev/{{< latestversion >}}/install-pinniped-supervisor.yaml

Using kubectl

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

    • kubectl apply -f https://get.pinniped.dev/{{< latestversion >}}/install-pinniped-supervisor.yaml

With custom options

Pinniped uses ytt from Carvel as a templating system.

  1. Install the ytt and kapp command-line tools 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. Decide which release version you would like to install. All release versions are listed on GitHub.

  4. Checkout your preferred version tag, e.g. {{< latestversion >}}:

    • git checkout {{< latestversion >}}

  5. Customize configuration parameters:

    • Edit values.yaml with your custom values.
    • Change the image_tag value to match your preferred version tag, e.g. {{< latestversion >}}.
    • See the default values for documentation about individual configuration parameters.

  6. Render templated YAML manifests:

    • ytt --file .

  7. Deploy the templated YAML manifests:

    ytt --file . | kapp deploy --app pinniped-supervisor --file -

Next steps

Next, [configure the Supervisor as an OIDC issuer]({{< ref "configure-supervisor" >}})!