Deploy a worker

​

Container example

FROM python:3.12-slim

WORKDIR /app
RUN python -m pip install --no-cache-dir papermap-air==0.1.0
COPY tools.py /app/tools.py

CMD ["air", "worker", "start", "--module", "tools"]

AIR_BASE_URL=https://dev.airapi.papermap.ai
AIR_WORKER_KEY=<from-your-secret-manager>
AIR_WORKER_ENV=staging
AIR_WORKER_CLAIM_TIMEOUT=5

​

Kubernetes secret reference

env:
  - name: AIR_BASE_URL
    value: https://dev.airapi.papermap.ai
  - name: AIR_WORKER_KEY
    valueFrom:
      secretKeyRef:
        name: air-worker
        key: worker-key
  - name: AIR_WORKER_ENV
    value: staging

​

Operational checklist

• Pin the SDK version and test upgrades before rollout.
• Give staging and production separate worker keys.
• Give the worker’s database identity the minimum required permissions.
• Let the process receive SIGTERM; the CLI stops claiming work and closes its connections.
• Start with one staging replica and scale after observing tool latency and throughput.
• Rotate a key by deploying the new value, confirming reconnection, and revoking the old key.
• Monitor registration, task failure, lease loss, and downstream timeouts.