Chapter 8. Using Skupper Podman

Procedure

1. Set your session to use Skupper Podman:

   $ export SKUPPER_PLATFORM=podman

   Copy to Clipboard Toggle word wrap

   To verify the skupper mode:

   $ skupper switch
   
   podman

   Copy to Clipboard Toggle word wrap

2. Create a Skupper site:

   Use the following command to create a site where tokens are created to link on any network interface:

   $ skupper init

   Copy to Clipboard Toggle word wrap
   Note

   By default, this command times out after 2 minutes for podman sites. You can increase the time with the --timeout option.

   The following output is displayed:

   It is recommended to enable lingering for <username>, otherwise Skupper may not start on boot.
   Skupper is now installed for user '<username>'.  Use 'skupper status' to get more information.

   Copy to Clipboard Toggle word wrap

   Use the following command to start the site service at system start and persist over logouts:

   # loginctl enable-linger <username>

   Copy to Clipboard Toggle word wrap

   By default, skupper init tries to include all IP addresses associated with local network interfaces as valid ingress hosts. You can use --ingress-host <IP/Hostname> to restrict token ingress to a specific network context:

   $ skupper init --ingress-host my-cloud-vm.example.com

   Copy to Clipboard Toggle word wrap

   If you do not require that other sites can link to the site you are creating:

   $ skupper init --ingress none

   Copy to Clipboard Toggle word wrap

   In this guide we assume you have enabled ingress using the first command. This allows you create tokens that allow links from every network interface on the host.

   Note

   When creating a token you can specify the ingress host.

   You can also restrict ingress to an IP address or hostname when initializing as described in the Skupper Podman CLI reference documentation.

3. Check the status of your site:

   $ skupper status
   Skupper is enabled for "<username>" with site name "<machine-name>-<username>" in interior mode. It is not connected to any other sites. It has no exposed services.

   Copy to Clipboard Toggle word wrap
   Note

   You can only create one site per user. If you require a host to support many sites, create a user for each site.

Procedure

1. Generate a token on one site:

   $ skupper token create <filename>

   Copy to Clipboard Toggle word wrap

   If you created the site without specifying an ingress-host, the token is valid for all network contexts. You can use --ingress-host <IP/Hostname> to restrict token ingress to a specific network context:

   $ skupper token create <filename> --ingress-host <IP/Hostname>

   Copy to Clipboard Toggle word wrap

2. Create a link from the other site:

   $ skupper link create <filename>

   Copy to Clipboard Toggle word wrap