Skip to content

[Design] Upgrade all Python projects to 3.14 and all Go projects to 1.26 #68

@duanhongyi

Description

@duanhongyi

Background
We need to standardize runtime versions across all projects: Python to 3.14, Go to 1.26, for consistency, performance, and maintainability.

Goals

  • Upgrade version baseline across all repos/services
  • Update CI, build images, and dependency workflows accordingly
  • Minimize regression risk and keep rollback path clear

Scope

  1. Inventory
    • List Python services/scripts/tools
    • List Go services/CLIs/libraries
    • List all base/build images
  2. Python 3.14 design
    • Update pyproject.toml / requirements constraints
    • Build compatibility matrix for dependencies
    • Align tooling (pytest/mypy/ruff, etc.)
  3. Go 1.26 design
    • Update go.mod go directive
    • Refresh dependencies + static analysis compatibility
    • Review build flags, cross-compile, CGO impacts
  4. CI/CD and container images
    • Upgrade GitHub Actions/CI runtime setup
    • Update Dockerfiles/base images
    • Adjust pip/go cache strategy
  5. Rollout and rollback
    • Batch rollout by project tier
    • Canary + regression verification
    • Rollback playbook per service

Definition of Done

  • All Python projects build/test with 3.14 by default
  • All Go projects build/test with 1.26 by default
  • Critical services pass regression/performance validation
  • Upgrade docs (compatibility, known issues, rollback) are complete
  • At least one production rollout drill is completed

Risks / Notes

  • Third-party packages not yet compatible
  • Runtime/compiler behavior changes causing edge regressions
  • Cross-repo upgrade sequencing complexity

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions