commit de31f879bd1a08ed35f9e3b632a5ab22837b58be · pyrox.dev/nixpkgs

+40 -27
nixos/doc/manual/development/releases.xml
···

       10
       10
        
         <title>Release process</title>

     

       11
       11
        
       

     

       12
       12
        
         <para>

     

       13
       13
       -
           Going through an example of releasing NixOS 15.09:

     

       13
       13
       +
           Going through an example of releasing NixOS 17.09:

     

       14
       14
        
         </para>

     

       15
       15
        
       

     

       16
       16
        
         <section xml:id="one-month-before-the-beta">

     
···

       18
       18
        
           <itemizedlist spacing="compact">

     

       19
       19
        
             <listitem>

     

       20
       20
        
               <para>

     

       21
       21
       -
                 Send an email to nix-dev mailinglist as a warning about upcoming beta "feature freeze" in a month.

     

       21
       21
       +
                 Send an email to the nix-devel mailinglist as a warning about upcoming beta "feature freeze" in a month.

     

       22
       22
        
               </para>

     

       23
       23
        
             </listitem>

     

       24
       24
        
             <listitem>

     

       25
       25
        
               <para>

     

       26
       26
        
                 Discuss with Eelco Dolstra and the community (via IRC, ML) about what will reach the deadline.

     

       27
       27
       -
                 Any issue or Pull Request targeting the release should have assigned milestone.

     

       27
       27
       +
                 Any issue or Pull Request targeting the release should be included in the release milestone.

     

       28
       28
        
               </para>

     

       29
       29
        
             </listitem>

     

       30
       30
        
           </itemizedlist>

     
···

       34
       34
        
           <itemizedlist spacing="compact">

     

       35
       35
        
             <listitem>

     

       36
       36
        
               <para>

     

       37
       37
       -
                 Rename <literal>rl-unstable.xml</literal> -&gt;

     

       38
       38
       -
                 <literal>rl-1509.xml</literal>.

     

       37
       37
       +
                 Create a new release notes file for the upcoming release + 1, in this

     

       38
       38
       +
                 case <literal>rl-1803.xml</literal>.

     

       39
       39
        
               </para>

     

       40
       40
        
             </listitem>

     

       41
       41
        
             <listitem>

     

       42
       42
        
               <para>

     

       43
       43
       -
                 <literal>git tag -a -m &quot;Release 15.09-beta&quot; 15.09-beta &amp;&amp; git push --tags</literal>

     

       43
       43
       +
                 <literal>git tag -a -s -m &quot;Release 17.09-beta&quot; 17.09-beta &amp;&amp; git push --tags</literal>

     

       44
       44
        
               </para>

     

       45
       45
        
             </listitem>

     

       46
       46
        
             <listitem>

     

       47
       47
        
               <para>

     

       48
       48
       -
                 From the master branch run <literal>git checkout -B release-15.09</literal>.

     

       48
       48
       +
                 From the master branch run <literal>git checkout -B release-17.09</literal>.

     

       49
       49
        
               </para>

     

       50
       50
        
             </listitem>

     

       51
       51
        
             <listitem>

     

       52
       52
        
               <para>

     

       53
       53
        
                 <link xlink:href="https://github.com/NixOS/nixos-org-configurations/pull/18">

     

       54
       54
       -
                   Make sure channel is created at http://nixos.org/channels/.

     

       54
       54
       +
                   Make sure a channel is created at http://nixos.org/channels/.

     

       55
       55
        
                 </link>

     

       56
       56
        
               </para>

     

       57
       57
        
             </listitem>

     

       58
       58
        
             <listitem>

     

       59
       59
        
               <para>

     

       60
       60
        
                 <link xlink:href="https://github.com/NixOS/nixpkgs/settings/branches">

     

       61
       61
       -
                   Lock the branch on github (so developers can’t force push)

     

       61
       61
       +
                   Let a GitHub nixpkgs admin lock the branch on github for you.

     

       62
       62
       +
                   (so developers can’t force push)

     

       62
       63
        
                 </link>

     

       63
       64
        
               </para>

     

       64
       65
        
             </listitem>

     

       65
       66
        
             <listitem>

     

       66
       67
        
               <para>

     

       67
       67
       -
                 <link xlink:href="https://github.com/NixOS/nixpkgs/compare/bdf161ed8d21...6b63c4616790">bump

     

       68
       68
       -
                 <literal>system.defaultChannel</literal> attribute in

     

       69
       69
       -
                 <literal>nixos/modules/misc/version.nix</literal></link>

     

       68
       68
       +
                 <link xlink:href="https://github.com/NixOS/nixpkgs/compare/bdf161ed8d21...6b63c4616790">

     

       69
       69
       +
                   Bump the <literal>system.defaultChannel</literal> attribute in

     

       70
       70
       +
                   <literal>nixos/modules/misc/version.nix</literal>

     

       71
       71
       +
                 </link>

     

       70
       72
        
               </para>

     

       71
       73
        
             </listitem>

     

       72
       74
        
             <listitem>

     

       73
       75
        
               <para>

     

       74
       74
       -
                 <link xlink:href="https://github.com/NixOS/nixpkgs/commit/d6b08acd1ccac0d9d502c4b635e00b04d3387f06">update

     

       75
       75
       -
                 <literal>versionSuffix</literal> in

     

       76
       76
       +
                 <link xlink:href="https://github.com/NixOS/nixpkgs/commit/d6b08acd1ccac0d9d502c4b635e00b04d3387f06">

     

       77
       77
       +
                   Update <literal>versionSuffix</literal> in

     

       76
       78
        
                 <literal>nixos/release.nix</literal></link>, use

     

       77
       77
       -
                 <literal>git log --format=%an|wc -l</literal> to get commit

     

       79
       79
       +
                 <literal>git log --format=%an|wc -l</literal> to get the commit

     

       78
       80
        
                 count

     

       79
       81
        
               </para>

     

       80
       82
        
             </listitem>

     

       81
       83
        
             <listitem>

     

       82
       84
        
               <para>

     

       83
       83
       -
                 <literal>echo -n &quot;16.03&quot; &gt; .version</literal> in

     

       85
       85
       +
                 <literal>echo -n &quot;18.03&quot; &gt; .version</literal> on

     

       84
       86
        
                 master.

     

       85
       87
        
               </para>

     

       86
       88
        
             </listitem>

     

       87
       89
        
             <listitem>

     

       88
       90
        
               <para>

     

       89
       89
       -
                 <link xlink:href="https://github.com/NixOS/nixpkgs/commit/b8a4095003e27659092892a4708bb3698231a842">pick

     

       90
       90
       -
                 a new name for unstable branch.</link>

     

       91
       91
       +
                 <link xlink:href="https://github.com/NixOS/nixpkgs/commit/b8a4095003e27659092892a4708bb3698231a842">

     

       92
       92
       +
                   Pick a new name for the unstable branch.

     

       93
       93
       +
                 </link>

     

       91
       94
        
               </para>

     

       92
       95
        
             </listitem>

     

       93
       96
        
             <listitem>

     
