HOWTO write the release notes » History » Version 27
David Galloway, 02/24/2021 06:03 PM
1 | 22 | David Galloway | h1. ceph.git Release Notes |
---|---|---|---|
2 | |||
3 | 13 | Loïc Dachary | * git clone http://github.com/ceph/ceph (or git fetch to get the latest stable branch updates). Do *not* checkout the release branch as it does not have the *ceph-release-notes* script |
4 | * run the following: |
||
5 | 5 | Loïc Dachary | <pre> |
6 | 9 | Loïc Dachary | cd ceph/src/script |
7 | virtualenv v |
||
8 | 20 | Nathan Cutler | source v/bin/activate |
9 | 1 | Loïc Dachary | pip install githubpy GitPython review requests |
10 | 22 | David Galloway | # Replace 15.2.8 with whatever the previous stable release was |
11 | # Replace 'octopus' with whatever release you're working on |
||
12 | # Replace XXXXX with your GitHub API token |
||
13 | ./ceph-release-notes -r tags/v15.2.8..origin/octopus $(git rev-parse --show-toplevel) --token XXXXX |
||
14 | 9 | Loïc Dachary | deactivate |
15 | 1 | Loïc Dachary | </pre> |
16 | 16 | Loïc Dachary | * The *ceph-release-notes* script requires that each pull request is prefixed with the component it relates to (mon, osd etc.). If that's not the case, it will display an error message such as |
17 | 11 | Loïc Dachary | <pre> |
18 | 12 | Loïc Dachary | ERROR: http://github.com/ceph/ceph/pull/4884 title Keystone PKI token expiration is not enforced does not match ^(?:hammer|infernalis|jewel|kraken): (cli|common|mon|osd|fs|librbd|rbd|fs|mds|objecter|rgw|build/ops|tests|tools|cmake|doc|crush|librados)(:.*) |
19 | 1 | Loïc Dachary | </pre> |
20 | the pull request title must be edited to add the required prefix. |
||
21 | 27 | David Galloway | * *IS THIS NEEDED?* add a section in http://docs.ceph.com/docs/master/release-notes/ in the *master* branch of ceph in the "release-notes.rst":https://github.com/ceph/ceph/blob/master/doc/release-notes.rst file with the list of commits. The general idea is that the file on master reflects all releases ever published. The relevant part is then backported so that it also shows in the stable branch. |
22 | 23 | David Galloway | * Create a new branch either in your fork of ceph.git or the actual ceph.git (but be careful and tidy!) |
23 | 22 | David Galloway | * Edit <code>doc/releases/RELEASE.rst</code> |
24 | 1 | Loïc Dachary | <pre> |
25 | 22 | David Galloway | vXX.X.X Branch |
26 | ============== |
||
27 | |||
28 | This is the Xth backport release in the RELEASE series. !! If there is a major change, it should be mentioned here. Ask sage, josh, and neha !! |
||
29 | We recommend all users update to this release. |
||
30 | |||
31 | Notable Changes |
||
32 | --------------- |
||
33 | |||
34 | * Copy them from here: https://github.com/ceph/ceph/blob/octopus/PendingReleaseNotes |
||
35 | |||
36 | Changelog |
||
37 | --------- |
||
38 | |||
39 | * The output of ceph-release-notes should go here |
||
40 | 1 | Loïc Dachary | </pre> |
41 | 22 | David Galloway | * create a pull request with this change and request reviews from all leads |
42 | -* add the text only version of the release notes as a comment to the pull request |
||
43 | <pre> |
||
44 | ./ceph-release-notes -r tags/v15.2.8..origin/octopus $(git rev-parse --show-toplevel) --token XXXXX |
||
45 | </pre> |
||
46 | so that it can conveniently be copy/pasted when sending the mail announcing the release.- |
||
47 | 1 | Loïc Dachary | * backport the release notes to the release branch when they are final. Ideally this is done before the point release is published. If not it can be backported shortly afterwards. |
48 | 26 | David Galloway | -* the release notes come with an introduction that "is prepared in a separate file":https://github.com/ceph/ceph/blob/master/PendingReleaseNotes . It can be edited if something significant must not be forgotten and it does not need to well written because it is a draft. |
49 | * the content of the "pending release notes":https://github.com/ceph/ceph/blob/master/PendingReleaseNotes file can be manually added at the beginning of the "release-notes.rst":https://github.com/ceph/ceph/blob/master/doc/release-notes.rst. In theory the person writing the release notes should know about these pending notes so this is just a way to make sure they are not forgotten.- |
||
50 | 22 | David Galloway | |
51 | h1. E-mail Release Notes |
||
52 | |||
53 | <pre> |
||
54 | To: ceph-announce@ceph.io, ceph-users@ceph.io, dev@ceph.io, ceph-maintainers@ceph.io |
||
55 | |||
56 | Title: vXX.X.X RELEASE released |
||
57 | |||
58 | Body: |
||
59 | We're happy to announce the Xth backport release in the RELEASE series. !! If there is a major change, it should be mentioned here. Ask sage, josh, and neha !! We recommend users to update to this release. For a detailed release notes with links & changelog please refer to the official blog entry at https://ceph.io/releases/vXX-X-X-RELEASE-released |
||
60 | |||
61 | Notable Changes |
||
62 | --------------- |
||
63 | |||
64 | * Copy bullet points from doc/releases/RELEASE.rst |
||
65 | |||
66 | Getting Ceph |
||
67 | ------------ |
||
68 | * Git at git://github.com/ceph/ceph.git |
||
69 | * Tarball at http://download.ceph.com/tarballs/ceph-XX.X.X.tar.gz |
||
70 | * For packages, see http://docs.ceph.com/docs/master/install/get-packages/ |
||
71 | * Release git sha1: $SHA1 |
||
72 | </pre> |
||
73 | |||
74 | h1. Website Release Notes |
||
75 | |||
76 | These instructions are for the Wordpress site. These will change when the new site is launched in 2021 (?). |
||
77 | |||
78 | * Log in to the Wordpress Admin panel |
||
79 | * Go to https://ceph.io/wp-admin/edit.php |
||
80 | * Mouse over a recent "released" blog post and click *Clone* |
||
81 | * Click *Edit* on the new cloned draft |
||
82 | * Using the same script, |
||
83 | <pre> |
||
84 | ./ceph-release-notes --html -r tags/v15.2.8..origin/octopus $(git rev-parse --show-toplevel) --token XXXXX |
||
85 | </pre> |
||
86 | 24 | David Galloway | * Due to dgalloway's limited python skills, this will output each line as <code><li><p>octopus: mds: etc.</code>. |
87 | 25 | David Galloway | * Paste the output into a file, open it in <code>vim</code> and delete the <code>release:</code> column. e.g., |
88 | 24 | David Galloway | <pre> |
89 | - <li><p>octopus: mds: etc. |
||
90 | - <li><p>octopus: mds: etc. |
||
91 | + <li><p>mds: etc. |
||
92 | + <li><p>mds: etc. |
||
93 | </pre> |
||
94 | 22 | David Galloway | * Update the backport release # and RELEASE name if needed |
95 | * Copy the notable changes from your e-mail |
||
96 | * Copy the output of <code>ceph-release-notes --html</code> under *Changelog* |