README.md

Metaserver to monitor map nodes and serve them to clients

Requirements

Install CloudFlare's wrangler and other dev dependencies using npm:

npm i

Development

Use npx wrangler dev for localhost development and for testing using Cloudflare dev tools.

curl -H "X-OM-DataVersion: 241001" -H "X-OM-AppVersion: 2024.10.22-10-Google" -H 'Accept-Language: fr-FR' http://localhost:8787/maps

Update node dependencies to their major versions

npm run upgrade

Preview on workers.dev

Use npx wrangler publish to open and test deployed worker in browser at https://meta-dev.omaps.workers.dev

Monitor Worker logs

For dev: npx wrangler tail [--format json]

For production: npx wrangler tail --env prod [--format json] or npm run logs

Deployment

All pushes to master automatically deploy prod version to https://meta.omaps.workers.dev/ and https://meta.omaps.app/

Deploy to prod manually using npx wrangler publish --env prod or this action.

Deploy to test dev version live at https://meta-dev.omaps.workers.dev/ manually using npx wrangler publish.

Known issues

• Cloudflare's free Flexible SSL certificates do not support 4-th level subdomains like a.b.example.com, so you can see strange SSL errors.
• HTTPS fetch requests from Workers are converted to HTTP ones if the target host is in the same Cloudflare zone, see here for more details.