Sign inSign up

extenddb/extenddb-mongodb

By extenddb

•Updated about 7 hours ago

DynamoDB-compatible API adapter backed by your own MongoDB 7+ replica set

Image
0

2.1K

extenddb/extenddb-mongodb repository overview

⁠ExtendDB with MongoDB

ExtendDB is a DynamoDB-compatible API server backed by your MongoDB deployment. This image contains ExtendDB only; MongoDB is a separate service that you choose and operate, including MongoDB Atlas or a self-managed replica set.

⁠Quick start

The MongoDB backend requires MongoDB 7.0 or newer configured as a replica set. Transactions and change streams are used by the backend, so a standalone MongoDB server is not sufficient.

Pull the image:

docker pull docker.io/extenddb/extenddb-mongodb:latest

Create a writable configuration directory and initialize it against your MongoDB deployment:

mkdir -p ./extenddb-data
cat > ./extenddb-data/extenddb.toml <<'EOF'
[storage]
backend = "mongodb"

[storage.mongodb]
connection_string = "mongodb://mongodb.example.com:27017/?replicaSet=rs0"
EOF

docker run --rm \
  -v "$PWD/extenddb-data:/var/lib/extenddb" \
  docker.io/extenddb/extenddb-mongodb:latest \
  init --backend mongodb \
  --config /var/lib/extenddb/extenddb.toml \
  --overwrite \
  --bind-addr 0.0.0.0 \
  --tls-san localhost \
  --tls-san 127.0.0.1

Start the server using the generated configuration:

docker run --rm --name extenddb-mongodb \
  -p 127.0.0.1:18443:18443 \
  -v "$PWD/extenddb-data:/var/lib/extenddb" \
  --read-only \
  --tmpfs /tmp:rw,noexec,nosuid,size=64m \
  --cap-drop=ALL \
  --security-opt=no-new-privileges:true \
  docker.io/extenddb/extenddb-mongodb:latest \
  serve --config /var/lib/extenddb/extenddb.toml --foreground

The server listens on https://127.0.0.1:18443 by default. Initialization creates a self-signed certificate and the first administrator credentials; save the password printed by init.

⁠Configuration and security

Keep the MongoDB connection string in the generated configuration or provide it through the configuration mechanisms documented in the repository. Use MongoDB authentication and TLS for production deployments. The ExtendDB container runs as an unprivileged user and is designed to run with a read-only root filesystem.

For a complete deployment guide and an optional local reference stack, see docker/README-mongodb.md⁠.

⁠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, with a Rekor transparency-log entry. 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-mongodb:X.Y.Z

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-mongodb: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-mongodb and public.ecr.aws/extenddb/extenddb-mongodb.

⁠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:bf3db072f…

Size

58.9 MB

Last updated

about 7 hours ago

docker pull extenddb/extenddb-mongodb