Creating a site on a local system using the Skupper CLI

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

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

A local system includes Docker, Podman or Linux system.

If you require more than one site, specify a unique namespace when using skupper, for example skupper --namespace second-site ....

Checking the Skupper CLI and environment

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.0.0
   

3. For podman sites:

   Make sure the Podman socket is available. To enable it:

   systemctl --user enable --now podman.socket
   

   Enable lingering to ensure the site persists over logouts:

   loginctl enable-linger <username>
   

Creating a simple site using the CLI on local systems

Prerequisites

• The skupper CLI is installed.

Procedure

1. Set the SKUPPER_PLATFORM for type of site you want to install:

   • podman
   • docker
   • linux

2. Create a site:

   $ skupper site create <site-name>
   

   For example:

   $ skupper site create my-site
   Waiting for status...
   Site "my-site" is ready.
   

📌 NOTE: On non-Kubernetes sites, you can create multiple sites per-user by specifying a namespace.

Deleting a site using the CLI on local systems

Prerequisites

• The skupper CLI is installed.

Procedure

1. Enter the following command to delete a site:

   skupper system teardown