Listener create command

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

Create a listener.

PlatformsKubernetes, Docker, Podman, Linux
Waits forConfigured

Examples

# Create a listener for a database
$ skupper listener create database 5432
Waiting for status...
Listener "database" is configured.

# Set the routing key and host explicitly
$ skupper listener create backend 8080 --routing-key be1 --host apiserver

Primary options

<name>

string
required

The name of the resource to be created.

The name is the default routing key and host if the --routing-key and --host options are not specified.

See alsoKubernetes object names

<port>

integer
required

The port of the local listener. Clients at this site use the listener host and port to establish connections to the remote service.

UpdatableTrue

--routing-key

<string>
frequently used

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

Default

Value of name

UpdatableTrue

--host

<string>
frequently used

The hostname or IP address of the local listener. Clients at this site use the listener host and port to establish connections to the remote service.

Default

Value of name

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
See alsoResource status

--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