Creazione di un'immagine Docker XProf

Questo documento descrive come creare un'immagine Docker per XProf utilizzando la release ufficiale di PyPI.

Dockerfile

Crea un file denominato Dockerfile con i seguenti contenuti:

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

Come creare

  1. Salva i contenuti riportati sopra come Dockerfile in una directory vuota.
  2. Crea l'immagine utilizzando il seguente comando:

    docker build -t xprof:2.21.3 .
    

Puoi modificare la versione modificando l'argomento XPROF_VERSION nel Dockerfile o passando --build-arg XPROF_VERSION=<version> al comando docker build.

Come eseguire

Esegui con i log locali

Mappa la directory dei log locali su /app/logs nel container.

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

Esegui con i log GCS

Monta le credenziali gcloud locali in modo che xprof possa autenticarsi con 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