Como criar uma imagem do Docker do XProf

Este documento descreve como criar uma imagem do Docker para o XProf usando a versão oficial do PyPI.

Dockerfile

Crie um arquivo chamado Dockerfile com o conteúdo a seguir:

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"]

Como criar

  1. Salve o conteúdo acima como Dockerfile em um diretório vazio.
  2. Crie a imagem usando o seguinte comando:

    docker build -t xprof:2.21.3 .
    

É possível mudar a versão modificando o argumento XPROF_VERSION no Dockerfile ou transmitindo --build-arg XPROF_VERSION=<version> ao comando docker build.

Como executar

Executar com registros locais

Mapeie seu diretório de registros local para /app/logs no contêiner.

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

Executar com registros do GCS

Monte suas credenciais locais da gcloud para que o xprof possa se autenticar com o 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