This is an experimental minimalist Rubygems index and gem server for deploying private gems.
Authentication for auth-token generation is done by searching for a posixAccount with uid= in an LDAP directory, and if the user is found, trying to bind against the directory as that user using the provided password.
If you want to authenticate using some other mechanism, you'll need to replace the authentication bits in lib/gemserver/authentication.rb with your own code.
You can customize the look and feel by altering the templates and static content under the gem's data directory.
Auth tokens are stored in a SQLite database.
Some notable features:
- Serves gems and gem indexes, just like rubygems.org
- Supports uploading via 'gem push'
- Integrates with your LDAP directory for authentication
- Spiffy web interface which supports drag-and-drop, multi-file uploads for modern browsers, and degrades into a simpler upload form for older browsers.
- Not designed for or tested in high-traffic situations
- Not super-configurable; assumes you have an environment similar to ours or are willing to hack it a bit
- Getting 'gem push' to push to a different gemserver with a different authtoken is not trivial
gem install gemserver
The gem installs a 'gemserver' binary, which can be run out of the box with no configuration to test out the software, provided the machine it's running on has LDAP authentication configured correctly. It runs on all interfaces on port 9292, stores its gems under a temporary directory, and keeps an in-memory authtoken database.
Should you wish to run it in a permanent fashion, you'll want to create a
gemserver.conf file in the directory you wish to run it from that allows
customization of what interface and port it listens to, where it keeps its
gems and authentication tokens, etc. An example config is distributed with the
gem (under data/gemserver/gemserver.conf.example).
You'll likely want to run it behind a reverse proxy that wraps it in SSL like we do, as it currently just does Basic HTTP authentication.
After checking out the source, run:
$ rake newb
This task will install any missing dependencies, run the tests/specs, and generate the API documentation.
Make it more configurable:
- Pluggable authentication
- Configurable authtoken storage
Copyright (c) 2010, 2011, Michael Granger All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the author/s, nor the names of the project's contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.