Skip to content

Deployment Overview

Deployments are done through Ansible in the deploy-ai repository. Contact dcline@mbari.org with any questions and forr more detailed information about the general use of the tools and services this repository deploys, see the documentation at https://docs.mbari.org/internal/ai/.

⚙️ Installation

git clone github.com/mbari-org/deploy-ai.git
pip install ansible

🚀 Deploy a Vector Similarity Search (VSS) service

This deploys a service that provides an API for vector similarity search using a Redis based Vector database. We call this service the Vector Similarity Search (VSS) service.

The service is deployed to http://doris.shore.mbari.org:8001/docs. Select your project, then input your images for your project, and it will return perform top-n classification of your image and the most similar images exemplars database ID in the database. This service is useful for searching for rare but distinctive concepts in large datasets, but could also be used in conjunction with other services, e.g. annotation tools, AI agents. 

ansible-playbook --key-file shared_id_rsa -i environment/prod playbooks/deploy_fastapi_vss.yml

Vector database concept

vector_db_concept.png

VSS API documentation

fastapi_vss.png

🚀 Deploy an update to the annotation service API for bulk operations on Tator

This deploys the fastapi service that provides an API for bulk operations on Tator, such as bulk annotation. 

ansible-playbook --key-file shared_id_rsa -i environment/prod playbooks/deploy_fastapi_tator.yml
fastapi_tator_bulk.png

🚀 Deploy an update to the annotation tool Tator

This deploys the Tator tool to mantis.shore.mbari.org. This is a web-based annotation tool that provides a REST API for video and image annotation. 

ansible-playbook --key-file shared_id_rsa -i environment/prod playbooks/deploy_tator.yml

View of the current projects on Tator

Tator_projects.png

🚀 Deploy an update to the annotation tool Tator on a specific host drone.

Drone is used with external collaborators to verify and add new annotations for the MBARI UAV project https://drone.mbari.org. 

ansible-playbook --key-file shared_id_rsa -i environment/prod --limit drone playbooks/deploy_tator.yml
Tator_drone.png

🚀Deploy changes to the YAML configuration files for all projects

This deploys change to the documentation server at docs.mbari.org /var/www/html/internal/ai/projects/. Must be done after any changes to the aidoc repository.

ansible-playbook -v --ask-pass -i environment/prod playbooks/deploy_mkdocs_config.yml
This should prompt for the docsadm password which is needed for installation. Ask D.Cline, Carlos Rueda, or Kevin Gomes for the password which is contained in a vault. 
SSH password:

Other service deployments

  • deploy_redis_load.yml - deploys the REDIS annotation loader for real-time video annotation loads
  • deploy_tator_cron.yml - deploys bulk annotation and common operations such as database backups to run through cron
  • deploy_fastapi_tator.yml - deploys the fastapi tator api to http://mantis.shore.mbari.org:8001/docs
  • deploy_i2map.yml - deploys media annotation, model development and advanced analytics stack (database, REST API) deployed to i2map.shore.mbari.org
  • deploy_fastapi_metadetector.yml - deploys the metadetector inference API - a single class detector for midwater objects

Tip

Logs can be seen on the devops mount at smb://thalassa.shore.mbari.org/DevOps This can be useful for debugging issues with services in docker images.

🗓️ Updated: 2025-08-07