[docker-ptf] Upgrade docker-ptf from bookworm to trixie by yijingyan2 · Pull Request #27889 · sonic-net/sonic-buildimage

yijingyan2 · 2026-06-14T23:59:10Z

Why I did it

docker-ptf still used Debian bookworm specific package names and Python paths.
To align with current distro direction, docker-ptf is migrated to trixie.

Work item tracking

Microsoft ADO (number only):

How I did it

Switched docker-ptf base image from bookworm to trixie
Updated trixie package names and versions
Updated Python site-packages wiring from Python 3.11 to Python 3.13 paths
Updated rules .mk file, moved docker registration from SONIC_BOOKWORM_DOCKERS to SONIC_TRIXIE_DOCKERS.

How to verify it

Which release branch to backport (provide reason below if selected)

Tested branch (Please provide the tested image version)

Description for the changelog

Link to config_db schema for YANG module changes

A picture of a cute animal (not mandatory but encouraged)

Signed-off-by: Yijing Yan <yijingyan@microsoft.com>

mssonicbld · 2026-06-14T23:59:18Z

/azp run Azure.sonic-buildimage

azure-pipelines · 2026-06-14T23:59:28Z

Azure Pipelines successfully started running 1 pipeline(s).

Copilot

Pull request overview

This PR migrates the docker-ptf image (used by the VS platform for PTF-based testing) from Debian bookworm to Debian trixie, aligning the container with the newer build environment and updated Python runtime expectations.

Changes:

Switch docker-ptf base image from debian:bookworm to debian:trixie and update a few distro-specific packages.
Update Python path wiring inside the container from Python 3.11 to 3.13.
Register docker-ptf under SONIC_TRIXIE_DOCKERS instead of SONIC_BOOKWORM_DOCKERS.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
platform/vs/docker-ptf.mk	Moves `docker-ptf` image registration to the trixie docker set for VS builds.
dockers/docker-ptf/Dockerfile.j2	Updates base OS to trixie and adjusts package list + Python path wiring accordingly.

 {% if PTF_ENV_PY_VER == "py3" %}
 # Install the python-saithrift into the virtual environment
-RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.11.egg" >> /root/env-python3/lib/python3.11/site-packages/easy-install.pth
+RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.13.egg" >> /root/env-python3/lib/python3.13/site-packages/easy-install.pth


+RUN mkdir -p /usr/lib/python3.13/dist-packages; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3/dist-packages/virtualenv.pth; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3.13/dist-packages/virtualenv.pth

-RUN echo "PYTHONPATH=/root/env-python3/lib/python3.11/site-packages" >> /etc/environment
+RUN echo "PYTHONPATH=/root/env-python3/lib/python3.13/site-packages" >> /etc/environment


mssonicbld · 2026-06-15T05:06:32Z

/azp run Azure.sonic-buildimage

azure-pipelines · 2026-06-15T05:06:44Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-06-15T05:13:37Z

/azp run Azure.sonic-buildimage

azure-pipelines · 2026-06-15T05:13:49Z

Azure Pipelines successfully started running 1 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

 endif
 SONIC_DOCKER_IMAGES += $(DOCKER_PTF)
-SONIC_BOOKWORM_DOCKERS += $(DOCKER_PTF)
+SONIC_TRIXIE_DOCKERS += $(DOCKER_PTF)


 {% if PTF_ENV_PY_VER == "py3" %}
 # Install the python-saithrift into the virtual environment
-RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.11.egg" >> /root/env-python3/lib/python3.11/site-packages/easy-install.pth
+RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.13.egg" >> /root/env-python3/lib/python3.13/site-packages/easy-install.pth
 {% endif %}


+RUN mkdir -p /usr/lib/python3.13/dist-packages; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3/dist-packages/virtualenv.pth; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3.13/dist-packages/virtualenv.pth

-RUN echo "PYTHONPATH=/root/env-python3/lib/python3.11/site-packages" >> /etc/environment
+RUN echo "PYTHONPATH=/root/env-python3/lib/python3.13/site-packages" >> /etc/environment


  paths:
    include:
