Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 2.81 KB

PYTHON_UPGRADE_GUIDE.MD

File metadata and controls

38 lines (24 loc) · 2.81 KB
Raw

Python Upgrade Runbook

So you wanna upgrade PyTorch to support a new Python? Follow these steps in order!

0.Before starting upgrade process. Check the package availability

Package availability to validate before starting upgrade process :

  1. Manywheel build: Python version is avalilable in either of these sources:
  1. Conda build: Python package is available via anaconda here. The upgrade for manywheel binaries can continue before this requirement is met.

1. Maintain Progress and Updates

Make an issue to track the progress, for example CUDA issue #56721: Support 11.3. This is especially important as many PyTorch external users are interested in CPython upgrades.

2. Modify scripts to install the new Python for Docker Manywheel images.

  1. Follow this PR 1427 with followup PR 1568 for all steps in this section
  2. Validate that Build manywheel docker images is successful here

3. Modify scripts to install the new Python for Core nightyly Manywheel and Conda builds.

  1. Builder PRs: Follow this PR 1586 and PR 1593
  2. Pytorch PRs: PR 112882
  3. Builder PR and Pytorch PR need to be tested togeather. After landing initiate nightly build and make sure nightly build is successful via HUD

4. Land Test-Infra PRs and make sure nighly domains builds are successful

  1. Test-Infra PRs: PR 4768, PR 4843
  2. After landing it, intiate domain nightly builds and fix all follow up issues. Example vision PR 8137
  3. At this point we should have complete set of nightly builds for pytorch, vision and audio. Please validate nightly binaries with validate-binaries workflow to make sure smoke tests are passing for Python 3.12

5. Add support for new Pythron to CI

  1. Pytorch PR: PR 117853
  2. Please note, for any failures that can't be resolved easily, we ned to create new issue, and follow up on it similar to this example