diff options
author | Graham Christensen <graham@grahamc.com> | 2020-03-28 19:18:10 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-03-28 19:18:10 -0400 |
commit | 4d226bad77f0fb91528426303c8ee2b3b205dc9a (patch) | |
tree | c4d82454ba3c6cba526c42ed6aad6d1a3059290a /nixos/doc/manual | |
parent | 596b601dfa8e8412fbc6db7748f6e4fb359a7731 (diff) | |
parent | bd5324c4fcb990715c64fc40c19341947e04bf17 (diff) | |
download | nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar.gz nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar.bz2 nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar.lz nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar.xz nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.tar.zst nixlib-4d226bad77f0fb91528426303c8ee2b3b205dc9a.zip |
Merge pull request #83600 from Ma27/hydra-two-stage-deploy
hydra: 2020-02-06 -> 2020-03-{24,27}
Diffstat (limited to 'nixos/doc/manual')
-rw-r--r-- | nixos/doc/manual/release-notes/rl-2003.xml | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/nixos/doc/manual/release-notes/rl-2003.xml b/nixos/doc/manual/release-notes/rl-2003.xml index 7674b0a5c0de..76b12af362f8 100644 --- a/nixos/doc/manual/release-notes/rl-2003.xml +++ b/nixos/doc/manual/release-notes/rl-2003.xml @@ -697,6 +697,66 @@ auth required pam_succeed_if.so uid >= 1000 quiet </para> </warning> </listitem> + <listitem> + <para> + <package>Hydra</package> has gained a massive performance improvement due to + <link xlink:href="https://github.com/NixOS/hydra/pull/710">some database schema + changes</link> by adding several IDs and better indexing. However, it's necessary + to upgrade Hydra in multiple steps: + <itemizedlist> + <listitem> + <para> + At first, an older version of Hydra needs to be deployed which adds those + (nullable) columns. When having set <link linkend="opt-system.stateVersion">stateVersion + </link> to a value older than <literal>20.03</literal>, this package will be selected + by default from the module when upgrading. Otherwise, the package can be deployed using + the following config: +<programlisting>{ pkgs, ... }: { + <link linkend="opt-services.hydra.package">services.hydra.package</link> = pkgs.hydra-migration; +}</programlisting> + </para> + </listitem> + <listitem> + <para> + Automatically fill the newly added ID columns on the server by running the following + command: +<screen> +<prompt>$ </prompt>hydra-backfill-ids +</screen> + <warning> + <para>Please note that this process can take a while depending on your database-size!</para> + </warning> + </para> + </listitem> + <listitem> + <para> + Deploy a newer version of Hydra to activate the DB optimizations. You can choose from + either <package>hydra-unstable</package> (latest <literal>master</literal> compiled + against <package>nixUnstable</package>) and <package>hydra-flakes</package> (latest + version with flake-support). + <warning> + <para> + If your <link linkend="opt-system.stateVersion">stateVersion</link> is set to + <literal>20.03</literal> or greater, <package>hydra-unstable</package> will be used + automatically! This will break your setup if you didn't run the migration. + </para> + </warning> + Please note that Hydra is currently not available with <package>nixStable</package> + as this doesn't compile anymore. + </para> + </listitem> + </itemizedlist> + <warning> + <para> + <package>pkgs.hydra</package> has been removed to ensure a graceful database-migration + using the dedicated package-attributes. If you still have <package>pkgs.hydra</package> + defined in e.g. an overlay, an assertion error will be thrown. To circumvent this, + you need to set <xref linkend="opt-services.hydra.package" /> to <package>pkgs.hydra</package> + explicitly and make sure you know what you're doing! + </para> + </warning> + </para> + </listitem> </itemizedlist> </section> |