History

Matt Moyer 9e1922f1ed Split the config CRDs into two API groups. Signed-off-by: Matt Moyer <moyerm@vmware.com>		2020-10-30 19:22:46 -05:00
..
README.md	Move all three deployment dirs under a new top-level `deploy/` dir	2020-10-09 10:00:22 -07:00
authentication.concierge.pinniped.dev_webhookauthenticators.yaml	Rename WebhookIdentityProvider to WebhookAuthenticator.	2020-10-30 15:11:53 -05:00
config.concierge.pinniped.dev_credentialissuerconfigs.yaml	Split the config CRDs into two API groups.	2020-10-30 19:22:46 -05:00
deployment.yaml	Rename login API to `login.concierge.pinniped.dev`.	2020-10-30 09:58:28 -05:00
helpers.lib.yaml	Support installing concierge and supervisor into existing namespace	2020-10-14 15:05:42 -07:00
rbac.yaml	Split the config CRDs into two API groups.	2020-10-30 19:22:46 -05:00
values.yaml	Concierge controllers add labels to all created resources	2020-10-15 10:14:23 -07:00
z0_crd_overlay.yaml	Split the config CRDs into two API groups.	2020-10-30 19:22:46 -05:00

README.md

Deploying

Connecting Pinniped to an Identity Provider

If you would like to try Pinniped, but you don't have a compatible identity provider, you can use Pinniped's test identity provider. See deploy/local-user-authenticator/README.md for details.

Installing the Latest Version with Default Options

kubectl apply -f https://github.com/vmware-tanzu/pinniped/releases/download/$(curl https://api.github.com/repos/vmware-tanzu/pinniped/releases/latest -s | jq .name -r)/install-pinniped.yaml

Installing an Older Version with Default Options

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

# Replace v0.2.0 with your preferred version in the URL below
kubectl apply -f https://github.com/vmware-tanzu/pinniped/releases/download/v0.2.0/install-pinniped.yaml

Installing with Custom Options

Creating your own deployment YAML file requires ytt from Carvel to template the YAML files in the deploy/concierge directory. Either install ytt or use the container image from Dockerhub.

git clone this repo and git checkout the release version tag of the release that you would like to deploy.
The configuration options are in deploy/concierge/values.yml. Fill in the values in that file, or override those values using additional ytt command-line options in the command below. Use the release version tag as the image_tag value.
In a terminal, cd to this deploy/concierge directory
To generate the final YAML files, run ytt --file .
Deploy the generated YAML using your preferred deployment tool, such as kubectl or kapp. For example: ytt --file . | kapp deploy --yes --app pinniped --diff-changes --file -