v0.25.0rc0
Pre-release
Pre-release
curquiza
released this
07 Dec 16:48
·
41 commits
to release-v0.25.0
since this release
This version of MeiliSearch introduces a much requested feature: API key management.
For more information on how to update to the latest version of MeiliSearch, read our dedicated guide.
Breaking changes
API Key management
This new feature allows you to manage and restrict the access of API Keys.
It also involves breaking changes to how keys are handled curently:
public
andprivate
keys do not exist anymore and are replaced by two default API Keys:Default Search API Key
andDefault Admin API Key
. They are automatically generated when you first launch MeiliSearch with amaster-key
.
🚨 If you are upgrading from a version prior tov0.25.0
, you will need to update your code to replace the previouspublic
andprivate
API keys with the newly generated keys to communicate with MeiliSearch.- The
X-MEILI-API-KEY
header is replaced by theAuthorization: Bearer <apiKey>
header. - API Key object lists are now returned in a
results
array. - Added management of API Keys via the endpoint
/keys
for the master-key holder.- Keys can be created/updated/deleted/listed and fetched.
- Keys can be restricted to certain actions on specific indexes.
- Keys can expire at a defined time.
Task API
To improve user understanding and experience, we refashioned MeiliSearch's asynchronous updates:
- The
update
resource has been renamed totask
. The names of existing API routes have also been updated to reflect this change. GET - /indexes/:indexUid/updates
andGET - /indexes/:indexUid/updates/:updateId
are updated to/indexes/:indexUid/tasks
and/indexes/:indexUid/tasks/:taskUid
.- Tasks are accessible as a resource independent of index
GET - /tasks
GET - /tasks/:taskUid
- The task
uid
is incremented globally and not by index. - The
task_not_found
error has been introduced. - The format of the
task
object has been updated.updateId
is nowuid
.status
values are updated. Possible values are:enqueued
,processing
,succeeded
,failed
.type
is no longer an object. It is now a string containing the values previously held in the now-outdatedtype.name
field.- The
type
field values have been updated to be more clear and consistent with our naming rules. Possible values are:indexCreation
,indexUpdate
,indexDeletion
,documentsAddition
,documentsPartial
,documentsDeletion
,settingsUpdate
,clearAll
. - A
details
object is added to contain specific information related to atask
payload. This was previously displayed in thetype
object. - An
indexUid
field is added containing the name of the index where the task is performed. startedProcessingAt
is updated tostartedAt
.processedAt
is updated tofinishedAt
.duration
,startedAt
, andprocessedAt
now useISO 8601
format.
202 Accepted
responses previously returning anupdateId
now return a summarizedtask
object.- The
MEILI_MAX_UDB_SIZE
environment variable is renamed toMEILI_MAX_TASK_DB_SIZE
. - The
--max-udb-size
CLI option is renamed to--max-task-db-size
. task
object lists are now returned under aresults
array with the most recenttask
object displayed first.
Other breaking changes
- Creating, updating, and deleting indexes are now asynchronous operations. This removes potential race conditions that existed before. @MarinPostma
- MeiliSearch v0.25 and subsequent releases are not compatible with dumps created prior to v0.22.
- To migrate a dump from pre-v0.22 to v0.25 MeiliSearch, first load your dump into v0.24.0, create a dump using v0.24.0, and then import this dump into v0.25.0.
Improvements
matches
now works with numerical values (#1893) @Thearas- New errors:
missing_parameter
,invalid_api_key_description
,invalid_api_key_actions
,invalid_api_key_indexes
,invalid_api_key_expires_at
,api_key_not_found
. - Add MeiliSearch ARM image for Docker (#1897) @curquiza
- Improve error messages on filter parsing (meilisearch/milli#400) @irevoire
- Improve Hangul Tokenization (meilisearch/charabia#60) @datamaker
- Improve tokenization: get size of char after normalization (meilisearch/charabia#59) @Samyak2
Fixes
- Accept charset in the Content-Type header (#1933) @Kerollmops
- Fix phrase search that does not match documents as expected (meilisearch/milli#419) @ManyTheFish
- Fix indexes being deleted when
data.ms
is not compatible with a MeiliSearch version (#1965) @irevoire - Fix Snapshot file permissions (#1960) @MarinPostma
- Fix download-latest.sh (#1976) @Mcdostone
Misc
- Remove email address from the launch message (#1896) @curquiza
- Remove release drafter workflow (#1882) @curquiza
- Remove Hacktoberfest section from CONTRIBUTING.md (#1884) @meili-bot
- Telemetry changes (#1938, #1939, #1941, #1942, #1947) @irevoire
❤️ Thanks again to our external contributors:
- MeiliSearch: @Mcdostone and @Thearas
- Tokenizer: @datamaker and @Samyak2