Sign inSign up

extenddb/extenddb-postgres

By extenddb

•Updated about 5 hours ago

DynamoDB-compatible API adapter backed by your own PostgreSQL 14+ database

Image
1

6.2K

extenddb/extenddb-postgres repository overview

⁠ExtendDB

ExtendDB is a DynamoDB-compatible API adapter that enables teams to run DynamoDB workloads on their own infrastructure, backed by a PostgreSQL database they operate.

⁠Benefits of using ExtendDB

ExtendDB works with your existing DynamoDB API calls. Any AWS SDK, CLI, or tool that talks to DynamoDB talks to ExtendDB unchanged, so you point your client at a different endpoint and nothing else about your code changes. The full surface is there: CRUD, Query, Scan, Batch, Transactions, Streams, TTL, Import and Export, plus SigV4 with IAM-compatible users, roles and policies.

It is an adapter, not a database. This image contains the ExtendDB server compiled with the PostgreSQL backend; you supply PostgreSQL 14 or newer, whether that is RDS, Aurora PostgreSQL, or self-managed. Your data therefore lives somewhere you already know how to back up, replicate, monitor and restore, using tools you already run.

Because it runs on your infrastructure, ExtendDB needs no internet connection, and there are no provisioned throughput, data storage, or data transfer costs. That makes it a fit for self-hosted and air-gapped deployments, for DynamoDB semantics on any cloud that runs PostgreSQL, and for continuous integration against a durable backend rather than an ephemeral one.

⁠Getting started with ExtendDB on Docker

For local development, the Compose stack in the repository starts PostgreSQL alongside ExtendDB and runs the one-time bootstrap for you. See local development with Docker Compose⁠.

For a real deployment the image serves three explicit operations: extenddb init once to bootstrap the database, extenddb migrate when upgrading, and extenddb serve in steady state, which is the default command. It listens on port 18443 over TLS, keeps configuration and certificates under /var/lib/extenddb, runs as a non-root user, and supports a read-only root filesystem.

To learn how to configure and operate it, see getting started⁠ and the container notes⁠.

⁠Tags and verification

Pin X.Y.Z or a digest for production; a version tag is never overwritten. latest tracks the highest release and only moves forward. Tags of the form sha-<commit> are unpromoted build candidates, not releases. Both linux/amd64 and linux/arm64 ship as one multi-architecture index.

Every published image is signed with Sigstore cosign. Releases through 0.1.14 use a committed release key, extenddb-signing.pub.pem⁠:

cosign verify --key extenddb-signing.pub.pem docker.io/extenddb/extenddb-postgres:X.Y.Z

The earliest releases, 0.1.5 and 0.1.6, predate transparency logging; add --insecure-ignore-tlog=true to verify those two.

From 0.1.15, signatures are keyless: the certificate names the GitHub Actions workflow and ref that signed the image, and no public key is needed.

cosign verify \
  --certificate-identity-regexp '^https://github\.com/ExtendDB/extenddb/\.github/workflows/(release-image|sign-image)\.yml@refs/heads/main$' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  docker.io/extenddb/extenddb-postgres:X.Y.Z

The signer identity separates tiers: routine backend releases are signed by release-image.yml and routine dev releases by release-dev-image.yml, so this pattern rejects a routinely-signed dev image. The break-glass signer sign-image.yml can sign any tier, so it is the one identity both patterns share; drop it to pin verification to the routine per-tier path. The same images and their signatures are mirrored by digest to ghcr.io/extenddb/extenddb-postgres and public.ecr.aws/extenddb/extenddb-postgres.

⁠Note

ExtendDB is an open source project maintained by AWS. It is not Amazon DynamoDB and does not contain any DynamoDB source code. It is not an AWS service. "DynamoDB" is a trademark of Amazon.com, Inc. or its affiliates. ExtendDB is a clean-room implementation that speaks the DynamoDB wire protocol; behavioral differences from the service are documented in Differences from DynamoDB⁠.

More at extenddb.org⁠ and github.com/ExtendDB/extenddb⁠. Licensed under Apache-2.0.

Tag summary

Content type

Image

Digest

sha256:b26d28659…

Size

56 MB

Last updated

about 5 hours ago

docker pull extenddb/extenddb-postgres