Listener create command

Create a listener.

Usage

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

Output

Waiting for status...
Listener "<name>" is ready.

Examples

# Create a listener for a database
skupper listener create database 5432

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

# Produce YAML output
skupper listener create backend 8080 --output yaml

Options

• name string, required

  The name of the resource to be created.

  Platforms	Kubernetes, Docker
  See also	Kubernetes object names

• --output string

  Print the resource to the console in a structured output format instead of submitting it to the Skupper controller.

  Choices	json Produce JSON output yaml Produce YAML output
  Platforms	Kubernetes, Docker

• --timeout string (duration)

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

  Default	60s
  Platforms	Kubernetes, Docker

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

  Platforms	Kubernetes, Docker

• --routing-key string

  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
  Platforms	Kubernetes, Docker
  See also	Routing key concept

• --host string

  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
  Platforms	Kubernetes, Docker

• --tls-secret string

  The name of a Kubernetes secret containing TLS credentials. The secret contains the trusted server certificate (typically a CA).

  It can optionally include a client certificate and key for mutual TLS.

  This option is used when setting up router-to-server TLS encryption.

  Platforms	Kubernetes, Docker
  See also	Site-scoped TLS

• --type string

  The listener type.

  Default	tcp
  Platforms	Kubernetes, Docker

• --namespace string

  Set the namespace.

  Platforms	Kubernetes, Docker
  See also	Namespace concept, Kubernetes namespaces

• --context string

  Set the kubeconfig context.

  Platforms	Kubernetes
  See also	Kubernetes kubeconfigs

• --kubeconfig string

  Set the path to the kubeconfig file.

  Platforms	Kubernetes
  See also	Kubernetes kubeconfigs

• --platform string

  Set the Skupper platform.

  Choices	kubernetes Kubernetes docker Docker or Podman
  Platforms	Kubernetes, Docker
  See also	Platform concept

• --help

  Display help and exit.

  Platforms	Kubernetes, Docker