From 6b1762f9cf98e006e4d2c51851dcbfd61bb13435 Mon Sep 17 00:00:00 2001 From: YOUNG HO CHA Date: Mon, 14 Aug 2023 02:20:22 +0900 Subject: [PATCH] Update doc for specifying location of versions-manifest.json --- docs/advanced-usage.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index 2dcb0efc7..fbd794b58 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -512,6 +512,26 @@ Python distributions are only available for the same [environments](https://gith If you have a supported self-hosted runner and you would like to use `setup-python`, there are a few extra things you need to make sure are set up so that new versions of Python can be downloaded and configured on your runner. +### Specifying versions-manifest.json + +If you are using an unsupported platform version, you can try to host your prebuilt python binaries and specify location of `versions-manifest.json` file. + +```yaml +steps: +- uses: actions/checkout@v3 +- uses: actions/setup-python@v4 + with: + python-version: '3.7.5' + versions-manifest-repo-owner: your_account + versions-manifest-repo-name: your_repo + versions-manifest-repo-branch: your_branch +- run: python my_script.py +``` + +In this case, location of `versions-manifest.json` will be `https://raw.githubusercontent.com/your_account/your_repo/your_branch/versions-manifest.json`. +Location of `versions-manifest.json` is always searched on `github.com` only, because [actions/tool-cache](https://github.com/actions/toolkit/tree/main/packages/tool-cache) does not support Github Enterprise Server, yet. + + ### Windows - Your runner needs to be running with administrator privileges so that the appropriate directories and files can be set up when downloading and installing a new version of Python for the first time.