docker-upsource

Easy upsource deployment using docker

These Dockerfiles allow you to easily build images to deploy your own upsource instance.

Disclaimer

Besides that, as always, use these scripts with care.

Don't forget to back up your data very often, too.

Requirements

Docker has to run. It supports many platforms like Ubuntu, Arch Linux, Mac OS X, Windows, EC2 or the Google Cloud. Click here to get specific infos on how to install on your platform.

Oh nice! How do I do it?

1. Install docker. It's not very hard.
2. Run it! (Stop with CTRL-C, repeat at pleasure)

docker run -t -i -p 8080:8080 dzwicker/docker-upsource

Now open your browser and point it to http://localhost:8080 and rejoice. :)

Do it as service in ubuntu/debian

1. Create directory to store data

mkdir -p /var/lib/upsource
mkdir -p /var/log/upsource
mkdir -p /etc/upsource

2. Permissions!

The Dockerfile creates a upsource user to run upsource without root permissions. This user has a UID of 2000. Please make sure to add a user to your host system with this UID and allow him to read and write to /var/lib/upsource and /etc/upsource. The name of this host user in not important. (You can use a the user group, too. It has the GID of 2000 :)

3. Create container!

  docker create -t -i -p 127.0.0.1:8080:8080 \ 
  	-v /var/lib/upsource:/var/lib/upsource \ 
  	-v /var/log/upsource:/var/log/upsource \
  	-v /etc/upsource:/usr/local/upsource/conf \
  	-v /tmp:/tmp \
  	--name docker-upsource \
  	dzwicker/docker-upsource
  ```

4. Create upstart configuration `/etc/init/docker-upsource.conf`

  ``` bash
  description "Docker Upsource"
  start on filesystem and started docker
  stop on runlevel [!2345]
  respawn
  script
    /usr/bin/docker start -a docker-upsource >>/var/log/upsource/docker-upsource.log 2>&1
  end script

  ```
5. (optional) Setup logrotate e.g. `/etc/logrotate.d/docker-upsource`


  ```
  /var/log/upsource/*.log
  /var/log/upsource/cassandra/*.log 
  /var/log/upsource/hub/*.log 
  /var/log/upsource/hub/logs/*.log
  /var/log/upsource/upsource-analyzer/*.log 
  /var/log/upsource/upsource-frontend/*.log 
  /var/log/upsource/upsource-monitoring/*.log 
  /var/log/upsource/vcs-settings/*.log 
  /var/log/upsource/vcs-settings/logs/*.log
  /var/log/upsource/internal/services/bundleProcess/*.log {
  	rotate 7
  	daily
  	missingok
  	notifempty
  	sharedscripts
  	copytruncate
  	compress
  }
  ```
6. (optional) Add vhost to nginx

  `mkdir -p /var/log/nginx/your-domain`

  ```
  upstream docker-upsource {
    server localhost:8080;
  }

  server {
    listen 80;
    server_name           your-domain.com;

    access_log            /var/log/nginx/your-domain/access.log;
    error_log             /var/log/nginx/your-domain/error.log;

    proxy_set_header Host       $http_host;   # required for docker client's sake
    proxy_set_header X-Real-IP  $remote_addr; # pass on real client's IP

    client_max_body_size 0; # disable any limits to avoid HTTP 413 for large image uploads

    # required to avoid HTTP 411: see Issue #1486 (https://github.com/dotcloud/docker/issues/1486)
    chunked_transfer_encoding on;

    location / {
    	# to proxy WebSockets in nginx
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
            
      proxy_pass http://docker-upsource;
    }

  }
  ```
7. Configuring New Upsource Server
  
  Follow the steps of the installation [instructions for Jetbrains Upsource](https://www.jetbrains.com/upsource/help/2.0/configuration_wizard.html) using paths located under `/var/lib/hub/data`, `/var/lib/hub/backups`, `/var/log/hub`, `/tmp`.