Creating a site on Kubernetes using the Skupper CLI

Using the skupper command-line interface (CLI) allows you to create and manage sites from the context of the current namespace.

A typical workflow is to create a site, link sites together, and expose services to the application network.

Checking the Skupper CLI

Installing the skupper command-line interface (CLI) provides a simple method to get started with Skupper.

  1. Follow the instructions for Installing Skupper.

  2. Verify the installation.

    skupper version

COMPONENT               VERSION
cli                     2.1.1

Creating a simple site using the CLI on Kubernetes

Prerequisites

  • The skupper CLI is installed.
  • The Skupper controller is running on the Kubernetes cluster you are running or you are running on a platform.

Procedure

  1. Check that the SKUPPER_PLATFORM environment is unset or set to kubernetes.

    • kubernetes - default
    • podman
    • docker
    • linux

  2. Create a site on Kubernetes:

    skupper site create <site-name> --namespace <namespace>

    Specifying the namespace is not required if the context is set to the namespace where you want to create the site. For example:

    skupper site create my-site

Waiting for status...
Site "my-site" is ready.

    There are many options to consider when creating sites using the CLI, see CLI Reference, including frequently used options.

For example

  • --enable-link-access

    If enabled, this option allows you create tokens and link to this site. By default, this option is disabled but you can change the setting later skupper site update --enable-link-access.

  • --timeout <time>

    You can add the timeout option to specify the maximum time for the CLI wait for the site status to report ready.

    skupper site create my-site --timeout 2m

    The timeout option does not stop the site from being created, but if the site is not ready, the following is output:

    Site "my-site" is not yet ready: Pending

    You can check the status of the site at any time using skupper site status.

    By default, the router CPU allocation is BestEffort as described in Pod Quality of Service Classes and this might affect performance under network load. To configure site resources, see Setting site resources.

Deleting a site using the CLI on Kubernetes

Prerequisites

  • The skupper CLI is installed.

Procedure

  1. Change context to the namespace where the site was created, for example:

    kubectl config set-context --current --namespace west

  2. Enter the following command to delete a site:

    skupper site delete