Chapter 15. Creating a site on a local system using the Skupper CLI

Verify the installation.

skupper version

COMPONENT               VERSION
cli                     2.2.1-rh-1

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>

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

Install the controller for Podman and Docker sites:

skupper system install

This runs a container to support site, link and service operations. This feature is not available on Linux local system sites (systemd).

Optional: Enable the Dynamic System Controller to automatically process YAML resources and commands:

export SKUPPER_SYSTEM_RELOAD_TYPE=auto
skupper system install

Alternatively, you can enable this feature with:

skupper system install --reload-type auto

With this feature enabled, you can create sites, links, connectors and listeners without needing a system reload to apply your configuration.

Create a site:

skupper site create <site-name>

For example:

skupper site create my-site

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

While the site is created, the site is not running at this point. To run the site:

skupper system start

Enter the following command to delete a site:

skupper site delete <sitename>
skupper system stop

You can also uninstall the controller after deleting all existing sites:

skupper system uninstall

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

Install the controller for Podman and Docker sites:

skupper system install

This runs a container to support site, link and service operations. This feature is not available on Linux local system sites (systemd).

Optional: Enable the Dynamic System Controller to automatically process YAML resources:

export SKUPPER_SYSTEM_RELOAD_TYPE=auto
skupper system install

With this feature enabled, you can create sites, links, connectors and listeners without needing a system reload to apply your configuration.

Create a site:

skupper site create <site-name>

For example:

skupper site create remote-site

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

While the site is created, the site is not running and that is not a requirement for this usecase.

Create the bundle:

 skupper system generate-bundle remote-site

The output shows the location of the generated .tar.gz file, for example:

Site "remote-site" has been created (as a distributable bundle)
Installation bundle available at: /home/user/.local/share/skupper/bundles/remote-site.tar.gz
Default namespace: default
Default platform: podman

Transfer the bundle file to the remote location and uncompress the file in an appropriate location:

tar -xzvf remote-site.tar.gz

Start the site:

install.sh

The site is now running, you can verify with skupper site status if the CLI is installed at that location.