-    - dockers/docker-ptf
+    - dockers/docker-ptf/**



yijingyan2 · 2026-06-15T05:28:32Z

/azp run Azure.docker-ptf

azure-pipelines · 2026-06-15T05:28:39Z

No pipelines are associated with this pull request.

yijingyan2 · 2026-06-15T05:31:31Z

/azp run Azure.docker-ptf

azure-pipelines · 2026-06-15T05:31:37Z

No pipelines are associated with this pull request.

yijingyan2 · 2026-06-15T05:33:30Z

/azp run Azure.docker-ptf

azure-pipelines · 2026-06-15T05:33:41Z

Azure Pipelines successfully started running 1 pipeline(s).

mssonicbld · 2026-06-15T09:38:29Z

/azp run Azure.sonic-buildimage

azure-pipelines · 2026-06-15T09:38:37Z

Azure Pipelines successfully started running 1 pipeline(s).

Signed-off-by: Yijing Yan <yijingyan@microsoft.com>

mssonicbld · 2026-06-15T09:45:32Z

/azp run Azure.sonic-buildimage

azure-pipelines · 2026-06-15T09:45:45Z

Azure Pipelines successfully started running 1 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

 SONIC_DOCKER_IMAGES += $(DOCKER_PTF)
-SONIC_BOOKWORM_DOCKERS += $(DOCKER_PTF)
+SONIC_TRIXIE_DOCKERS += $(DOCKER_PTF)


 {% if PTF_ENV_PY_VER == "py3" %}
 # Install the python-saithrift into the virtual environment
-RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.11.egg" >> /root/env-python3/lib/python3.11/site-packages/easy-install.pth
+RUN echo "/usr/lib/python3/dist-packages/saithrift-0.9-py3.13.egg" >> /root/env-python3/lib/python3.13/site-packages/easy-install.pth
 {% endif %}


+RUN mkdir -p /usr/lib/python3.13/dist-packages; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3/dist-packages/virtualenv.pth; \
+    echo "/root/env-python3/lib/python3.13/site-packages" > /usr/lib/python3.13/dist-packages/virtualenv.pth

-RUN echo "PYTHONPATH=/root/env-python3/lib/python3.11/site-packages" >> /etc/environment
+RUN echo "PYTHONPATH=/root/env-python3/lib/python3.13/site-packages" >> /etc/environment


mssonicbld · 2026-06-15T11:13:18Z

This PR has backport request for branch(es): 202605.
Added label(s) for branch(es) 202605.

_{---Powered by SONiC BuildBot}

migrate docker-ptf to trixie

8f3dc2f

Signed-off-by: Yijing Yan <yijingyan@microsoft.com>

yijingyan2 requested a review from lguohan as a code owner June 14, 2026 23:59

Copilot AI review requested due to automatic review settings June 14, 2026 23:59

Copilot started reviewing on behalf of yijingyan2 June 14, 2026 23:59 View session

Copilot AI reviewed Jun 15, 2026

View reviewed changes

Merge remote-tracking branch 'origin' into docker-ptf-trixie

d062ce2

yijingyan2 force-pushed the docker-ptf-trixie branch from 30b4506 to 3d8fa7d Compare June 15, 2026 05:13

Copilot AI review requested due to automatic review settings June 15, 2026 05:13

Copilot started reviewing on behalf of yijingyan2 June 15, 2026 05:13 View session

Copilot AI reviewed Jun 15, 2026

View reviewed changes

update PTF_MODIFIED value

f078ad0

Signed-off-by: Yijing Yan <yijingyan@microsoft.com>

Copilot AI review requested due to automatic review settings June 15, 2026 09:45

yijingyan2 force-pushed the docker-ptf-trixie branch from c798366 to f078ad0 Compare June 15, 2026 09:45

Copilot started reviewing on behalf of yijingyan2 June 15, 2026 09:45 View session

Copilot AI reviewed Jun 15, 2026

View reviewed changes

mssonicbld added the Request for 202605 Branch label Jun 15, 2026

mssonicbld added the Cherry Pick Conflict_202605 label Jun 15, 2026

Conversation

yijingyan2 commented Jun 14, 2026

Why I did it

Work item tracking

How I did it

How to verify it

Which release branch to backport (provide reason below if selected)

Tested branch (Please provide the tested image version)

Description for the changelog

Link to config_db schema for YANG module changes

A picture of a cute animal (not mandatory but encouraged)

Uh oh!

mssonicbld commented Jun 14, 2026

Uh oh!

azure-pipelines Bot commented Jun 14, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

mssonicbld commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

mssonicbld commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

yijingyan2 commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

yijingyan2 commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

yijingyan2 commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

mssonicbld commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

mssonicbld commented Jun 15, 2026

Uh oh!

azure-pipelines Bot commented Jun 15, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

mssonicbld commented Jun 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants