Collins

Overview

Published documentation follows the most recent release of collins.

For documentation on developing, building, general architecture and unreleased changes please use the wiki. This documentation is in flux, currently lacking and constantly being worked on.

All documentation links point to the most recent release.

Quickstart

Docker

Use a Zip

Build from Source

Docker Image

Details about the docker container and building your own container are available in the documentation

tl;dr: docker run -p 9000:9000 tumblr/collins

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Support/Questions

Email collins-sm@googlegroups.com or see the mailing list archive at https://groups.google.com/forum/#!forum/collins-sm

Internal (Tumblr) docs

To create a production zip and deploy to production:

ensure capistrano 2.15.5 is installed
ensure net-ssh < 2.7.0 is installed - versions 2.7.0 and above are broken with our environment
download the minimal package for play activator 1.3.6 from here. Unpackage it into ~/src/activator-1.3.6-minimal or define $PLAY_CMD with an alternate location
run ./scripts/package.sh which will produce target/collins.zip
run cap publish:collins which will upload and link to release to http://repo.tumblr.net:8888/collins.zip
run cap ewr01 deploy to deploy to ewr01 and cap d2 deploy to deploy to d2