Packaging/Ruby: Difference between revisions

From NixOS Wiki
imported>Makefu
m Makefu moved page Packaging Ruby to Packaging/Ruby
imported>Max
added bundlerEnv group example
Line 90: Line 90:


After this change we build the package again.
After this change we build the package again.
=== Defining groups ===
Sophisticated applications use groups to organize their gems like <code>development</code>, <code>test</code> and
<code>production</code>.
<code>bundlerEnv</code> only makes the <code>default</code> group available in the environment, that is all gems which are '''not''' in a group.
To make other groups available, they need to be provided as an array. Don't forget to include the <code>default</code> group.
Example:
<syntaxHighlight lang=nix>
  gems = pkgs.bundlerEnv {
    name = "exampleApp";
    inherit ruby;
    gemfile = ./Gemfile;
    lockfile = ./Gemfile.lock;
    gemset = ./gemset.nix;
    groups = [ "default" "production" "development" "test" ];
  };
</syntaxHighlight>


=== set the local gemConfig ===
=== set the local gemConfig ===
'''TODO''': also merge with the <code>defaultGemConfig</code> somehow
'''TODO''': also merge with the <code>defaultGemConfig</code> somehow

Revision as of 12:41, 24 October 2018

Ruby projects are generally packaged with bundix. This guide will show how to package a ruby project

Building BeEF

$ git clone https://github.com/beefproject/beef/

Create shell.nix with all dependencies

we create a shell.nix in the project directory:

with import <nixpkgs> {};
stdenv.mkDerivation {
  name = "env";
  buildInputs = [
    ruby.devEnv
    git
    sqlite
    libpcap
    postgresql
    libxml2
    libxslt
    pkgconfig
    bundix
  ];
}

Build Gemfile.lock and gemset.nix

$ nix-shell
# generate Gemfile.lock
$ bundle install
# generate gemset.nix
$ bundix

Build default.nix

This will be the package configuration:

{ stdenv, bundlerEnv, ruby }:
let
  # the magic which will include gemset.nix
  gems = bundlerEnv {
    name = "beef-env";
    inherit ruby;
    gemdir  = ./.;
  };
in stdenv.mkDerivation {
  name = "beef";
  src = ./.;
  buildInputs = [gems ruby];
  installPhase = ''
    mkdir -p $out/{bin,share/beef}
    cp -r * $out/share/beef
    bin=$out/bin/beef
# we are using bundle exec to start in the bundled environment
    cat > $bin <<EOF
#!/bin/sh -e
exec ${gems}/bin/bundle exec ${ruby}/bin/ruby $i "\$@"
EOF
    chmod +x $bin
  '';
}

Build the package

$ nix-build -E '((import <nixpkgs> {}).callPackage (import ./default.nix) { })' --keep-failed
....
do_sqlite3 build FAILED!

Our Problem is that do_sqlite3 wants to build native extensions and requires sqlite as dependency. There are two ways to solve this issue:

  1. add a global override to your nixpkgs
  2. set the gemConfig for the bundleEnv manually

Adding a global override for a gem

We edit: <nixpkgs/pkgs/development/ruby-modules/gem-config/default.nix:

{
   ...
   do_sqlite3 = attrs: {
     buildInputs = [ sqlite ];
   };
   ...
}


After this change we build the package again.

Defining groups

Sophisticated applications use groups to organize their gems like development, test and production. bundlerEnv only makes the default group available in the environment, that is all gems which are not in a group. To make other groups available, they need to be provided as an array. Don't forget to include the default group.

Example:

  gems = pkgs.bundlerEnv {
    name = "exampleApp";
    inherit ruby;
    gemfile = ./Gemfile;
    lockfile = ./Gemfile.lock;
    gemset = ./gemset.nix;
    groups = [ "default" "production" "development" "test" ];
  };


set the local gemConfig

TODO: also merge with the defaultGemConfig somehow