まえがき

NixOS初学者の苦しみ - ドキュメントとFlakes

NixOSはNixパッケージマネージャーのもとで構築された非常に特徴的なLinuxディストリビューションであり、これまでのUbuntuやCentOS、Arch Linux等の伝統的なディストリビューションとは一線を画す哲学的デザインに基づいています。

他のディストリビューションに対するNixOSの大きな利点の1つはその再現性の高さと宣言的記述にあり、複数のデバイスを跨いで一貫した環境を複製することができます。

NixOSは確実に強力ですが、この大きな力には複雑さの増大という犠牲が伴います。この犠牲は初学者には非常に困難なものになります。そのうちの1つが他のLinuxディストリビューションの知識をNixOSに活用するのが難しいということです。また、公式やコミュニティのドキュメントが分散していたり古くなっていたりすることがあります。こういった問題はNixOSの初心者に大きな壁として立ちはだかります。

それ以外にも、Flakesと呼ばれるNixパッケージマネージャーの実験的な機能に関連したトラブルも見られます。 npmやCargoといったパッケージマネージャーに触発され、Flakesはflake.nixと呼ばれるファイルに全ての外部の依存関係を記録しflake.lockでバージョンを固定します。これらはNixパッケージマネージャーとNixOSの再現性と可用性(composability)を高めます。

Flakeはその利点によってコミュニティで広く使われるようになりました。公式の調査によると、新たにGitHubに作成されるNixのリポジトリの過半数がFlakesを利用しています。

しかし、残念ながら安定性を維持するために公式のドキュメントはFlakesに関する内容にごく僅かに言及しているのみです。このことは多くのNix/NixOSユーザーが混乱してしまいました。多くの人がFlakesを使っており、自分もそれを学びたいのにどこから始めたら良いのかわからないのです。散らばった情報をパズルのように繋ぎ合わせたり、Nixpkgsのソースコードを検索したり、経験豊富なユーザーに助けを求めなければなりませんでした。

この本の原点

この本の原点は私は最初にNixOSを使い始めたときに書いていた散らばったメモまで遡ります。

私がNixOSに入門した今年(2023)の4月、Nixの哲学とデザインに感銘を受けました。友人が勧めるままに私はNixの実験的な機能であるFlakesを学びました。 Flakesと旧来のNixOSの設定方法を比較したとき、前者がまさに求めているものだと気づきました。その結果私は伝統的なアプローチを完全に無視して、最初の段階でFlakesを用いてNixOSのシステムを構築する方法を学びました。

この学習を経て、初心者に優しいFlakesに関するガイドが殆ど存在しないこに気づきました。多くのドキュメントは伝統的なNixの設定にのみ焦点を当てており、当時の私はNixOS Wiki、Zero to Nix、 Nixpkgs Manual、Nixpkgsのソースコードなどから、旧来の設定に関する情報を無視しながら必要な情報のみを探し出す必要がありました。この学習の道のりはあまりにも複雑で苦痛でした。今後また躓かないよう、作業を進めるにつれて分散したメモを必死に文書化するようになりました。

いくらかの経験を経た今年(2023)の5月のはじめ、私はメインPCをNixOSに切り替えました。 NixOS入門者向けのメモを整理した後、それを私のブログ^[1]にアップロードし中国のコミュニティで共有しました。そこでの好感触な反応とアドバイスをもとに、その記事を英語に翻訳してRedditで共有し大きな反響を頂きました^[2]。

共有したドキュメントが好感触に受け入れられたことが私の原動力となり、更に改善をし続けました。継続的なアップデートにより、ドキュメントの内容は20,000語を突破しました。数名の読者がこのドキュメントの体験を更に改善できるのではないかと提案^[3]し、私はそれに導かれました。結果として私は今までの記事をGitHub上のリポジトリに移動し、専用のドキュメントサイトを立ち上げ、個人的なメモではなく初学者向けのガイドとなるように更に調整を加えました。

そしてこの多言語対応なオープンソースの本が生まれました。"<NixOS & Flakes Book>"と命名されたこの本は中国語で"NixOS & Flakes 新手指南" ("NixOS & Flakes Beginner's Guide")と命名されました。

このオープンソースの本の内容は、私が更にNixOSを使ったり読者と交流を持っていくなかで少しずつ進化していきました。読んでくださる方々からのポジティブな感想は、このドキュメントの更新のモチベーションになります。何人かの読者からの感想はまさにこの本の「進化」に役立ちました。最初はただNixOSでの体験を気軽に共有したかっただけでしたが、なんとオープンソースの本にまで成長しました。海外の読者数は私の国での数を大きく上回り、予想だにしなかった多くの数のstarをいただくことができました。

この本に貢献してくださったり提案をくださった全ての友人に感謝を申し上げます。さらに、支援と励ましをくださった全ての読者に深く感謝します。彼らがいなければこの本の内容は私の個人ブログに留まり、現在の形になることはなかったでしょう。

この本の特徴

NixOSとFlakesに焦点を当て、旧来のNixのアプローチを無視しています
Beginner-friendly, with explanations from the perspective of NixOS newcomers who have some experience with Linux usage and programming.
Step-by-step, progressive learning.
Most of the chapters in this book provide reference links at the end, making it easy for readers to delve deeper into the topics and evaluate the content's credibility.
Coherent content, well-organized, and structured. Readers can either read the book gradually or quickly find the information they need.

寄付

もしこの本があなたのお役に立てたなら、さらなる更新と維持のために寄付をしていただけると幸いです。

GitHub: https://github.com/sponsors/ryan4yin
Patreon: https://patreon.com/ryan4yin
Buy me a coffee: https://buymeacoffee.com/ryan4yin
爱发电: https://afdian.com/a/ryan4yin
Ethereum: 0xB74Aa43C280cDc8d8236952400bF6427E4390855

フィードバックとディスカッション

私はNixOSのエキスパートではなく2024年2月の時点でNixOSを9ヶ月程度しか使ってないので、何かしらの誤解や複雑な事例が含まれているかもしれません。なにか間違っていることや質問/提案を発見したら、是非issueを開いたりディスカッションに参加したりして私に知らせてください。この本を今後も改善し続けたいと考えています。

この小さな本を書き始めた理由は、当時はコミュニティの誰も初学者の私に代わって書いてくれる人がいなかったためです。間違いを犯す可能性があったとしても、何もしないよりは遥かに良いことだと考えています。

この本がより多くの人の助けとなり、NixOSを楽しんでいただくことを心から願っています。気に入っていただければ幸いです。

この本に関するフィードバックとディスカッションの歴史

英語でのフィードバックと関連するディスカッション:

中国語のフィードバックとディスカッション:

まえがき ​

NixOS初学者の苦しみ - ドキュメントとFlakes ​

この本の原点 ​

この本の特徴 ​

寄付 ​

フィードバックとディスカッション ​

この本に関するフィードバックとディスカッションの歴史 ​