Connector create command
Create a connector.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|---|
| Waits for | Configured |
Usage
skupper connector create <name> <port> [options]
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=backend
# Use the workload option to select pods
$ skupper connector create backend 8080 --workload deployment/backend
Primary options
<name>
The name of the resource to be created.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
<port>
The port on the target workload to forward traffic to.
| Platforms | Kubernetes, Docker, Podman, Linux |
|---|
--routing-key
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 |
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
| See also | Routing key concept |
--selector
A Kubernetes label selector for specifying target server pods.
On Kubernetes, you usually want to use this. As an alternative,
you can use host.
| Default |
|
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--workload
A Kubernetes resource name that identifies a workload. It resolves to an equivalent pod selector.
This is an alternative to setting the --selector or
--host options.
| Platforms | Kubernetes |
|---|---|
| See also | Kubernetes workloads |
--host
The hostname or IP address of the server. This is an
alternative to selector for specifying the target server.
| 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 |
--include-not-ready
If set, include server pods that are not in the ready state.
| Default | False |
|---|---|
| Platforms | Kubernetes, Docker, Podman, Linux |
--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 router-to-server 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 |
|---|