View on Github

 In this example, we deploy a dockerized model for infinity embedding server, a high-throughput, low-latency REST API server for serving vector embeddings.

​
Setting up the config.yaml

To deploy a dockerized model, all you need is a config.yaml. It specifies how to build your Docker image, start the server, and manage resources. Let’s break down each section.

​
Base Image

Sets the foundational Docker image to a lightweight Python 3.11 environment.
config.yaml
base_image:
  image: python:3.11-slim

​
Docker Server Configuration

Configures the server’s startup command, health check endpoints, prediction endpoint, and the port on which the server will run.
config.yaml
docker_server:
  start_command: sh -c "HF_TOKEN=$(cat /secrets/hf_access_token) infinity_emb v2 --batch-size 64 --model-id BAAI/bge-small-en-v1.5 --revision main"
  readiness_endpoint: /health
  liveness_endpoint: /health
  predict_endpoint: /embeddings
  server_port: 7997

​
Build Commands (Optional)

Pre-downloads model weights during the build phase to ensure the model is ready at container startup.
config.yaml
build_commands: # optional step to download the weights of the model into the image
  - sh -c "HF_TOKEN=$(cat /secrets/hf_access_token) infinity_emb v2 --preload-only --no-model-warmup --model-id BAAI/bge-small-en-v1.5 --revision main"

​
Configure resources

Note that we need an L4 to run this model.
config.yaml
resources:
  accelerator: L4
  use_gpu: true

​
Requirements

Lists the Python package dependencies required for the infinity embedding server.
config.yaml
requirements:
  - infinity-emb[all]==0.0.72

​
Runtime Settings

Sets the server to handle up to 40 concurrent inferences to manage load efficiently.
config.yaml
runtime:
  predict_concurrency: 40

​
Environment Variables

Defines essential environment variables including the Hugging Face access token, request batch size, queue size limit, and a flag to disable tracking.
config.yaml
environment_variables:
  hf_access_token: null
  # constrain api to at most 256 sentences per request, for better load-balancing
  INFINITY_MAX_CLIENT_BATCH_SIZE: 256
  # constrain model to a max backpressure of INFINITY_MAX_CLIENT_BATCH_SIZE * predict_concurrency = 10241 requests
  INFINITY_QUEUE_SIZE: 10241
  DO_NOT_TRACK: 1

​
Deploy dockerized model

Deploy the model like you would other Trusses, with: 
truss push infinity-embedding-server --publish