cloudflare-workers/_templates/cloudflare/worker-go

worker-template-go

• A template for starting a Cloudflare Worker project with Go.
• This template uses workers package to run an HTTP server.

Notice

• A free plan Cloudflare Workers only accepts ~1MB sized workers.
  • Go Wasm binaries easily exceeds this limit, so you'll need to use a paid plan of Cloudflare Workers (which accepts ~5MB sized workers).

Usage

• main.go includes simple HTTP server implementation. Feel free to edit this code and implement your own HTTP server.

Requirements

• Node.js
• wrangler
  • just run npm install -g wrangler
• Go

Getting Started

wrangler generate my-app syumai/workers/_templates/cloudflare/worker-go
cd my-app
go mod init
go mod tidy
make dev # start running dev server
curl http://localhost:8787/hello # outputs "Hello!"

• To change worker name, please edit name property in wrangler.toml.

Development

Commands

make dev     # run dev server
make build   # build Go Wasm binary
make deploy # deploy worker

Testing dev server

• Just send HTTP request using some tools like curl.

$ curl http://localhost:8787/hello
Hello!

$ curl -X POST -d "test message" http://localhost:8787/echo
test message