Site resource
A site is a place on the network where application workloads are running. Sites are joined by links.
The Site resource is the basis for site configuration. It is the parent of all Skupper resources in its namespace. There can be only one active Site resource per namespace.
Examples
A minimal site:
apiVersion: skupper.io/v2alpha1
kind: Site
metadata:
name: east
namespace: hello-world-east
A site configured to accept links:
apiVersion: skupper.io/v2alpha1
kind: Site
metadata:
name: west
namespace: hello-world-west
spec:
linkAccess: default
Metadata properties
name
The name of the resource.
| See also | Kubernetes object names |
|---|
namespace
The namespace of the resource.
| See also | Platform concept, Kubernetes namespaces |
|---|
Spec properties
linkAccess
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 |
| ||||||||
| Updatable | True | ||||||||
| See also | Link concept |
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 |
|---|---|
| Updatable | True |
defaultIssuer
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 specified.
This issuer is used by AccessGrant and RouterAccess if a specific issuer is not set.
| Default |
|
|---|---|
| Updatable | True |
| See also | Kubernetes TLS secrets |
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 |
|---|
serviceAccount
The name of the Kubernetes service account under which to run the Skupper router. A service account is generated if none is specified.
| Default | Generated |
|---|---|
| See also | Kubernetes service accounts |
settings
A map containing additional settings. Each map entry has a string name and a string value.
Note: In general, we recommend not changing settings from their default values.
routerDataConnections: Set the number of data connections the router uses when linking to other routers.
Default: Computed based on the number of router worker threads. Minimum 2.routerLogging: Set the router logging level.
Default:info. Choices:info,warning,error.
Status properties
status
The current state of the resource.
Pending: The resource is being processed.Error: There was an error processing the resource. Seemessagefor more information.Ready: The resource is ready to use.
message
A human-readable status message. Error messages are reported here.
conditions
A set of named conditions describing the current state of the resource.
Configured: The output resources for this resource have been created.Running: There is at least one router pod running.Resolved: The hostname or IP address for link access is available.Ready: The site is ready for use. All other conditions are true.
| See also | Kubernetes conditions |
|---|
defaultIssuer
The name of the Kubernetes secret containing the active default signing CA.
| See also | Kubernetes TLS secrets |
|---|
endpoints
An array of connection endpoints. Each item has a name, host, port, and group.
These include connection endpoints for link access.
| See also | Link concept |
|---|
network
sitesInNetwork
| See also | Network concept |
|---|