构建 XProf Docker 映像

本文档介绍了如何使用 PyPI 中的正式版为 XProf 构建 Docker 映像。

Dockerfile

创建一个名为 Dockerfile 的文件，其中包含以下内容：

FROM python:3.12-slim

ARG XPROF_VERSION=2.21.3

ENV PYTHONUNBUFFERED=1

WORKDIR /app

RUN pip install --no-cache-dir xprof==${XPROF_VERSION}

EXPOSE 8791 50051

ENTRYPOINT ["xprof"]

CMD ["--logdir=/app/logs", "--port=8791"]

如何构建

  1. 将上述内容另存为 Dockerfile，并放在一个空目录中。

  2. 使用以下命令构建映像：

    docker build -t xprof:2.21.3 .

您可以通过修改 Dockerfile 中的 XPROF_VERSION 实参或将 --build-arg XPROF_VERSION=<version> 传递给 docker build 命令来更改版本。

如何运行

使用本地日志运行

将本地日志目录映射到容器中的 /app/logs。

docker run -p 8791:8791 \
  -v /tmp/xprof_logs:/app/logs \
  xprof:2.21.3

使用 GCS 日志运行

装载本地 gcloud 凭据，以便 xprof 可以通过 Google Cloud Storage 进行身份验证。

docker run -p 8791:8791 \
  -v ~/.config/gcloud:/root/.config/gcloud \
  xprof:2.21.3 \
  --logdir=gs://your-bucket-name/xprof_logs --port=8791