Installing the Skupper controller
If you are using Skupper on local systems (Podman, Docker, Linux), you must install the CLI.
Before you can create a site on Kubernetes, you must install the Skupper controller. You can install the controller using the following methods:
- Directly using YAML
- Helm charts
- Operator
After installing the Skupper controller, you can create sites using the CLI or YAML:
NOTE: If you install the controller scoped to cluster, you can create sites in any namespace. If you scope the controller to a namespace, you can only create sites in that namespace.
Installing the Skupper controller using YAML
Prerequisites
- cluster-admin access to cluster
Procedure
Install a cluster-scoped controller using the following commands:
kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.0.0/skupper-cluster-scope.yaml
Install a namespace-scoped controller using the following commands:
kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.0.0/skupper-namespace-scope.yaml
Installing the Skupper controller using Helm
Prerequisites
- cluster-admin access to cluster
Procedure
Install a cluster-scoped controller using the following commands:
kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.0.0/skupper-cluster-scope.yaml
Install a namespace-scoped controller using the following commands:
kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.0.0/skupper-namespace-scope.yaml
Installing the Skupper controller using the Skupper Helm charts
Prerequisites
- cluster-admin access to cluster
- helm (See https://helm.sh/docs/intro/install/)
Procedure
Run the following command to install a cluster-scoped controller:
helm install skupper oci://quay.io/skupper/helm/skupper --version 2.0.0
To install a namespace-scoped controller, add the --set scope=namespace
option.
Installing the Skupper CLI
You can use the Skupper CLI with Kubernetes or on local systems (Podman, Docker, Linux).
On local systems, the CLI is all you require to create a site.
Procedure
To download the latest release:
curl https://skupper.io/v2/install.sh | sh
To download a specific version, download from Releases page.
On local systems, you can install the controller using:
skupper system install -p [podman, docker, linux]