Red Hat Summit Red Hat SummitSupportKonsoleEntwicklerDemo startenKontakt

Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

Chapter 14. 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 ....

14.1. Checking the Skupper CLI and environment
Link kopieren

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
    Copy to Clipboard Toggle word wrap

  3. For podman sites:

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

    systemctl --user enable --now podman.socket
    Copy to Clipboard Toggle word wrap

    Enable lingering to ensure the site persists over logouts: 

    loginctl enable-linger <username>
    Copy to Clipboard Toggle word wrap

14.2. Creating a simple site using the CLI on local systems
Link kopieren

Prerequisites

  • The skupper CLI is installed.

Procedure

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

    • podman
    • docker
    • linux

  2. Install the controller for Podman and Docker sites: 

    skupper system install
    Copy to Clipboard Toggle word wrap

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

  3. Create a site: 

    skupper site create <site-name>
    Copy to Clipboard Toggle word wrap

    For example: 

    skupper site create my-site

Waiting for status...
Site "my-site" is ready.
    Copy to Clipboard Toggle word wrap

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

    skupper system start
    Copy to Clipboard Toggle word wrap

By default, all sites are created with the namespace default. On non-Kubernetes sites, you can create multiple sites per-user by specifying a namespace, for example you can create multiple sites with different platforms as follows: 

skupper site create systemd-site -p linux -n linux-ns
skupper site create docker-site -p docker -n docker-ns
Copy to Clipboard Toggle word wrap

14.3. Deleting a site using the CLI on local systems
Link kopieren

Prerequisites

  • The skupper CLI is installed.

Procedure

  1. Enter the following command to delete a site: 

    skupper site delete <sitename>
skupper system stop
    Copy to Clipboard Toggle word wrap

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

    skupper system uninstall
    Copy to Clipboard Toggle word wrap

14.4. Creating a site bundle using the CLI on local systems
Link kopieren

Sometimes, you might want to create all the configuration for a site and apply it automatically to a remote host. To support this, Skupper allows you create a .tar.gz file with all the required files and an install.sh script to start the remote site.

Prerequisites

  • The skupper CLI is installed. The CLI is not required on the remote site.

Procedure

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

    • podman
    • docker
    • linux

  2. Install the controller for Podman and Docker sites: 

    skupper system install
    Copy to Clipboard Toggle word wrap

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

  3. Create a site: 

    skupper site create <site-name>
    Copy to Clipboard Toggle word wrap

    For example: 

    skupper site create remote-site

Waiting for status...
Site "remote-site" is ready.
    Copy to Clipboard Toggle word wrap

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

  4. Create the bundle: 

     skupper system generate-bundle remote-site
    Copy to Clipboard Toggle word wrap

    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
    Copy to Clipboard Toggle word wrap

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

    tar -xzvf remote-site.tar.gz
    Copy to Clipboard Toggle word wrap

  6. Start the site: 

    install.sh
    Copy to Clipboard Toggle word wrap

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

Nach oben
Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat Dokumentation

Wir helfen Red Hat Benutzern, mit unseren Produkten und Diensten innovativ zu sein und ihre Ziele zu erreichen – mit Inhalten, denen sie vertrauen können. Entdecken Sie unsere neuesten Updates.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Theme

© 2025 Red Hat