/manta-mako

Manta storage.

Primary LanguageJavaScriptMozilla Public License 2.0MPL-2.0

manta-mako

This repository is part of the Joyent Manta project. For contribution guidelines, issues, and general documentation, visit the main Manta project page.

Mako can refer to this repository or the zone in Manta that stores Manta objects. The zone that stores objects is also known as a "storage" zone. Nginx is the server that actually puts and gets the objects to/from disk.

Repository

bin/            Commands available in $PATH, including commands that work
                in conjunction with Manta Garbage Collection
                (manta-mola.git)
boot/           Configuration scripts on zone setup.
deps/           Git submodules and/or commited 3rd-party deps should go
                here. See "node_modules/" for node.js deps.
node_modules/   Node.js deps, either populated at build time or commited.
                See Managing Dependencies.
sapi_manifests/ SAPI manifests for zone configuration.
smf/manifests   SMF manifests
test/           Test suite (using node-tap)
tools/          Miscellaneous dev/upgrade/deployment tools and data.
Makefile
package.json    npm module info (holds the project version)
README.md

Working with the nginx git submodule

mako uses Joyent's fork of nginx which has been modified to support some additional features:

  • Calculates the md5 checksum of the streamed body and reports it.
  • Ensures that all renames are atomic in the filesystem (proper use of fsync(2)).
  • Adds support for the multipart upload commit operation.

To understand how the nginx repository is managed and how we cut releases for use in mako, please read the README. When updating the nginx submodule in mako, the first step is to identify the release tag that you should use. Once that's been identified, you can update the submodule using something like the following flow:

$ git clone git@github.com:joyent/manta-mako.git
$ cd mako/
$ git submodule init
$ git submodule update
$ cd deps/nginx/
$ git checkout <tag>
$ cd ../..
$ git add deps/nginx
$ git diff --cached #to check the submodule git SHA

Then you can commit, test, and push like any other change.

Testing

To run the mako test suite, you need to be able to run nginx in your zone. The following should be run as a root user (or by a user who can use pfexec as the primary administrator):

  1. gmake release
  2. Manually edit build/nginx/conf/nginx.conf to clean up the sapi manifest
  3. mkdir /manta
  4. chmod 770 /manta
  5. chown nobody:staff /manta
  6. Manually start nginx, by running build/nginx/sbin/nginx
  7. Run the test suite by running gmake test
  8. When finished, kill the nginx processes with something like pkill -9 nginx
  9. When finished, clean out any left over temporary data via rm -rf /manta/*

Note, that the tests default to looking for nginx on http://localhost:80/. This can be overriden by setting the MAKO_HOST and MAKO_PORT environment variables. For example if you set MAKO_PORT=8080 and MAKO_HOST=1.2.3.4, we would instead look for a server at http://1.2.3.4:8080/.