Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 2.05 KB

installation.md

File metadata and controls

57 lines (40 loc) · 2.05 KB
Raw

Installation

this guide refer to installing the permission manager on a running cluster

Install with kubectl

  • Create the Namespace where the application will be deployed
kubectl create namespace permission-manager
  • Deploy the application's secret using the manifest that you can find in deployments/kubernetes/secret.yml with the configuration for the application, for example:
---
apiVersion: v1
kind: Secret
metadata:
  name: permission-manager
  namespace: permission-manager
type: Opaque
stringData:
  PORT: "4000" # port where server is exposed
  CLUSTER_NAME: "my-cluster" # name of the cluster to use in the generated kubeconfig file
  CONTROL_PLANE_ADDRESS: "https://172.17.0.3:6443" # full address of the control plane to use in the generated kubeconfig file
  BASIC_AUTH_PASSWORD: "changeMe" # password used by basic auth (username is `admin`)

Deploy the application

kubectl apply -f https://github.com/sighupio/permission-manager/releases/download/v1.9.0/crd.yml
kubectl apply -f https://github.com/sighupio/permission-manager/releases/download/v1.9.0/seed.yml
kubectl apply -f https://github.com/sighupio/permission-manager/releases/download/v1.9.0/deploy.yml

Visit the application

kubectl port-forward svc/permission-manager 4000 --namespace permission-manager

the application can now be accessed by http://localhost:4000

Install with Helm

It is also possible to deploy Permission Manager using the provided Helm Chart.

First create a values file, for example my-values.yaml, with your custom values for the release. See the chart's readme and the default values.yaml for more information.

Then, execute:

helm repo add permission-manager https://sighupio.github.io/permission-manager
helm upgrade --install --namespace permission-manager --set image.tag=v1.9.0 --values my-values.yaml permission-manager permission-manager/permission-manager

don't forget to replace my-values.yaml with the path to your values file.