···

       99
       102
        
             </listitem>

     

       100
       103
        
             <listitem>

     

       101
       104
        
               <para>

     

       102
       102
       -
                 Use https://lwn.net/Vulnerabilities/ and 

     

       103
       103
       -
                 <link xlink:href="https://github.com/NixOS/nixpkgs/search?utf8=%E2%9C%93&amp;q=vulnerabilities&amp;type=Issues">triage vulnerabilities in an issue</link>.

     

       104
       104
       -
               </para>

     

       105
       105
       -
             </listitem>

     

       106
       106
       -
             <listitem>

     

       107
       107
       -
               <para>

     

       108
       108
       -
                 Create two Hydra jobsets: release-15.09 and release-15.09-small with <literal>stableBranch</literal> set to false

     

       105
       105
       +
                 Create two Hydra jobsets: release-17.09 and release-17.09-small with <literal>stableBranch</literal> set to false.

     

       109
       106
        
               </para>

     

       110
       107
        
             </listitem>

     

       111
       108
        
             <listitem>

     

       112
       109
        
               <para>

     

       113
       110
        
                 Edit changelog at

     

       114
       114
       -
                 <literal>nixos/doc/manual/release-notes/rl-1509.xml</literal>

     

       111
       111
       +
                 <literal>nixos/doc/manual/release-notes/rl-1709.xml</literal>

     

       115
       112
        
                 (double check desktop versions are noted)

     

       116
       113
        
               </para>

     

       117
       114
        
               <itemizedlist spacing="compact">

     

       118
       115
        
                 <listitem>

     

       119
       116
        
                   <para>

     

       120
       117
        
                     Get all new NixOS modules

     

       121
       121
       -
                     <literal>git diff release-14.12..release-15.09 nixos/modules/module-list.nix|grep ^+</literal>

     

       118
       118
       +
                     <literal>git diff release-17.03..release-17.09 nixos/modules/module-list.nix|grep ^+</literal>

     

       122
       119
        
                   </para>

     

       123
       120
        
                 </listitem>

     

       124
       121
        
                 <listitem>

     
···

       130
       127
        
             </listitem>

     

       131
       128
        
           </itemizedlist>

     

       132
       129
        
         </section>

     

       130
       130
       +
         <section xml:id="during-beta">

     

       131
       131
       +
           <title>During Beta</title>

     

       132
       132
       +
           <itemizedlist spacing="compact">

     

       133
       133
       +
             <listitem>

     

       134
       134
       +
               <para>

     

       135
       135
       +
                 Monitor the master branch for bugfixes and minor updates

     

       136
       136
       +
                 and cherry-pick them to the release branch.

     

       137
       137
       +
               </para>

     

       138
       138
       +
             </listitem>

     

       139
       139
       +
           </itemizedlist>

     

       140
       140
       +
         </section>

     

       133
       141
        
         <section xml:id="before-the-final-release">

     

       134
       142
        
           <title>Before the final release</title>

     

       135
       143
        
           <itemizedlist spacing="compact">

     

       144
       144
       +
             <listitem>

     

       145
       145
       +
               <para>

     

       146
       146
       +
                 Re-check that the release notes are complete.

     

       147
       147
       +
               </para>

     

       148
       148
       +
             </listitem>

     

       136
       149
        
             <listitem>

     

       137
       150
        
               <para>

     

       138
       151
        
                 Release Nix (currently only Eelco Dolstra can do that).