Connector create command

skupper connector create <name> <port> [options]

Create a connector.

PlatformsKubernetes, Docker, Podman, Linux
Waits forConfigured

Examples

# Create a connector for a database
$ skupper connector create database 5432
Waiting for status...
Connector "database" is configured.

# Set the routing key and selector explicitly
$ skupper connector create backend 8080 --routing-key be1 --selector app=be1

# Use the workload option to select pods
$ skupper connector create backend 8080 --workload deployment/backend

Primary options

<name>

string
required

The name of the resource to be created.

The name is the default routing key if the --routing-key option is not specified. On Kubernetes, the name defines the default pod selector if the --selector and --workload options are not specified.

See alsoKubernetes object names

<port>

integer
required

The port on the target server to connect to.

UpdatableTrue

--routing-key

<string>
frequently used

The identifier used to route traffic from listeners to connectors. To expose a local workload to a remote site, the remote listener and the local connector must have matching routing keys.

Default

Value of name

UpdatableTrue

--workload

<resource>
frequently used

A Kubernetes resource name that identifies a workload. It uses <resource-type>/<resource-name> syntax and resolves to an equivalent pod selector.

This is an alternative to setting the --selector or --host options.

PlatformsKubernetes
See alsoKubernetes workloads

--selector

<string>

A Kubernetes label selector for specifying target server pods. It uses <label-name>=<label-value> syntax.

This is an alternative to setting the --workload or --host options.

Default

app=[value-of-name]

PlatformsKubernetes
UpdatableTrue
See alsoKubernetes label selectors

--host

<string>

The hostname or IP address of the server. This is an alternative to selector for specifying the target server.

This is an alternative to setting the --selector or --workload options.

Default

On Kubernetes: Value of name
On Docker, Podman, and Linux: localhost

UpdatableTrue

--wait

<status>

Wait for the given status before exiting.

Default

ready

Choices
none

Do not wait.

configured

Wait until the configuration is applied.

ready

Wait until the resource is ready to use.

PlatformsKubernetes

--timeout

<duration>

Raise an error if the operation does not complete in the given period of time.

Default

60s

PlatformsKubernetes
See alsoDuration format

Global options