Arkindex 1.8.1
A new Arkindex release is available.
To upgrade a development instance, follow this documentation.
To upgrade a production instance, you need to:
- Deploy this release’s Docker image:
registry.gitlab.teklia.com/arkindex/backend:1.8.1 - Run the database migrations:
docker exec ark-backend arkindex migrate - Update the system workers:
docker exec ark-backend arkindex update_system_workers
The release notes for Arkindex 1.8.1 are available here.
The main changes impacting developers and system administrators are detailed below.
Migration of worker results with worker versions¶
The link between worker versions and all worker results had been removed from all APIs in Arkindex 1.6.2, but it is still present in the Arkindex database.
In this release, in preparation for removing this link and relying exclusively on worker runs, we are providing automated migrations for old worker results that had worker versions and no worker runs.
One migration will create processes and worker runs to maintain the old links to worker versions, and subsequent migrations add new database constraints on each type of worker result to ensure they can only be created with a worker run and a worker version, or neither of those.
On large or old Arkindex instances with millions of worker results to migrate, this process can be slow and costly. Arkindex 1.8.1 can operate without these migrations being completed, so they can be performed gradually without downtime.
A new administrator command is provided to offer more flexibility in migrating existing worker results: arkindex generate_missing_worker_runs. This is equivalent to the documents.0016 Django migration. Once this command reports that there are no more worker results to migrate, the database migrations can be completed with the normal arkindex migrate command.
New Prometheus metrics¶
Alongside our existing /metrics/ URL for Arkindex-specific metrics, new Python and Django Prometheus metrics have been added at /metrics/views/ through the django-prometheus project. These new metrics can help in monitoring the performance of Arkindex endpoint by endpoint.