Introduction

We at sandstorm|media use Dokku to deploy applications quickly and easily to our server. Nevertheless, it is often time-consuming to manually make applications ready for the deployment with Dokku or Heroku. Thus, we created this package to minimize your effort of making TYPO3 Flow and Neos based projects ready for deployment in a few seconds.

Prerequisites

A Flow version greater or equal to 3.0 is mandatory.

Usage

When using composer, you can conveniently add this package to your application by typing the following command in your command line:

composer require sandstorm/heroku

After adding this package to your application, make your project ready for Dokku with this command:

./flow heroku:addToProject

Deployment on Dokku

Now here are some instructions on how to deploy your application to Dokku:

Create your Dokku container

dokku create your-project-name

Create a volume for your persistent data

dokku volume:create your-project-name /app/Data/Persistent

Map your volume to the container

dokku volume:link your-project-name your-project-name

Create a database for your project

dokku mariadb:create your-project-name

Map the database to your project

dokku mariadb:link your-project-name your-project-name

Define a remote branch for your Dokku instance

git remote add dokku dokku (at) your-dokku-domain.de:your-project-name

Push your project to Dokku

git push dokku master

Optional: Access your project with ssh to configure your Flow instance

dokku enter your-project-name

Now, if you use any Flow commands be sure to always prefix FLOW_CONTEXT=Production/Heroku in order to address the correct context. Example:

FLOW_CONTEXT=Production/Heroku ./flow import:something Packages/Application/your-project-name/Tests/TestData/test.tab

support for gerrit_update.php and gerrit.json

PRUNE_AND_IMPORT_SITE=