Skip to content

Upgrading

Updating Extralit

This guide covers the update process for Extralit across different deployment options: quickstart, Docker, and Kubernetes.

General Update Notes

  • Always backup your data before performing updates.
  • Test updates in a development environment before applying to production.
  • Check the Extralit release notes for any specific update instructions or breaking changes.
  • After updating, verify that all services are functioning correctly and that data is accessible.

Kubernetes Deployment Update

  1. Update the extralit repository code from a release version tag, e.g. v0.2.2

    git fetch origin tag v0.2.2 && git checkout tags/v0.2.2

  2. Rebuild the package, which contains the Argilla server and web interface

    First, build the argilla-frontend code

    npm install --prefix argilla-frontend
npm run build --prefix argilla-frontend

    Finally, build the wheel containing the built argilla-frontend/dist

    cp -r argilla-frontend/dist argilla-server/src/argilla_server/static
rm -rf argilla-server/dist && python -m build -s argilla-server/

  3. Rebuild the extralit Python client package

rm -rf argilla/dist && python -m build -s argilla/

  1. If using Tilt for development:

  2. Tilt will automatically detect changes and rebuild/redeploy the service.

  3. Manually trigger a rebuild using the ↻ button in the Tilt web interface if needed.

  4. For production updates without Tilt:

  5. Push the updated Docker image to your repository:

docker push {DOCKER_REPO}/argilla-server:tag
docker push {DOCKER_REPO}/extralit-server:tag
  • Apply the updated Kubernetes configuration:
kubectl apply -f examples/deployments/k8s/argilla-server-deployment.yaml -n {NAMESPACE}
kubectl apply -f examples/deployments/k8s/extralit-deployment.yaml -n {NAMESPACE}
  1. Monitor the rollout:
kubectl rollout status deployment/argilla-server-deployment -n {NAMESPACE}

 

For database schema changes:

  • Run migrations using the argilla_server CLI:
kubectl exec -it deployment/argilla-server-deployment -n {NAMESPACE} -- \
argilla_server database migrate

 

Quickstart Deployment Update

  1. Pull the latest Extralit image:
docker pull extralit/argilla-quickstart:latest
  1. Stop and remove the existing container:
docker stop extralit-quickstart
docker rm extralit-quickstart
  1. Start a new container with the updated image:
docker run -d --name extralit-quickstart -p 6900:6900 \
  -e ARGILLA_AUTH_SECRET_KEY=$(openssl rand -hex 32) \
  extralit/argilla-quickstart:latest

Docker Deployment Update

  1. Update the docker-compose.yml file with the latest Extralit image version.

  2. Pull the updated images:

docker-compose pull
  1. Restart the services with the new images:
docker-compose up -d
  1. For database schema changes, run migrations:
docker-compose exec argilla argilla_server database migrate

Powered by Swimm