comsolit_deploy: A Shell repository from comsolit AG

THIS REPO IS UNMAINTAINED / A NEW MAINTAINER IS NEEDED

Introduction

This is a no-frills, minimal deployment script. It's written in shell script. The only requirement on the server side is git (>= 1.7).

Deployment is done by tagging a version and pushing this tag to a target branch on the web server. A git hook on the web server does a git checkout of the pushed commit and afterwards switches a symlinks to the newly checked out version.

This deployment script also offers activation of a maintenance page while deployment is running. This is optional.

Getting started

1. Prepare your git repository

clone this repo.
cd into the git project that you want to deploy.
run the comsolit_deploy/src/prepare_project from this repo.
edit the created files in your repo under .deploy/
create folders in .deploy/ with names of the branches you want to push e.g. "dev" or "master"
make sure to set the [deploy].root setting in .deploy/config e.g. root = /srv/vhosts/website/target
if you don't use tags delete the tags config lines

2. Prepare the server

Make sure you can ssh to the server
run comsolit_deploy/src/initial_setup $SSHCONNECT_STRING $PATH_ON_SERVER
- run this script with absolute path!!
- SSHCONNECT_STRING is what you'd use when connecting with ssh. (Edit your ~/.ssh/config to set a port other then 22, see man ssh_config.)
- if this doesn't work, clone and checkout the comsolit_deploy Repository direct from github to a folder comsolit_deploy.git
- if initial_setup is executed with an relative path e.g: ../comsolit_deploy/src/initial_setup from another git repo, the repo with the current path will be pushed
add the webserver repo as a git remote: git remote add $NAME ssh://$SSHCONNECT_STRING/$PATH_ON_SERVER/project.git
add your hookscripts "post-checkout" and "post-switch" for example in .deploy/hooks/
- hookscripts are just shell-scripts and you have some variables like branchname ect.
- there are a few examples in this package
make sure the hookscript is executable

3. Prepare your server configuration for maintenance page (optional)

create an own host directory for maintenance page e.g.

<Directory /srv/vhosts/website/target/dev/maintenance>
     AllowOverride all
     Require all granted
     Options -Indexes +FollowSymlinks
</Directory>

add an alias and conditions to redirect to a route with your alias.

<VirtualHost *:80>
    Alias /wartung /srv/vhosts/website/target/dev/maintenance
    RewriteEngine On
    RewriteCond %{REQUEST_URI} !^/wartung
    RewriteCond /srv/vhosts/website/target/dev/.maintenance -f
    RewriteRule ^/(.*) /wartung [L,R=307]**

    ServerAlias website.ch
    ServerName website.ch
    DocumentRoot /srv/vhosts/website/target/dev/current
    <Directory /srv/vhosts/website/target/dev/current>
            AllowOverride all
            Options -Indexes +FollowSymlinks
            Require all granted
    </Directory>
</VirtualHost>

comsolit/comsolit_deploy

THIS REPO IS UNMAINTAINED / A NEW MAINTAINER IS NEEDED

Introduction

Getting started