pgedge / cloudflare-worker-template

Bootstrap your Cloudflare Worker to connect to a pgEdge database

Our Distributed Multi-master Postgres runs by default in a sandbox & nicely on virtual machines (VM's), containers, metal or localhost sandboxes. Peruse our CHANGELOG for a complete list of incremental improvements and fixes and, if you fancy, join our Discord Server.

Learn more about our sponsor or try our free cloud Developer Edition to setup a global managed cluster in less than 90 seconds. Also check out our Docker or K8's Helm examples.

Getting started

Node Pre-Reqs

• Use a non-root user from the command line

• Tested with Python 3.9+

  • Python 3.9 on EL8, EL9, SLE-15, & Amazon Linux 2023
  • Python 3.10 on Ubuntu 22.04
  • Python 3.11 on OSX arm64 (experimental)
  • Python 3.12 on Ubuntu 24.04 & Fedora 40 (experimental)

• optional: config password-less sudo if you want to autostart components with systemctl

• optional config password-less ssh to localhost for using localhost cluster commands

python3 -c "$(curl -fsSL https://pgedge-upstream.s3.amazonaws.com/REPO/install.py)"

Start by installling CLI on a single node (as per above) and then looking next at below examples.

Or try our Tutorials using  Virtual Machines or  Localhost Clusters.

Learn more about our featured extensions

spock - Multi-master w/ Conflict Resolution, Auto DDL and Delta Apply

snowflake-sequences - Sequences that are as unique as snowflakes

Supported Components - All the best such as pg12-17, Postgis, pgVector, Citus...

Get a feel for our powerful CLI commands

   spock - Custom configure world's best logical & multi-master Postgres extension

   localhost - Create a localhost test cluster

   cluster - Define & control a cluster of VM's or Metal

   vm - Convenience commands to manage Virtual Machines

   ace - The Anti-Chaos Engine efficiently proves your remote tables are in sync

   db - Configure and control postgres db's

   um - Update manager commands

   service - Service control commands

CLI Examples

Sandbox with latest Postgres 16, Spock & Snowflake installed into default postgres db

./pgedge install pg16 --start : install spock : install snowflake

Create database db1 owned by denis & setting up Spock & Snowflake into pg16

./pgedge setup -U denis -P secret -d db1 --pg 16

Create a cluster cl1 on localhost with two nodes, then install northwind sample app on cluster

./pgedge localhost cluster-create cl1 2 : cluster app-install cl1 northwind

Create virtual machine (node) n1 on AWS in Northen Virginia (iad) and n2 on Equinix Metal in Dallas (dfw)

./pgedge vm create aws iad n1 : vm node-create eqnx dfw n2

Create a multi-cloud cluster mach1

./pgedge vm cluster-define mach1 "aws:iad:n1, eqnx:dfw:n2"