minio/DEVELOPERS.md
2014-11-30 16:37:01 -08:00

3.1 KiB

Build Dependencies

Minio build depends on yasm and Go 1.3+

Install yasm

Yasm is a Modular Assembler used for compiling Intel Storage Acceleration Library

$ sudo apt-get install yasm
Install Go 1.3+ (Ubuntu)

Download the archive and extract it into /usr/local, creating a Go tree in /usr/local/go. For example:

$ tar -C /usr/local -xzf go$VERSION.$OS-$ARCH.tar.gz

Choose the archive file appropriate for your installation. For instance, if you are installing Go version 1.2.1 for 64-bit x86 on Linux, the archive you want is called go1.2.1.linux-amd64.tar.gz

(Typically these commands must be run as root or through sudo.)

Add /usr/local/go/bin to the PATH environment variable. You can do this by adding this line to your /etc/profile (for a system-wide installation) or $HOME/.profile:

$ export PATH=$PATH:/usr/local/go/bin
Setting up GOPATH environment variable

The GOPATH environment variable specifies the location of your workspace. It is likely the only environment variable you'll need to set when developing Go code.

To get started, create a workspace directory and set GOPATH accordingly. Your workspace can be located wherever you like, but we'll use $HOME/mygo in this document. Note that this must not be the same path as your Go installation.

$ mkdir $HOME/mygo
$ export GOPATH=$HOME/mygo

For convenience, add the workspace's bin subdirectory to your PATH:

$ export PATH=$PATH:$GOPATH/bin

For more detailed documentation refer GOPATH

Installing Minio (Source)

Get directly from GitHub:

Once we are finished the prerequisites in the previous step we now build minio

$ go get -u github.com/minio-io/minio
$ cd $GOPATH/src/github.com/minio-io/minio
$ make
...

Clone locally (for contributors):

$ git clone https://github.com/minio-io/minio
$ cd minio
$ make

Because Go expects all of your libraries to be found in either $GOROOT or $GOPATH, it's necessary to symlink the project to the following path:

$ ln -s /path/to/your/minio $GOPATH/src/github.com/minio-io/minio

Contribution Guidelines

We welcome your contributions. To make the process as seamless as possible, we ask for the following:

  • Go ahead and fork the project and make your changes. We encourage pull requests to discuss code changes.

    • Fork it
    • Create your feature branch (git checkout -b my-new-feature)
    • Commit your changes (git commit -am 'Add some feature')
    • Push to the branch (git push origin my-new-feature)
    • Create new Pull Request
  • When you're ready to create a pull request, be sure to:

    • Have test cases for the new code. If you have questions about how to do it, please ask in your pull request.
    • Run go fmt
    • Squash your commits into a single commit. git rebase -i. It's okay to force update your pull request.
    • Make sure go test ./... passes, and go build completes.
NOTE

This document assumes that minio user is using Ubuntu 12.04 or 14.04 LTS release