Giter VIP home page Giter VIP logo

relx's Introduction

Build Status

Relx

A release assembler for Erlang.

Synopsis

relx [options] [release-specification-file]

Description

Relx assembles releases for an Erlang/OTP release. Given a release specification and a list of directories in which to search for OTP applications it will generate a release output. That output depends heavily on what plugins available and what options are defined, but usually it is simply a well configured release directory.

The release-specification-file is optional but otherwise contains additional specification information for releases.

Building

To build relx and generate a standalone escript executable:

$ ./rebar3 update
$ ./rebar3 escriptize

This creates the executable _build/default/bin/relx.

Building on Windows

To build relx on Windows you'll need to have rebar3 installed and the path to the rebar3 binary added to the PATH environment variable. To start the build use the bootstrap batch file:

c:\> bootstrap

This creates the executable relx and the relx.cmd shortcut script. Copy both of these files to a directory and make the directory available to the PATH environment variable.

Config File

By default relx looks for relx.config in the current working directory:

{release, {relname, "vsn"},
 [app1,
  app2]}.

{extended_start_script, true}.

Options

Short Long Type Default Description
-r --root string ./ Sets the root of the project
-n --relname string Name for the release that will be generated
-v --relvsn string Version for the release
-g --goal string A goal for the system. These are usually the OTP apps that are part of the release
-u --upfrom string The release to upgrade from. Only valid with relup target
-o --output-dir string ./ The output directory for the release
-l --lib-dir string Additional dirs to search for OTP apps
--system_libs boolean/string true If true include a copy of system libs used to build with, if a path include system libs at that path. If false, do not include system libs
-p --path string Additional dirs to add to Erlang code path
--default-libs boolean true Whether to use the default system added lib dirs (means you must add them all manually)
-V --verbose integer 2 The verbosity level between 0 and 3
-a --override_app string An app name and a directory to override in the form appname:dir
-c --config string ./relx.config Config file path
--overlay_vars string Path to a file of overlay variables
--vm_args string Path to a file to use for vm.args
--sys_config string Path to a file to use for sys.config
-d --dev-mode boolean false Symlink all applications and configuration into the release instead of copying
-i --include-erts boolean/string true If true include a copy of erts used to build with, if a path include erts at that path. If false, do not include erts

Wiki

relx wiki

relx's People

Contributors

bitwalker avatar byaruhaf avatar carlosedp avatar cloven avatar davebest avatar davidw avatar djnym avatar ericbmerritt avatar essen avatar evax avatar ferd avatar jaredmorrow avatar jaydoane avatar joedevivo avatar jwilberding avatar kiela avatar konradkaplita avatar kosmon avatar licenser avatar lrascao avatar lukebakken avatar nuex avatar rj avatar rlipscombe avatar saleyn avatar soranoba avatar syl20bnr avatar taure avatar tsloughter avatar zerotao avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.