Site create command
Create a site.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| Waits for | Ready |
Usage
skupper site create <name> [options]
Examples
# Create a site
$ skupper site create west
Waiting for status...
Site "west" is ready.
# Create a site that can accept links from remote sites
$ skupper site create west --enable-link-access
Primary options
<name>
A name of your choice for the Skupper site. This name is displayed in the console and CLI output.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
--enable-link-access
Allow access for incoming links from remote sites.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| See also | Link access concept |
--link-access-type
Configure external access for links from remote sites.
Sites and links are the basis for creating application networks. In a simple two-site network, at least one of the sites must have link access enabled.
| Default |
| ||||||
|---|---|---|---|---|---|---|---|
| Choices |
| ||||||
| Platforms | Kubernetes | ||||||
| See also | Site linking, Link access concept, Kubernetes load balancer services |
--enable-ha
Configure the site for high availability (HA). HA sites have two active routers.
Note that Skupper routers are stateless, and they restart after failure. This already provides a high level of availability. Enabling HA goes further and reduces the window of downtime caused by restarts.
| Default | False |
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Advanced deployment options |
--timeout
Raise an error if the operation does not complete in the given period of time.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Duration format |
--wait
Wait for the given status before exiting.
| Default |
| ||||||
|---|---|---|---|---|---|---|---|
| Choices |
| ||||||
| Platforms | Kubernetes, Docker, Podman, Linux |
--default-issuer
The name of a Kubernetes secret containing the signing CA used to generate a certificate from a token. A secret is generated if none is supplied.
This issuer is used by AccessGrant and RouterAccess if a specific issuer is not set.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--enable-edge
Configure the site to operate in edge mode. Edge sites cannot accept links from remote sites.
Edge mode can help you scale your network to large numbers of sites. However, for networks with 16 or fewer sites, there is little benefit.
Currently, edge sites cannot also have HA enabled.
| Default | False |
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Advanced deployment options |
--service-account
The name of the Kubernetes service account under which to run the Skupper controller.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Advanced deployment options, Kubernetes service accounts |
Global options
--context
Set the kubeconfig context.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--kubeconfig
Set the path to the kubeconfig file.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--namespace
Set the namespace.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| See also | Kubernetes namespaces |
--platform
Set the Skupper platform.
| Default |
| ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Choices |
| ||||||||
| Platforms | Kubernetes, Docker, Podman, Linux | ||||||||
| See also | Platform concept |
--help
Display help and exit.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
Errors
A site resource already exists
There is already a site resource defined for the namespace.