source.markdown

% Hydra % サニエ エリック % 2016年8月10日 - Tokyo NixOS Meetup

アジェンダ

• ニュース
• Hydra

ニュース

This month in Nix - News from the front 1/2

• Deploying a NixOS VM on Microsoft Azure
• Building mobile apps with Nix
• Nix support in Travis
• Too many issues open
• IFD nix#954

This month in Nix - News from the front 2/2

• Nix C++ migration is progressing nix#341
• Nix and IPFS nix#859
• Nix Docker image updated
• VulNix 1.0 released!
• Purely Functional Linux with NixOS
• Nix on Vultr

Hydra

Hydraとは 1/3

• Nixプロジェクトの一部
• NixOSとnixpkgsの継続インテグレーション兼ビルドファーム

Hydraとは 2/3

• Nixベースの汎用的な
  • 継続インテグレーションシステム
  • ビルドファーム
• NixOSでバイナリパッケージを利用できるのはHydraのおかげ

Hydraとは 3/3

• Nixの自動化システム
• nix-build on steroids

注意

• 正式リリースされていない
• ドキュメンテーションはほぼ存在しない
• 設定はnix expressionで書く必要がある
• 現時点で使うには努力がいる

特徴

• 汎用性: いろいろな言語や技術対応
  • RPM、DEBパッケージ生成
• 変動性: 複数バージョン、環境サポート
• マルチプラットフォーム
  • クロスコンパイル
  • 機能別でマシン選択
• 冗長性: クラスター、分散ビルド対応
• 拡張性、カスタマイズ性
  • android用のapkファイル生成

Hydraの仕組み

• .nixで定義されたパッケージセット(jobset)を評価します
• jobsetはセット、バリューはnix expression
• jobsetのすべてのnix expressionを評価

継続インテグレーション

• 自動的にソースを取得とビルド
• 前評価と比較
• log保存
• 失敗の場合にメンテナへメール送信

ビルドファーム

• ビルドされたパッケージとクロージャー（パッケージと依存）をダウンロード可
• 自動的にチャンネル生成
• 任意チャンネル生成
• リリース

Jobset

• セット(関数で生成可能)
• 例、Hydra用の
  • nixpkgs jobsetとその結果
  • nixops jobsetとその結果
• nixpkgsのpkgs.releaseToolsにヘルパー関数
  • aggregate: 複数のジョブを一つにまとめます

Hydraのコンポネント

• サーバ: ビルド結果と情報を確認できるWebアプリケーション
• queue-runner: インプットの変更をチェック、ビルドを管理する
• evaluator: ジョブを評価する
• Nix Daemon: パッケージと依存関係をビルド(Nix)

Hydraで生成できる物

• Nixパッケージで生成できるすべての物
  • ソースパッケージ
  • バイナリパッケージ
  • マニュアル
  • ドキュメンテーション
  • ユニットテスト
  • ...

インストール

• Nixが必要、NixOSがおすすめ

  • NixOSコンテナー内ではHydraを利用できません

• NixOSのnixos-unstableであれば、モジュールがあります

  • NixOS 16.09に正式入る予定です

• 基本設定(configuration.nix):

  services.hydra = {
    enable = true;
    hydraURL = "hydra.example.org";
    notificationSender = "[email protected]";
  };

NixOpsでインストール例

• examples/single
• examples/cluster

Webインターフェイス

• Perlで書かれています
• Elmでテンプレートを書き直し中
• Projects - Jobsets
• ProjectはJobsetの箱です

Webインターフェイス - Project

• enabled: プロジェクトを有効にする
• identifier: 識別子
• display name: Webインターフェイスに利用されるプロジェクト名
• description: プロジェクト概要
• homepage: プロジェクトのホームページ
• owner: プロジェクトの所有者

Webインターフェイス - Jobset

• state: Jobsetのステート
• inputs: Jobsetの変数
  • 一つは評価するNix expressionのソース
  • 残りはNix expressionの引数
• Nix expression: ビルドするNix expression (jobsetファイル)
  • FILE.nix in INPUT
• shares: 利用できるCPUパワーの割合
• 宣言的jobsetも利用できます

Jobsetソース: 三つのアプローチ

• カスタムnixpkgsベース
• 単独ソフトウェア
• カスタムパッケージセット

nixpkgsベース

• 変更したnixpkgsに独自release.nixを作成
• Hydraでビルド

単独ソフトウェア

• nixで管理するように
  • shell.nix: 開発環境用のnixファイル
  • build.nix: プロジェクトをビルドできるnixファイル
  • release.nix: Hydraのjobsetファイル
• サンプル: binserver

カスタムパッケージセット

• nixpkgsの構造を真似て作る
  • パッケージセットを定義し、外部ソースを取得
• サンプル
  • hydra-pg
  • vuizvui

リンク集

• 2016年

  • Hydra: Setting up your own build farm video

• 2014年

  • Hydra: Continuous Integration and Testing for Demanding People: The Details

• 2013年

  • NixOS + Hydra + Nginx
  • Setting up a Hydra build cluster 1
  • Setting up a Hydra build cluster 2
  • Setting up a Hydra build cluster 3

• 2008年

  • The Nix Build Farm: A Declarative Approach to Continuous Integration

• 2007年

  • Automated Software Testing and Release with Nix Build Farms

Questions - Free talk