History

Matt Moyer f0320dfbd8 Rename login API to `login.concierge.pinniped.dev`. This is the first of a few related changes that re-organize our API after the big recent changes that introduced the supervisor component. Signed-off-by: Matt Moyer <moyerm@vmware.com>		2020-10-30 09:58:28 -05:00
..
config.pinniped.dev_credentialissuerconfigs.yaml	Move all three deployment dirs under a new top-level `deploy/` dir	2020-10-09 10:00:22 -07: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
idp.pinniped.dev_webhookidentityproviders.yaml	Move all three deployment dirs under a new top-level `deploy/` dir	2020-10-09 10:00:22 -07:00
rbac.yaml	Rename login API to `login.concierge.pinniped.dev`.	2020-10-30 09:58:28 -05:00
README.md	Move all three deployment dirs under a new top-level `deploy/` dir	2020-10-09 10:00:22 -07:00
values.yaml	Concierge controllers add labels to all created resources	2020-10-15 10:14:23 -07:00
z0_crd_overlay.yaml	Support installing concierge and supervisor into existing namespace	2020-10-14 15:05:42 -07: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 -