Pinniped Documentation
Install the Pinniped Concierge
This guide shows you how to install the Pinniped Concierge. You should have a supported Kubernetes cluster.
With default options
Install the latest version of the Concierge into the
pinniped-concierge
namespace with default options:kubectl apply -f https://get.pinniped.dev/latest/install-pinniped-concierge.yaml
With specific version and default options
Choose your preferred release version number and use it to replace the version number in the URL below.
Install the Concierge into the
pinniped-concierge
namespace with default options:kubectl apply -f https://get.pinniped.dev/v0.4.1/install-pinniped-concierge.yaml
Replace v0.4.1 with your preferred version number.
With custom options
Pinniped uses ytt from Carvel as a templating system.
Install the
ytt
command-line tool using the instructions from the Carvel documentation.Clone the Pinniped GitHub repository and visit the
deploy/concierge
directory:git clone git@github.com:vmware-tanzu/pinniped.git
cd pinniped/deploy/concierge
Customize configuration parameters:
- Edit
values.yaml
with your custom values. - See the default values for documentation about individual configuration parameters.
- Edit
Render templated YAML manifests:
ytt --file .
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-concierge --diff-changes --file -
Next, configure the Concierge for JWT or webhook authentication.