Skip to content

Commit

Permalink
Update doc for specifying location of versions-manifest.json
Browse files Browse the repository at this point in the history
  • Loading branch information
ganadist committed Aug 14, 2023
1 parent 884adf2 commit 6b1762f
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions docs/advanced-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down

0 comments on commit 6b1762f

Please sign in to comment.