/deploy-meilisearch

MEILISEARCH DEPLOYMENT
=======================

PREREQUISITES
    +-- Docker engine availability check
    +-- Port 7700 allocation verification
    +-- Master key generation/validation
    +-- Data volume preparation
    |
    v
DEPLOYMENT
    +-- Docker image pull (getmeili/meilisearch)
    +-- Container configuration
    +-- Volume mounting (meili_data)
    +-- Environment variable injection
    |
    v
CONFIGURATION
    +-- Index creation (czech_business_entities, agents, docs)
    +-- Filterable attributes setup
    +-- Sortable attributes setup
    +-- Search ranking rules configuration
    +-- Synonyms and stop words
    |
    v
VALIDATION
    +-- Health endpoint check (/health)
    +-- Search functionality test
    +-- Index status verification
    +-- Performance benchmark
    |
    v
INTEGRATION
    +-- Runtime config update (config/runtime.exs)
    +-- PrismaticStorageMeilisearch adapter registration
    +-- Platform connectivity confirmation
    +-- Telemetry event registration

# Deploy to development environment (Docker, default settings)
/deploy-meilisearch development

# Deploy to staging with master key
/deploy-meilisearch staging --master-key=$MEILI_MASTER_KEY

# Deploy specific version to production
/deploy-meilisearch production --version=1.6.0

# Deploy on custom port
/deploy-meilisearch development --port=7701

# Deploy without Docker (native binary)
/deploy-meilisearch development --docker=false

# Deploy latest version
/deploy-meilisearch development --version=latest

# Run health check on existing instance
curl http://localhost:7700/health
# Expected: {"status":"available"}

# Verify index configuration
curl http://localhost:7700/indexes --header "Authorization: Bearer $MEILI_MASTER_KEY"

/deploy-meilisearch [environment] [options]
    |
    v
PHASE 1: PREREQUISITES (< 5s)
    +-- Verify Docker availability (if --docker)
    +-- Check port availability (netstat/lsof)
    +-- Generate or validate master key
    +-- Prepare data volume directory
    |
    v
PHASE 2: DEPLOYMENT (< 30s)
    +-- Pull Meilisearch Docker image
    +-- Configure container environment
    +-- Start container with volume mount
    +-- Wait for startup completion
    |
    v
PHASE 3: CONFIGURATION (< 10s)
    +-- Create platform indexes
    +-- Configure filterable attributes
    +-- Set sortable attributes
    +-- Apply search ranking rules
    |
    v
PHASE 4: VALIDATION (< 5s)
    +-- Health check (/health endpoint)
    +-- Test search functionality
    +-- Verify index creation
    +-- Run performance benchmark
    |
    v
PHASE 5: INTEGRATION (< 5s)
    +-- Update runtime.exs configuration
    +-- Register with PrismaticStorageMeilisearch
    +-- Test adapter connectivity
    +-- Emit deployment telemetry event

docker run -d \
  --name meilisearch \
  -p 7700:7700 \
  -v $(pwd)/meili_data:/meili_data \
  -e MEILI_MASTER_KEY=$MEILI_MASTER_KEY \
  -e MEILI_ENV=production \
  getmeili/meilisearch:latest

# config/runtime.exs
config :prismatic_storage_meilisearch,
  url: System.get_env("MEILISEARCH_URL", "http://localhost:7700"),
  api_key: System.get_env("MEILISEARCH_API_KEY"),
  timeout: 10_000,
  pool_size: 10

# Check container status
docker ps -a | grep meilisearch

# View container logs
docker logs meilisearch

# Test direct connectivity
curl -v http://localhost:7700/health

# Test authenticated access
curl http://localhost:7700/indexes \
  --header "Authorization: Bearer $MEILI_MASTER_KEY"

# Restart container
docker restart meilisearch

# Create a custom index programmatically
{:ok, _} = PrismaticStorageMeilisearch.create_index("custom_index", %{
  primary_key: "id",
  filterable_attributes: ["category", "status"],
  sortable_attributes: ["created_at", "score"],
  ranking_rules: ["words", "typo", "proximity", "attribute", "sort", "exactness"]
})

# Bulk index documents
documents = [%{id: 1, title: "Doc 1"}, %{id: 2, title: "Doc 2"}]
{:ok, task} = PrismaticStorageMeilisearch.add_documents("custom_index", documents)

# Search with filters
{:ok, results} = PrismaticStorageMeilisearch.search("custom_index", "query",
  filter: "category = 'intelligence'",
  sort: ["created_at:desc"],
  limit: 20
)

[ ] Master key configured via secrets manager
[ ] Data volume mounted on persistent storage
[ ] Backup procedure verified
[ ] Health monitoring configured
[ ] Memory limits set (--memory flag)
[ ] Version pinned to specific release
[ ] Indexes created and verified
[ ] Search quality validated
[ ] Adapter connectivity confirmed
[ ] Telemetry events flowing

Related Commands