Chapter 20. Creating a site on local systems using YAML
Using YAML allows you to create and manage sites on Docker, Podman and Linux.
A typical workflow is to create a site, link sites together, and expose services to the application network.
If you require more than one site, specify a unique namespace when using skupper, for example skupper --namespace second-site ....
20.1. Creating a simple site on local systems using YAML Copy linkLink copied to clipboard!
You can use YAML to create and manage Skupper sites.
Prerequisites
-
The
skupperCLI is installed.
There are many options to consider when creating sites using YAML, see YAML Reference, including frequently used options.
Procedure
Create a site CR YAML file named
my-site.yamlin an empty directory, for example,local:apiVersion: skupper.io/v2alpha1 kind: Site metadata: name: my-siteThis YAML creates a site named
my-sitein thedefaultnamespace.Create the site:
skupper system setup --path ./localSkupper attempts to process any files in the
localdirectory. Typically, you create all resources you require for a site before runningskupper system setup.Optional: Enable the Dynamic System Controller to automatically process YAML resources:
export SKUPPER_SYSTEM_RELOAD_TYPE=auto skupper system installWith this feature enabled, you can create sites, links, connectors and listeners without needing a system reload to apply your configuration.
Check the status of the site:
skupper site statusYou might need to issue the command multiple times before the site is ready:
NAME STATUS MESSAGE default Ready OKYou can now link this site to another site to create an application network.