Link resource

A site-to-site communication channel. Links serve as a transport for application connections and requests. A set of linked sites constitute a network.

Links are not usually created directly. Instead, you typically use an access token to obtain a link.

apiVersion: skupper.io/v2alpha1
kind: Link

Metadata properties

name

string

required

The name of the resource.

Platforms	Kubernetes, Docker, Podman, Linux

namespace

string

The namespace of the resource.

Platforms	Kubernetes, Docker, Podman, Linux
See also	Kubernetes namespaces

Spec properties

endpoints

array

required

An array of connection endpoints. Each item has a name, host, port, and group.

Platforms	Kubernetes, Docker, Podman, Linux

cost

integer

The configured routing cost of sending traffic over the link.

Default	1
Platforms	Kubernetes, Docker, Podman, Linux
See also	Load balancing

tlsCredentials

string

A named bundle of TLS certificates and keys used for secure router-to-router communication. The bundle contains the trusted server certificate. It optionally includes a client certificate and key for mutual TLS.

On Kubernetes, the value is the name of a Secret in the current namespace.

Platforms	Kubernetes, Docker, Podman, Linux
See also	Custom certificates, Kubernetes TLS secrets

settings

object

advanced

A map containing additional settings. Each map entry is a string name and a string value.

Platforms	Kubernetes, Docker, Podman, Linux

Status properties

remoteSiteId

string

The unique ID of the site linked to.

Platforms	Kubernetes, Docker, Podman, Linux

remoteSiteName

string

The name of the site linked to.

Platforms	Kubernetes, Docker, Podman, Linux

status

string

The current state of the resource.

Pending
Ready

Platforms	Kubernetes, Docker, Podman, Linux

message

string

A human-readable status message.

Platforms	Kubernetes, Docker, Podman, Linux

conditions

array

advanced

A set of named conditions describing the current state of the resource.

Platforms	Kubernetes
See also	Kubernetes conditions