Channel branches: Difference between revisions

imported>D-goldin
m s/19.03/19.09
imported>Raboof
remove separate 'unstable' section, as it was duplicate information (and partly wrong at that)
Line 13: Line 13:
* Stable/unstable:
* Stable/unstable:
** Stable channels (<code>nixos-19.09</code>) provide conservative updates for fixing bugs and security vulnerabilities, but do not receive major updates after initial release. New stable channels are released every six months.
** Stable channels (<code>nixos-19.09</code>) provide conservative updates for fixing bugs and security vulnerabilities, but do not receive major updates after initial release. New stable channels are released every six months.
** Unstable channels (<code>nixos-unstable</code>, <code>nixpkgs-unstable</code>) correspond to the main development branch of Nixpkgs, delivering the latest tested updates on a rolling basis.
** Unstable channels (<code>nixos-unstable</code>, <code>nixpkgs-unstable</code>) correspond to the main development branch (master) of Nixpkgs, delivering the latest tested updates on a rolling basis.


* Large/small:
* Large/small:
Line 49: Line 49:
== Channel update process ==
== Channel update process ==


Each channel has a particular job at [https://hydra.nixos.org hydra.nixos.org] which must succeed:
Each <code>unstable</code> channel has a particular job at [https://hydra.nixos.org hydra.nixos.org] which must succeed:


* For NixOS: the [http://hydra.nixos.org/job/nixos/trunk-combined/tested trunk-combined/tested] job, which contains some automated NixOS tests.
* For NixOS: the [http://hydra.nixos.org/job/nixos/trunk-combined/tested trunk-combined/tested] job, which includes some automated NixOS tests.
*  For nixos-small: the [http://hydra.nixos.org/job/nixos/unstable-small/tested unstable-small/tested] job.
*  For nixos-small: the [http://hydra.nixos.org/job/nixos/unstable-small/tested unstable-small/tested] job.
*  For nixpkgs: the [http://hydra.nixos.org/job/nixpkgs/trunk/unstable trunk/unstable] job, which contains some critical release packages.
*  For nixpkgs: the [http://hydra.nixos.org/job/nixpkgs/trunk/unstable trunk/unstable] job, which contains some critical release packages.
Line 59: Line 59:
When the download completes, the channel updates.
When the download completes, the channel updates.


To find out when a channel was last updated, check [https://howoldis.herokuapp.com/ this] page.
To find out when a channel was last updated, check [https://howoldis.herokuapp.com/ this] page.
 
=== Unstable ===
 
The unstable channels (<code>nixpkgs/unstable</code> and <code>nixos/unstable</code>) are built off of the <code>master</code> branch.
 
Once a PR gets merged, a job is triggered in [[Hydra]]. [https://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents This page] lists the 15 most recent builds in the <code>nixpkgs/unstable</code> channel (with the left-most column being the most recent) along with each build's constituents. Constituents are critical packages.
 
A build is considered successful when both of the following two conditions are true:
 
* All of the constituent jobs are green (meaning, the tests have succeeded)
* All of the jobs in the corresponding evaluation have finished (with a success or a failure)
 
The evaluation for a build can be found on the build's page, following the "Part of" link in the "Summary" tab.