Red Hat Summit이 콘텐츠는 선택한 언어로 제공되지 않습니다.
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
Installing the skupper command-line interface (CLI) provides a simple method to get started with Skupper.
- Follow the instructions for Installing Skupper.
Verify the installation.
skupper version COMPONENT VERSION cli 2.1.1
skupper version COMPONENT VERSION cli 2.1.1Copy to Clipboard Copied! Toggle word wrap Toggle overflow For podman sites:
Make sure the Podman socket is available. To enable it:
systemctl --user enable --now podman.socket
systemctl --user enable --now podman.socketCopy to Clipboard Copied! Toggle word wrap Toggle overflow Enable lingering to ensure the site persists over logouts:
loginctl enable-linger <username>
loginctl enable-linger <username>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
14.2. Creating a simple site using the CLI on local systems
Prerequisites
-
The
skupperCLI is installed.
Procedure
Set the
SKUPPER_PLATFORMfor type of site you want to install:-
podman -
docker -
linux
-
Install the controller for Podman and Docker sites:
skupper system install
skupper system installCopy to Clipboard Copied! Toggle word wrap Toggle overflow This runs a container to support site, link and service operations. This feature is not available on Linux local system sites (systemd).
Create a site:
skupper site create <site-name>
skupper site create <site-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow For example:
skupper site create my-site Waiting for status... Site "my-site" is ready.
skupper site create my-site Waiting for status... Site "my-site" is ready.Copy to Clipboard Copied! Toggle word wrap Toggle overflow While the site is created, the site is not running at this point. To run the site:
skupper system start
skupper system startCopy to Clipboard Copied! Toggle word wrap Toggle overflow
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
skupper site create systemd-site -p linux -n linux-ns
skupper site create docker-site -p docker -n docker-ns14.3. Deleting a site using the CLI on local systems
Prerequisites
-
The
skupperCLI is installed.
Procedure
Enter the following command to delete a site:
skupper site delete <sitename> skupper system stop
skupper site delete <sitename> skupper system stopCopy to Clipboard Copied! Toggle word wrap Toggle overflow You can also uninstall the controller after deleting all existing sites:
skupper system uninstall
skupper system uninstallCopy to Clipboard Copied! Toggle word wrap Toggle overflow
14.4. Creating a site bundle using the CLI on local systems
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
skupperCLI is installed. The CLI is not required on the remote site.
Procedure
Set the
SKUPPER_PLATFORMfor type of site you want to install:-
podman -
docker -
linux
-
Install the controller for Podman and Docker sites:
skupper system install
skupper system installCopy to Clipboard Copied! Toggle word wrap Toggle overflow This runs a container to support site, link and service operations. This feature is not available on Linux local system sites (systemd).
Create a site:
skupper site create <site-name>
skupper site create <site-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow For example:
skupper site create remote-site Waiting for status... Site "remote-site" is ready.
skupper site create remote-site Waiting for status... Site "remote-site" is ready.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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
skupper system generate-bundle remote-siteCopy to Clipboard Copied! Toggle word wrap Toggle overflow The output shows the location of the generated
.tar.gzfile, 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
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: podmanCopy to Clipboard Copied! Toggle word wrap Toggle overflow Transfer the bundle file to the remote location and uncompress the file in an appropriate location:
tar -xzvf remote-site.tar.gz
tar -xzvf remote-site.tar.gzCopy to Clipboard Copied! Toggle word wrap Toggle overflow Start the site:
install.sh
install.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow The site is now running, you can verify with
skupper site statusif the CLI is installed at that location.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}