Skip to content

chore(docs): upgrade Alpine and PyYAML to fix doc build#875

Merged
traefiker merged 1 commit intotraefik:masterfrom
darkweaver87:fix/docs-dockerfile-master
Mar 23, 2026
Merged

chore(docs): upgrade Alpine and PyYAML to fix doc build#875
traefiker merged 1 commit intotraefik:masterfrom
darkweaver87:fix/docs-dockerfile-master

Conversation

@darkweaver87
Copy link
Copy Markdown
Collaborator

@darkweaver87 darkweaver87 commented Mar 23, 2026

What does this PR do?

Fixes the documentation build pipeline that fails with AttributeError: cython_sources during pip install.
cf. https://github.com/traefik/mesh/actions/runs/23431874908/job/68160009068

Root cause

The docs.Dockerfile uses Alpine 3.15 which ships Python 3.7 (EOL) with pip 20.1.1 and old setuptools. PyYAML 6.0.1's Cython-based build is incompatible with this old toolchain.

This also creates a circular dependency with the structor-based publish workflow:

  • Structor builds documentation for every versioned branch (v1.4, master, etc.) using each branch's own docs.Dockerfile
  • Even if master is fixed, structor still fails when building v1.4 (which has the old Dockerfile)
  • And v1.4 can't be fixed because the master pipeline blocks merges

This PR fixes the master side. A corresponding fix for v1.4 is in #873.

Changes

  • Upgrade base image from Alpine 3.15 to Alpine 3.18 (Python 3.11, modern pip/setuptools)
  • Bump PyYAML from 6.0.1 to 6.0.2 (includes the cython_sources fix)

Alpine 3.15 (Python 3.7) is EOL and causes build failures due to
PyYAML cython_sources incompatibility with old setuptools.

- Upgrade base image from Alpine 3.15 to 3.18
- Bump PyYAML from 6.0.1 to 6.0.2
@mloiseleur mloiseleur changed the title fix(docs): upgrade Alpine and PyYAML to fix doc build chore(docs): upgrade Alpine and PyYAML to fix doc build Mar 23, 2026
@mloiseleur mloiseleur added this to the next milestone Mar 23, 2026
@darkweaver87 darkweaver87 reopened this Mar 23, 2026
@darkweaver87 darkweaver87 reopened this Mar 23, 2026
@traefiker traefiker merged commit 9a344c9 into traefik:master Mar 23, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants