LVM - Language Version Manager

Facilitate the use of different language versions so they work as if they were installed directly on the host.

When executing a command, LVM creates a container with PWD mounted with network host by default, creates a "fake" user home to mount on every command and set HOME variable to fake user home.

Install

VERSION=0.0.2
curl -SL https://github.com/thiago/lvm/releases/download/v${VERSION}/lvm_${VERSION}_`uname -s`_`uname -m`.tar.gz | tar xzv -C /usr/local/bin/ lvm

Usage

LVM is configured with .yml|.json file. By default search lvm.yml in the current directory or $HOME.

You can create any service to use as a command from the cli.

The configuration has this structure

type config struct {
    Services map[string]struct {
        // Image of the container
        Image string
        // Short description for the service
        Short string
        // Long description for the service
        Long string
        // Aliases is a list of subcommands for the service like npm, pip, ...
        Aliases []string
        // Env is a list of environment variables to set in the container
        Env []string
        // Cache is a list of folders to cache
        Cache []string
        // PreCmd is executed before command
        PreCmd string
        // Entrypoint overwrite image ENTRYPOINT
        Entrypoint []string
        // Category is a way to categorize commands
        Category string
    }
}

Configuration example

Services:
  node:
    Image: node
    Short: NodeJS image
    Aliases:
      - npm
      - yarn

For more examples, please refer to lvm.yml.

Download the default configuration

$ curl https://raw.githubusercontent.com/thiago/lvm/master/lvm.yml -o $HOME/lvm.yml

Using services

Execute something like:

$ lvm node -v

$ lvm npm install -g gulp

Use -s to skip the command and execute arguments directly

$ lvm -s npm gulp -v

Use sh (or bash if the image has) to access the container

$ lvm -s npm sh

You can change network mode to bridge by passing the ports to the command line

$ lvm -p 80:9090 python -m http.server 9090

Change image service tag

$ lvm -t 6 node -v

Global options

   --cache value  Cache folder (default: "/Users/trsouz/.lvm") [$LVM_CACHE]
   -d, --detach   Detached mode: Run container in the background, print new container name. [$LVM_DETACH]
   -e value, --env value  Set environment variables [$LVM_ENVS]
   --entrypoint value Overwrite the default ENTRYPOINT of the image [$LVM_ENTRYPOINT]
   -k, --keep   Don't remove the container after exit [$LVM_KEEP]
   -p value, --port value Expose ports in bridge mode [$LVM_PORTS]
   -s, --skip-cmd Skip command name in the command prefix [$LVM_SKIP_CMD]
   -t value, --tag value  Overwrite the default tag of the image [$LVM_TAG]
   -u value, --user value Username or UID (format: <name|uid>[:<group|gid>]) (default: "$(id -u):$(id -g)") [$LVM_USER]
   --help, -h   show help
   --version    print the version

Development

$ make deps
$ make binary

Run the lint tools to ensure that the code is correct

$ make depslint
$ make lint

For more commands, please refer to make help.

Please let me know if you have any questions or suggestions. issues

thiago / lvm