Learn about Fastly Compute with Fanout using a basic starter that demonstrates basic Fanout handlers.
For more details about this and other starter kits for Compute, see the Fastly Documentation Hub.
The app expects a configured backend named "self" that points back to app itself. For example, if the service has a domain foo.edgecompute.app
, then you'll need to create a backend on the service named "self" with the destination host set to foo.edgecompute.app
and port 443. Also set 'Override Host' to the same host value.
The app exposes the following endpoints to clients:
/ws
: bi-directional WebSocket/stream
: HTTP streaming oftext/plain
/sse
: SSE (streaming oftext/event-stream
)/response
: Long-polling
Connecting to any endpoint will subscribe the connection to channel "test". The WebSocket endpoint echos back any messages it receives from the client.
Data can be sent to the connections via the GRIP publish endpoint at https://fanout.fastly.com/{service-id}/publish/
. For example, here's a curl command to send a WebSocket message:
curl \
--user {service-id}:{secret} \
-d '{"items":[{"channel":"test","formats":{"ws-message":{"content":"hello"}}}]}' \
https://fanout.fastly.com/{service-id}/publish/
For each call, the app is actually invoked twice.
-
Initially, a client request arrives at the app without having been routed through the Fanout proxy yet. The app checks for this via the presence of a
Grip-Sig
header. If that header is not present, the app callsreq.handoff_fanout("self")
and exits. This tells the subsystem that the connection should be routed through Fanout, and is used for HTTP requests controlled by GRIP. -
Since
self
refers to the same app, a second request is made to the same app, this time coming through Fanout. The app checks for this, and then handles the request accordingly (inhandle()
).
This app is not currently supported in Fastly's local development server, as the development server does not support Fanout features. To experiment with Fanout, you will need to publish this project to your Fastly Compute service. using the fastly compute publish
command.
Please see SECURITY.md for guidance on reporting security-related issues.