Listener create command
Create a listener.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| Waits for | Configured |
Usage
skupper listener create <name> <port> [options]
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>
The name of the resource to be created.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
<port>
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, Podman, Linux |
|---|
--routing-key
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, Podman, Linux |
| See also | Routing key concept |
--host
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, Podman, Linux |
--wait
Wait for the given status before exiting.
| Default |
| ||||||
|---|---|---|---|---|---|---|---|
| Choices |
| ||||||
| Platforms | Kubernetes, Docker, Podman, Linux |
--timeout
Raise an error if the operation does not complete in the given period of time.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Duration format |
--tls-credentials
A named bundle of TLS certificates and keys used for secure application-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.
This option is used when setting up client-to-router TLS authentication and encryption.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| See also | Site-scoped TLS, Kubernetes TLS secrets |
Global options
--context
Set the kubeconfig context.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--kubeconfig
Set the path to the kubeconfig file.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes kubeconfigs |
--namespace
Set the namespace.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| See also | Kubernetes namespaces |
--platform
Set the Skupper platform.
| Default |
| ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Choices |
| ||||||||
| Platforms | Kubernetes, Docker, Podman, Linux | ||||||||
| See also | Platform concept |
--help
Display help and exit.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|