建構 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