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]