websockets-go

module
v0.0.0-...-c41ab0c Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 15, 2026 License: Apache-2.0

README

WebSocket - Go

A simple WebSocket server that performs the HTTP upgrade and prints log messages on all standardized WebSocket events, such as open, message, close and error. The server is written in Golang and uses the Gorilla WebSocket library.

Before you begin

  • A Kubernetes cluster with Knative installed and DNS configured. See Install Knative Serving.
  • ko or Docker installed and running on your local machine, and a Docker Hub account configured (we'll use it for a container registry).

The sample code

The server listens on port 8080 at /ws; it does not read environment variables. Knative reserves the PORT environment variable, so do not set it explicitly in the Service manifest. It echoes text and binary messages and accepts connections from any origin. This permissive origin policy is for demonstration only; restrict allowed origins before using this sample in production.

  1. In cmd/server/main.go, main registers handleWebSocket at /ws and starts the HTTP server on port 8080.
  2. In the same file, handleWebSocket upgrades the HTTP connection, calls OnOpen, and reads messages in a goroutine. Each message is passed to OnMessage; read errors invoke OnError, and the deferred OnClose closes the connection.
  3. pkg/handlers/handlers.go contains the callbacks. They log connection events and echo each message with its original text or binary message type.

Build the application

Run the build and deployment commands from code-samples/serving/websockets-go.

Dockerfile
  • If you look in the Dockerfile, you will see a method for building the Go container. You can build and push this to your registry of choice via:
# Build and push the container on your local machine.
docker buildx build --platform linux/arm64,linux/amd64 -t "<image>" --push .
ko
  • You can use ko to build and push just the image with:
ko publish ./cmd/server

However, if you use ko for the next step, this is not necessary.

Deploy the application

yaml (with Dockerfile)
  • If you look in config/service.yaml, take the <image> name you used earlier and insert it into the image: field, then run:
kubectl apply -f config/service.yaml
yaml (with ko)
  • If using ko to build and push:
ko apply -f config/service.yaml

Testing the WebSocket server

Get the URL for your Service with:

kubectl get ksvc websockets-server

For example, the Service URL might be http://websockets-server.default.svc.cluster.local (the domain depends on your cluster configuration). Change http:// to ws:// (https:// to wss:// for TLS) and append /ws to connect to the URL reported by your cluster.

Alternatively, run a container inside the cluster with the wscat CLI and use the Service's cluster-local address:

kubectl run --rm -i --tty wscat --image=monotykamary/wscat --restart=Never -- -c ws://websockets-server.default.svc.cluster.local/ws

Afterward you can chat with the WebSocket server like:

If you don't see a command prompt, try pressing enter.
Connected (press CTRL+C to quit)
> Hello
< Hello
>

Knative can scale the application based on concurrent connections. The number of pods depends on autoscaling settings and traffic, not just the number of clients.

NOTE: The autoscaling.knative.dev/target annotation controls the target concurrency used for scaling.

Directories

Path Synopsis
cmd
client command
server command
pkg

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL