LTX-Video-FastAPI/docker-compose.yml at deploy/docker · fjyu95/LTX-Video-FastAPI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# docker-compose.yml
# ============================
# docker-compose config | grep 'image:' # 查看镜像名称
# docker-compose build # 构建镜像
# docker-compose images # 确认已构建的镜像名称
# docker-compose down --volumes --remove-orphans # 清理旧容器和数据卷,Optional
# docker-compose down --volumes --remove-orphans && docker-compose up # 前台启动,方便调试
# docker-compose up -d # 后台启动容器
# docker-compose logs -f # 实时滚动查看日志
# docker-compose logs -f -t --tail=50 # 实时追踪最后 50 行并显示时间戳
# docker logs -f ltx-fastapi # 查看指定容器日志
# docker-compose down # 停止并删除容器 (不会删除镜像和数据卷)
# docker-compose run --rm ltx-fastapi bash # 进入容器交互式终端调试, 默认用户 root
# docker-compose run --rm -u zuser ltx-fastapi bash
# docker-compose exec -u zuser ltx-fastapi bash # 进入运行中容器交互式调试
# ============================

version: "3.8"

services:
  ltx-fastapi:
    build: .
    image: ltx-fastapi:v0.1
    # container_name: ltx
    user: "1000:1000"
    # restart: unless-stopped
    restart: always # 核心：容器挂了会自动重启
    # host 网络模式，简单高效, 不需要端口映射
    network_mode: host
    # ports:
    #   - "8003:8003"
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"

    # GPU配置, 只在 Docker Swarm 模式下生效
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all # 允许容器访问所有 GPU
              capabilities: [ gpu ]

    # 或者更简单（Docker 20.10+）
    # gpus: all

    # 大的内存共享
    # shm_size: '16gb'

    # 环境变量
    env_file:
      - .env

    environment:
      - HF_ENDPOINT=https://hf-mirror.com
      # 强制覆盖 .env 中的模型路径，指向容器内部挂载点
      # - MODEL_PATH=/app/ckpts/Z-Image-Turbo
      # 可选：限制卡
      # - CUDA_VISIBLE_DEVICES=0,1

    ulimits:
      nofile:
        soft: 65535
        hard: 65535

    volumes:
      # 容器中HF的默认地址没有修改过，还是 ~/.cache/huggingface
      - /data/huggingface:/home/zuser/.cache/huggingface
      - ./generated_videos:/app/generated_videos
      # 日志（如果你有）
      # - ./logs:/app/logs

      # 开发模式：挂载代码目录，实时同步更新
      # - ./run_server.py:/app/run_server.py:ro
      # - ./ltx-video_api.py:/app/ltx-video_api.py:ro

      # 覆盖容器启动的默认命令, for debugging
      # command: [ "python3", "-u", "run_server.py" ]