1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
There are a variety of other projects related to dask that are often
co-released. We may want to check their status while releasing
Releasing dask and distributed:
* Check the release issue on https://github.com/dask/community to see if there
are any remaining blockers. If not, comment on the issue signalling that you
are starting the release
* Update release notes in docs/source/changelog.rst
Start by using this script to autogenerate some of the changelog entries:
git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"- %s \`%an\`_" > change.md && sed -i -e 's/(#/(:pr:`/g' change.md && sed -i -e 's/) `/`) `/g' change.md
Replace single backticks with double backticks.
Sort the entries into subsections and render docs (``make html``) to make
sure that the changelog renders properly. In particular watch warnings for
new contibutors who don't yet have a github link at the end of the file.
Add any new contributors' github links to the end of the file
(``gh pr view <PR> --json author`` is helpful for getting their usernames).
* Update the distributed version in dask/setup.py and the dask version
in distributed/requirements.txt
* Commit
git commit -a -m "bump version to YYYY.M.X"
* Tag commit
git tag -a YYYY.M.X -m 'Version YYYY.M.X'
* Push to GitHub
git push https://github.com/dask/dask main --tags
git push https://github.com/dask/distributed main --tags
* Upload to PyPI
git clean -xfd
python setup.py sdist bdist_wheel
twine upload dist/*
* AUTOMATED PATH: Wait for [conda-forge](https://conda-forge.github.io) bots to track the
change to PyPI. This will typically happen in an hour or two.
MANUAL PATH: If you don't want to wait for the bots, then follow these steps:
* Update conda-smithy and run conda-smithy rerender
git clone git@github.com:conda-forge/dask-core-feedstock
cd dask-core-feedstock
conda install conda-smithy
conda-smithy rerender
* Get sha256 hash from pypi.org
* Update version number and hash in recipe
* Check dependencies
* Do the same for the dask-feedstock meta-package and distributed-feedstock
There should be three PRs, one to `dask-core`, another to `distributed`, and the
last to `dask`. You should be able to merge these after tests pass. In some cases
though you may have to zero out build numbers or update dependencies.
The packages are interdependent so the tests will pass in a cascade. For instance
the `distributed` PR depends on the availability of `dask-core` on conda-forge, so
its tests won't pass until some time (about an hour) after the `dask-core` PR is merged.
You can check availability on conda-forge using
conda search 'conda-forge::dask-core=YYYY.M.X'
Once `dask-core` is available, you can restart the `distributed` tests by commenting
on the PR:
@conda-forge-admin, please restart CI
`dask` is similar but it depends on `dask-core` _and_ `distributed`.
* [dask-docker](https://github.com/dask/dask-docker) PRs should be automatically created,
but they might need a small modification. Check by grepping for the old release string.
* Automated systems internal to Anaconda Inc then handle updating the
Anaconda defaults channel
* Raise an issue (using the release template) in the https://github.com/dask/community
issue tracker signaling when the next release will occur (usually in 2 weeks).
Let that issue collect comments to ensure that other maintainers are comfortable
with releasing.
|
