Home
Products
Red Hat Service Interconnect
2.1
Using Service Interconnect
Chapter 17. Creating a site on local systems using YAML

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

17.1. Creating a simple site on local systems using YAML
Copy link

You can use YAML to create and manage Skupper sites.

Prerequisites

The skupper CLI is installed.

Procedure

Create a site CR YAML file named my-site.yaml in an empty directory, for example, local:
```
apiVersion: skupper.io/v2alpha1
kind: Site
metadata:
  name: my-site
```
```
apiVersion: skupper.io/v2alpha1
kind: Site
metadata:
  name: my-site
```
Copy to Clipboard Toggle word wrap
This YAML creates a site named my-site in the default namespace.
Create the site:
```
skupper system setup --path ./local
```
```
skupper system setup --path ./local
```
Copy to Clipboard Toggle word wrap
Skupper attempts to process any files in the local directory. Typically, you create all resources you require for a site before running skupper system setup.
Check the status of the site:
```
skupper site status
```
```
skupper site status
```
Copy to Clipboard Toggle word wrap
You might need to issue the command multiple times before the site is ready:
```
NAME    STATUS  MESSAGE
default Ready   OK
```
```
NAME    STATUS  MESSAGE
default Ready   OK
```
Copy to Clipboard Toggle word wrap
You can now link this site to another site to create an application network.

There are many options to consider when creating sites using YAML, see YAML Reference, including frequently used options.

Back to top

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat