Flakes/ru: Difference between revisions

<span id="Introduction"></span>

==== Введение ====

Nix flakes обеспечивают единую структуру для Nix-проектов, фиксируют версии зависимостей в лок-файле и делают более удобным написание воспроизводимых Nix-выражений.

* [https://nixos.org/manual/nix/unstable/command-ref/new-cli/nix3-flake.html#description flake]  это файловая структура, корневая директория которой содержит спецификацию Nix в файле <code>flake.nix</code>.

* Содержимое файла <code>flake.nix</code> следует единой схеме наименования для объявления пакетов и их зависимостей на языке Nix.

Флейки вводят [https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-references синтаксис, похожий на URL] для указания удалённых источников.

* Чтобы упростить длинный синтаксис URL с помощью более коротких названий, [https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-registry.html флейки используют реестр] символических идентификаторов.

* Флейки также позволяют фиксировать ссылки и версии, которые затем могут быть запрошены и обновлены программно.

[https://nixos.org/manual/nix/stable/command-ref/new-cli/nix.html Экспериментальный интерфейс командной строки] принимает ссылки на флейки для выражений, которые создают, запускают и развёртывают пакеты.

<span id="Enable_flakes_temporarily"></span>

<span id="Enable_flakes_permanently_in_NixOS"></span>

<span id="Other_Distros,_with_Home-Manager"></span>

<span id="Other_Distros,_without_Home-Manager"></span>

<span id="Basic_Usage_of_Flake"></span>

=== Основное Использование Flake ===

Прежде чем выполнять какие-либо команды nix на этом этапе, обратите внимание на два предупреждения ниже: одно для шифрования, другое для git.

<span id="Encryption_WARNING"></span>

====Внимание: Шифрование====

{{Warning | Так как содержимое файлов Flake скопировано в общедоступную папку хранилища Nix, не храните никаких незашифрованных секретов в файлах Flake. Вам следует использовать [[Comparison of secret managing schemes|схемы управления секретами]].}}

<span id="Git_WARNING"></span>

====Внимание: Git====

Поэтому если вы используете git для ваших флейков, не забывайте применять <code>git add</code> ко всем файлам репозитория, после того как вы их создаёте

См. также: https://www.tweag.io/blog/2020-05-25-flakes/

<span id="Generate_flake.nix_file"></span>

====Создание файла flake.nix====

Чтобы начать базовое использование Flakes, выполните команду flake в каталоге проекта:

<syntaxHighlight lang=text>

nix flake init

* <code>nixConfig</code> is an attribute set of values which reflect the [https://nixos.org/manual/nix/stable/command-ref/conf-file.html values given to nix.conf]. This can extend the normal behavior of a user's nix experience by adding flake-specific configuration, such as a binary cache.

Nixpkgs can be defined using the following code:

== Using flakes with stable Nix ==

There exists the [https://github.com/edolstra/flake-compat flake-compat] library that you can use to shim <code>default.nix</code> and <code>shell.nix</code> files. It will download the inputs of the flake, pass them to the flake’s <code>outputs</code> function and return an attribute set containing <code>defaultNix</code> and <code>shellNix</code> attributes. The attributes will contain the output attribute set with an extra <code>default</code> attribute pointing to current platform’s <code>defaultPackage</code> (resp. <code>devShell</code> for <code>shellNix</code>).

Place the following into <code>default.nix</code> (for <code>shell.nix</code>, replace <code>defaultNix</code> with <code>shellNix</code>) to use the shim:

You can also use the lockfile to make updating the hashes easier using <code>nix flake lock --update-input flake-compat</code>. Add the following to your <code>flake.nix</code>:

and add <code>flake-compat</code> to the arguments of <code>outputs</code> attribute. Then you will be able to use <code>default.nix</code> like the following:

== Accessing flakes from Nix expressions ==

If you want to access a flake from within a regular Nix expression on a system that has flakes enabled, you can use something like <code>(builtins.getFlake "/path/to/directory").packages.x86_64-linux.default</code>, where 'directory' is the directory that contains your <code>flake.nix</code>.

outputs = { self, nixpkgs, ... }:

   {

      modules = [

        "${nixpkgs}/nixos/modules/<some-module>.nix"

  };

 

<div lang="en" dir="ltr" class="mw-content-ltr">

 

== Установка пакетов с помощью `nix-profile` ==

 

 

 

{{Ic|nixos-rebuild switch}} will read its configuration from <code>/etc/nixos/flake.nix</code> if it is present.

 

 

  inputs.nixpkgs.url = github:NixOS/nixpkgs/nixos-unstable;

    };

<syntaxhighlight lang="nix">

{

  inputs.nixpkgs.url = github:NixOS/nixpkgs/nixos-unstable;

  inputs.home-manager.url = github:nix-community/home-manager;

 

   outputs = { self, nixpkgs, ... }@inputs: {

     nixosConfigurations.fnord = nixpkgs.lib.nixosSystem {

       specialArgs = { inherit inputs; };

       modules = [ ./configuration.nix ];

     };

{{Ic|nixos-rebuild}} also allows to specify different flake using the <code>--flake</code> flag (# is optional):

</div>

 

</syntaxhighlight>

To switch a remote host you can use:

<syntaxhighlight lang="bash">

</syntaxhighlight>

 

<div lang="en" dir="ltr" class="mw-content-ltr">

== Pinning the registry on NixOS ==

 

 

 

 

   inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";

 

   outputs =

    { nixpkgs, ... }:

     {

       /*

        This example assumes your system is x86_64-linux

       devShells.x86_64-linux =

          pkgs = nixpkgs.legacyPackages.x86_64-linux;

        in

        {

          default = pkgs.mkShell {

            packages = [ pkgs.hello ];

And finally, run <code>nix develop</code>. This is what replaces the old nix-shell invocation.

Exit and run again, this command should now be super fast.

<div lang="en" dir="ltr" class="mw-content-ltr">

</div>

<span id="Automatically_switch_nix_shells_with_nix-direnv"></span>

You can easily switch nix shells when you cd into different projects with [https://github.com/nix-community/nix-direnv nix-direnv].

== Pushing Flakes to Cachix ==

 

<div lang="en" dir="ltr" class="mw-content-ltr">

== Build specific attributes in a flake repository ==

When in the repository top-level, run <code>nix build .#<attr></code>. It will look in the <code>legacyPackages</code> and <code>packages</code> output attributes for the corresponding derivation.

Eg, in nixpkgs:

=== Building flakes from a Git repo url with submodules ===

As per nix 2.9.1, git submodules in package <code>src</code>'s won't get copied to the nix store, this may cause the build to fail. To workaround this, use:

A NixOS config flake could be as follows:

 

 

 

  outputs =

    { nixpkgs, nixpkgs-unstable, ... }:

            nixpkgs.overlays = [

              (final: prev: {

          ./configuration.nix

</syntaxhighlight>

 

</syntaxhighlight>

 

<div lang="en" dir="ltr" class="mw-content-ltr">

If the variable <code>nixpkgs</code> points to the flake, you can also define <code>pkgs</code> with overlays with:

 

pkgs = import nixpkgs { system = "x86_64-linux"; overlays = [ /*the overlay in question*/ ]; };

 

 

When a git folder exists, flake will only copy files added in git to maximize reproducibility (this way if you forgot to add a local file in your repo, you will directly get an error when you try to compile it). However, for development purpose you may want to create an alternative flake file, for instance containing configuration for your preferred editors as described [https://discourse.nixos.org/t/local-personal-development-tools-with-flakes/22714/8 here]… of course without committing this file since it contains only your own preferred tools. You can do so by doing something like that (say for a file called <code>extra/flake.nix</code>):

* [https://nixos.org/manual/nix/unstable/command-ref/new-cli/nix3-flake.html Nix flake command reference manual] - Many additional details about flakes, and their parts.

* [https://www.youtube.com/watch?v=QXUlhnhuRX4&list=PLgknCdxP89RcGPTjngfNR9WmBgvD_xW0l Nix flakes 101: Introduction to nix flakes] (Jörg Thalheim, 2020)

* [https://github.com/NixOS/nix/blob/master/src/nix/flake.md spec describing flake inputs in more detail]

* [https://github.com/numtide/flake-utils flake-utils: Library to avoid some boiler-code when writing flakes]

* [https://zimbatm.com/NixFlakes/#direnv-integration zimbat's direnv article]