Tags: FerretDB/FerretDB
Tags
v2.1.0 https://github.com/FerretDB/FerretDB/releases/tag/v2.1.0 2025-04-03 This version works only with [DocumentDB v0.102.0-ferretdb-2.1.0](https://github.com/FerretDB/documentdb/releases/tag/v0.102.0-ferretdb-2.1.0). ### Breaking changes > [!CAUTION] > Please note that due to incompatibilities in our previous releases, DocumentDB can't be updated in place, > even with a manual `ALTER EXTENSION UPDATE` query or other means. > A new clean installation into an empty data directory/volume is required. > All data should be backed up with `mongodump`/`mongoexport` before and restored > with `mongorestore`/`mongoimport` after. > > We expect future updates to be much smoother. ### Fixed Bugs 🐛 - Fix version detection for embeddable package by @AlekSi in #4936 ### Enhancements 🛠 - Add colorized levels to `console` logger by @noisersup in #4904 - Improve `--help` output by @KrishnaSindhur in #4918 - Add support for reading PostgreSQL URL from a file by @KrishnaSindhur in #4937 - Do not decode incoming document twice by @AlekSi in #4981 ### Documentation 📄 - Add post on MongoDB queries and operations on FerretDB by @Fashander in #4732 - Add example telemetry report to documentation by @AlekSi in #4861 - Add FerretDB v2 GA blog post by @AlekSi in #4884 - Add full text search guide by @Fashander in #4886 - Add guide for GUI apps by @Fashander in #4906 - Add TTL index guide by @Fashander in #4926 - Update `deb` and `rpm` installation docs by @Fashander in #4927 - Sync flags grouping with docs by @AlekSi in #4933 - Add a note to documentation about PR titles by @AlekSi in #4944 - Update/backport full-text and TTL indexes guides by @AlekSi in #4948 - Backport documentation changes to v2.0 by @AlekSi in #4952 - Add basic documentation for supported commands by @AlekSi in #4970 - Update feature blog post by @Fashander in #4991 - Add blogpost on FerretDB v2.1.0 release by @Fashander in #5004 - Create redirects for `/v2.0/` documentation URLs by @AlekSi in #5011 ### Other Changes 🤖 - Update changelog generator by @AlekSi in #4810 - Update TODO URLs for `listDatabase` tests by @noisersup in #4863 - Document non-enforced format of log messages in `envtool` package by @noisersup in #4867 - Start working on a new release by @AlekSi in #4885 - Adjust pool connection timeout by @AlekSi in #4888 - Check issue URLs in documentation by @chilagrow in #4890 - Add TODO comments for observability tasks by @AlekSi in #4896 - Refactor `clientconn` by @chilagrow in #4907 - Add basic structure for middlewares by @AlekSi in #4908 - Make production builds of the `main` branch by @AlekSi in #4911 - Bump deps by @AlekSi in #4916 - Move message processing in `clientconn` to a function by @chilagrow in #4919 - Change the way OP_MSG handlers are invoked by @AlekSi in #4923 - Improve integration benchmarks by @AlekSi in #4925 - Configure connection pool size in tests by @AlekSi in #4932 - Update DocumentDB by @AlekSi in #4941 - Handle `OP_QUERY` in middleware using interface by @chilagrow in #4947 - Implement error middleware by @chilagrow in #4951 - Use ERROR level logging for failed tests by @AlekSi in #4974 - Update DocumentDB by @AlekSi in #4975 - Disable tracing in benchmarks for now by @AlekSi in #4980 - Update DocumentDB by @AlekSi in #4982 - Add TODOs by @AlekSi in #4986 - Partially revert middleware changes by @AlekSi in #4995 - Add more tests for error handling by @AlekSi in #4996 - Use Go 1.24.2 by @AlekSi in #5005 - Remove error middleware for now by @AlekSi in #5008 - Disable commit check for now by @AlekSi in #5012 [All closed issues and pull requests](https://github.com/FerretDB/FerretDB/milestone/72?closed=1). [All commits](v2.0.0...v2.1.0).
v2.0.0 https://github.com/FerretDB/FerretDB/releases/tag/v2.0.0 2025-03-05 The first generally available release of FerretDB v2, powered by [DocumentDB PostgreSQL extension](https://github.com/microsoft/documentdb)! This version works best with [DocumentDB v0.102.0-ferretdb-2.0.0](https://github.com/FerretDB/documentdb/releases/tag/v0.102.0-ferretdb-2.0.0). ### Documentation 📄 - Add migration guide from v1.x to v2.x by @Fashander in #4850 - Add basic troubleshooting guide by @Fashander in #4854 - Final preparations by @AlekSi in #4874 ### Other Changes 🤖 - Unskip tests that refer to closed issue by @AlekSi in #4865 - Use GitHub-hosted CI runners by @AlekSi in #4866 - Skip flaky `currentOp` test and add TODO by @chilagrow in #4872 - Bump Go and safe deps by @AlekSi in #4875 [All closed issues and pull requests](https://github.com/FerretDB/FerretDB/milestone/69?closed=1). [All commits](v2.0.0-rc.5...v2.0.0).
v2.0.0-rc.5 https://github.com/FerretDB/FerretDB/releases/tag/v2.0.0-rc.5 2025-03-04 This is the final release candidate before the GA release tomorrow! Most users don't need to update. This version works best with [DocumentDB v0.102.0-ferretdb-2.0.0-rc.5](https://github.com/FerretDB/documentdb/releases/tag/v0.102.0-ferretdb-2.0.0-rc.5). ### New Features 🎉 - Use DocumentDB API for `listDatabases` by @AlekSi in #4841 - Implement `currentOp` command by @chilagrow in #4855 ### Fixed Bugs 🐛 - Make Data API work without authentication if requested by @AlekSi in #4849 ### Enhancements 🛠 - Publish build info, state, and CLI flags in expvar by @AlekSi in #4837 - Enforce log messages format in development builds by @noisersup in #4754 - Filter out sensitive information from debug archive by @AlekSi in #4836 - Improve messages about DocumentDB version by @AlekSi in #4832 ### Documentation 📄 - Move comment in docs to fix DocCard by @AlekSi in #4845 - Update URL to join Slack by @AlekSi in #4851 - Recommend using full tags/versions by @Fashander in #4834 ### Other Changes 🤖 - Change `dbStats` tests TODO links by @noisersup in #4823 - Update TODO comment by @AlekSi in #4831 - Bump DocumentDB for development by @AlekSi in #4839 - Update DocumentDB Docker image by @chilagrow in #4853 - Remove old code for tracking operations by @AlekSi in #4842 - Remove DocumentDB building from this repo by @chilagrow in #4852 [All closed issues and pull requests](https://github.com/FerretDB/FerretDB/milestone/71?closed=1). [All commits](v2.0.0-rc.2...v2.0.0-rc.5).
v2.0.0-rc.2 https://github.com/FerretDB/FerretDB/releases/tag/v2.0.0-rc.2 2025-02-25 This version works best with [DocumentDB v0.102.0-ferretdb-2.0.0-rc.2](https://github.com/FerretDB/documentdb/releases/tag/v0.102.0-ferretdb-2.0.0-rc.2). ### Breaking changes The `:latest` Docker image tag now points to this release. It is highly recommended always to specify the full version (like `:2.0.0-rc.1`). ### What's Changed #### Docker images Docker images are again available on [Docker Hub](https://hub.docker.com/r/ferretdb/ferretdb) and [quay.io](https://quay.io/repository/ferretdb/ferretdb) (although we recommend using [GitHub Packages](https://github.com/ferretdb/FerretDB/pkgs/container/ferretdb)). #### Embeddable Go package Once again, FerretDB can be used as a [Go library](https://pkg.go.dev/github.com/FerretDB/FerretDB/v2/ferretdb). #### `.deb` packages for DocumentDB `.deb` packages for DocumentDB are now available [there](https://github.com/FerretDB/documentdb/releases). #### Indexes Multiple issues with indexes were resolved, and support for TTL indexes was added. After updating DocumentDB and FerretDB, rebuilding indexes using the `reIndex` command is recommended. ### New Features 🎉 - Update Docker tags by @AlekSi in #4812 - Enable Docker Hub and quay.io by @AlekSi in #4815 - Re-introduce embeddable package by @AlekSi in #4778 - Make embeddable package logging configurable by @AlekSi in #4807 - Implement `reIndex` command by @chilagrow in #4735 - Implement `dbStats` command by @noisersup in #4804 - Add `mongo` slog format by @noisersup in #4716 - Enable building FerretDB as PostgreSQL background worker by @AlekSi in #4802 ### Enhancements 🛠 - Set `GOARM64` explicitly by @AlekSi in #4760 - Tweak CLI for disabling interfaces by @AlekSi in #4781 ### Documentation 📄 - Add replication blog post by @Fashander in #4717 - Add explicit `platform: linux/amd64` to docs by @AlekSi in #4749 - Add missing space in command by @tlinhart in #4753 - Update config flags by @Fashander in #4740 - Update TLS docs by @Fashander in #4752 - Use `/` consistently in MongoDB URIs by @AlekSi in #4759 - Reformat request/response `.js` files by @AlekSi in #4787 - Update Docker image tag in v1 docs by @AlekSi in #4796 - Convert `json5` to `js` responses in docs by @Fashander in #4800 - Tweak Docusaurus configuration by @AlekSi in #4805 - Update release checklist and `.deb` installation guide by @chilagrow in #4767 - Update blogs to use `js` instead of `json5` by @Fashander in #4801 ### Other Changes 🤖 - Disable xfail CI configuration for now by @AlekSi in #4698 - Skip private issue links in `checkcomments` by a flag by @chilagrow in #4695 - Fix Dependabot config by @AlekSi in #4708 - Fix error mapping generation by @noisersup in #4691 - Do not use Git LFS for Go files by @AlekSi in #4713 - Refactor extract and convert in `genwrap` tool by @chilagrow in #4703 - Introduce smoke test for Data API by @noisersup in #4712 - Do not use a global variable for logging by @AlekSi in #4727 - Bump deps by @AlekSi in #4743 - Refactor and generate using `genwrap` tool by @chilagrow in #4705 - Check DocumentDB issues in `checkcomments` and `checkdocs` by @chilagrow in #4714 - Use `wireclient` for readiness probe by @chilagrow in #4718 - Remove "all backends" from the issue template by @AlekSi in #4751 - Add/update TODO comments for some issues by @AlekSi in #4723 - Remove `golang.org/x/exp/maps` package by @AlekSi in #4711 - Use Go 1.24.0 by @AlekSi in #4775 - Use directories instead of files for state and telemetry by @AlekSi in #4784 - Update DocumentDB by @AlekSi in #4788 - Make handler take over the pool by @AlekSi in #4795 - Add test helper by @AlekSi in #4799 - Bump Go deps by @AlekSi in #4803 - Fix `envtool` for Go 1.24 by @AlekSi in #4809 - Update DocumentDB by @AlekSi in #4811 ### New Contributors - @tlinhart made their first contribution in #4753 All closed issues and pull requests: https://github.com/FerretDB/FerretDB/milestone/70?closed=1 All commits: v2.0.0-rc.1...v2.0.0-rc.2
v1.24.0 https://github.com/FerretDB/FerretDB/releases/tag/v1.24.0 2024-08-28 ### What's Changed #### Embeddable package As communicated in the previous release, this version renames the `SLogger` field to `Logger`, finishing the migration from [`zap`](https://github.com/uber-go/zap) to [`slog`](https://pkg.go.dev/log/slog). ### Fixed Bugs 🐛 - Ignore Stable API fields by @Evengard in #4067 - Fix Docker's `HEALTHCHECK` in production image by @dasjoe in #4547 - Remove duplicate response field on `OP_QUERY` `hello` by @chilagrow in #4549 - Fix `OP_QUERY` `saslStart` and `saslContinue` for C# driver by @chilagrow in #4550 - Fix `saslContinue` completing handshake too early by @chilagrow in #4552 ### Documentation 📄 - Fix Terser plugin build error by @nalgeon in #4506 - Enable zoom on images by @Fashander in #4508 - Add blog post on building a RESTful API with Deno by @Fashander in #4517 - Update missing image by @Fashander in #4522 - Fix broken links by @Fashander in #4525 - Fix critical typo i 8000 n telemetry documentation by @AlekSi in #4536 - Bump Docusaurus by @AlekSi in #4544 - Added Elestio as one-click deploy option by @kaiwalyakoparkar in #4546 - Add docs for new authentication by @Fashander in #4557 ### Other Changes 🤖 - Implement our own changelog generator by @vigneshsankariyer1234567890 in #4219 - Add open issues check in `checkdocs` by @kropidlowsky in #4258 - Prototype OTel context propagation by @rumyantseva in #4483 - Cleanup logging by @chilagrow in #4489 - Use `wire` and `wirebson` packages by @chilagrow in #4490 - Alignment and Bugfixes for SAP HANA backend by @yonarw in #4491 - Port small things from v2 by @AlekSi in #4495 - Bump deps by @AlekSi in #4496 - Remove `zap` remnants by @AlekSi in #4497 - Update `listDatabases` integration test filter input by @chilagrow in #4499 - Update duplicate field handling by @chilagrow in #4500 - Convert BSON values of `wirebson` to `types` by @chilagrow in #4501 - Use `wireclient` package by @chilagrow in #4502 - Fix log message by @chilagrow in #4503 - Fix `checkdocs` Github cache on CI by @noisersup in #4509 - Document logging changes by @AlekSi in #4510 - Fix CI for documentation preview by @AlekSi in #4518 - Add `Taskfile` target to `pngcrush` all new images by @AlekSi in #4519 - Remove fuzzing by @chilagrow in #4520 - Use Go 1.22.6 by @AlekSi in #4523 - Minor cleanup by @AlekSi in #4535 - Use `wireclient` login function in integration test by @chilagrow in #4538 - Remove `wireconn` tests for now by @AlekSi in #4548 - Pass `GITHUB_TOKEN` to tools tests by @AlekSi in #4558 ### New Contributors - @nalgeon made their first contribution in #4506 - @Evengard made their first contribution in #4067 - @dasjoe made their first contribution in #4547 - @kaiwalyakoparkar made their first contribution in #4546 - @vigneshsankariyer1234567890 made their first contribution in #4219 All closed issues and pull requests: https://github.com/FerretDB/FerretDB/milestone/66?closed=1 All commits: v1.23.1...v1.24.0
v1.23.1 https://github.com/FerretDB/FerretDB/releases/tag/v1.23.1 2024-08-13 ### Fixed Bugs 🐛 - Fix building with `go build -trimpath` by @AlekSi in #4526 All closed issues and pull requests: https://github.com/FerretDB/FerretDB/milestone/67?closed=1 All commits: v1.23.0...v1.23.1
v1.23.0 https://github.com/FerretDB/FerretDB/releases/tag/v1.23.0 2024-07-25 ### What's Changed #### Embeddable package This release switches from the [`zap` logging package](https://github.com/uber-go/zap) to the standard [`slog`](https://pkg.go.dev/log/slog). If the logger was configured by Go programs that import [`github.com/FerretDB/FerretDB/ferretdb` package](https://pkg.go.dev/github.com/FerretDB/FerretDB/ferretdb), they should configure the `SLogger` field instead. Setting the old `Logger` field will make the program panic and make the issue immediately noticeable. The next release will completely remove `zap` and rename `SLogger` to just `Logger`. #### Initial OpenTelemetry tracing support This release adds initial support for sending OpenTelemetry traces to the OTLP endpoint. The set of spans and their attributes is not stable yet and will change over time. All improvements in observability in this release (OpenTelemetry traces, Kubernetes probes, debug archive) are documented [there](https://docs.ferretdb.io/configuration/observability/). #### Experimental Systemd configuration in `.deb` and `.rpm` packages This release adds initial unit files for `systemd` that auto-start FerretDB. They are likely to change in the future in incompatible ways; for example, we may switch to using a non-root user. ### New Features 🎉 - Add Kubernetes liveness probe by @noisersup in #4378 - Add Kubernetes readiness probe by @noisersup in #4426 - Implement Docker healthcheck by @noisersup in #4364 - Add OpenTelemetry traces and spans by @AlekSi in #4477 - Send OpenTelemetry traces and spans to OTLP endpoint by @AlekSi in #4484 - Implement `/debug/archive` handler by @sachinpuranik in #3895 - Provide systemd unit file in `.deb` and `.rpm` packages by @noisersup in #4478 ### Enhancements 🛠 - Improve support for named loggers by @AlekSi in #4432 ### Documentation 📄 - Document Kubernetes probes by @AlekSi in #4424 - Refactor and document `/debug/archive` handler by @AlekSi in #4485 - Document logging by @AlekSi in #4436 - Add release blog post for FerretDB v.1.22.0 by @Fashander in #4401 - Add blog post on running FerretDB and CloudNativePG on Kubernetes by @Fashander in #4377 - Add blogpost on "monitoring FerretDB performance using Coroot" by @Fashander in #4279 - Crush `.png` images by @AlekSi in #4441 - Remove broken links by @AlekSi in #4433 ### Other Changes 🤖 - Replace deprecated syntax in Dockerfiles by @AlekSi in #4397 - Update comments about interfaces by @AlekSi in #4405 - Check database name for authentication by @chilagrow in #4402 - Refactor runnables by @AlekSi in #4404 - Add tests for `ctxutil.Sigterm` by @AlekSi in #4406 - Setup OpenTelemetry exporter for FerretDB by @rumyantseva in #4380 - Extract `types` and `zap` code into separate files by @AlekSi in #4408 - Bump Go and deps by @AlekSi in #4416 - Implement Kubernetes startup probe by @noisersup in #4399 - Disable OTEL in tests where collection name might have non-UTF-8 symbols by @rumyantseva in #4423 - Stop Otel exporter gracefully in `envtool` by @AlekSi in #4425 - Include `OpReply` error handling by @chilagrow in #4420 - Test `authSource` by @chilagrow in #4407 - Return `connectionStatus` command `db` field by @chilagrow in #4419 - Implement checkswitch to handle regular switches by @PaveenV in #4381 - Cleanup `checkswitch` handling by @chilagrow in #4434 - Bump deps by @AlekSi in #4446 - Ignore `$readPreferences` for `insert` by @AlekSi in #4440 - Readiness probe cleanup by @noisersup in #4447 - Update linters configuration by @AlekSi in #4451 - Add support for named `slog` loggers by @chilagrow in #4435 - Increase setup timeout in tests by @AlekSi in #4454 - Port pgx logger by @AlekSi in #4450 - Handle `authSource` in low level driver by @chilagrow in #4449 - Use single definition of order for `checkswitch` by @chilagrow in #4452 - Clarify the meaning of the passed context by @AlekSi in #4455 - Remove `FuncCall` by @AlekSi in #4476 - Use `slog` in `clientconn` package by @chilagrow in #4457 - Use `slog` in `postgresql` backend by @chilagrow in #4466 - Use `slog` in `sqlite` backend by @chilagrow in #4467 - Use `slog` in `mysql` and `hana` backends by @chilagrow in #4463 - Use `slog` in `oplog` and `cursor` packages by @chilagrow in #4471 - Use `slog` in `otel` by @chilagrow in #4474 - Use `slog` in `debug` package by @chilagrow in #4473 - Use `slog` in integration tests by @chilagrow in #4481 - Use `slog` in `main.go` and embedded `ferretdb` package by @chilagrow in #4462 - Use `slog` in `fsql` by @chilagrow in #4464 - Use `slog` in handler by @chilagrow in #4470 - Use `slog` in envtool by @chilagrow in #4480 - Implement `slog.LogValuer` interface for `types` package by @chilagrow in #4479 - Drop old dependency by @AlekSi in #4486 - Cleanup logging by @chilagrow in #4489 ### New Contributors - @PaveenV made their first contribution in #4381 All closed issues and pull requests: https://github.com/FerretDB/FerretDB/milestone/65?closed=1 All commits: v1.22.0...v1.23.0
PreviousNext