Phabricator Cloudron App

This repository contains the Cloudron app package source for Phabricator.

Installation

or using the Cloudron command line tooling

cloudron install --appstore-id org.phabricator.cloudronapp

Building

The app package can be built using the Cloudron command line tooling.

cd phabricator-app

cloudron build
cloudron install

Why the SQL dump

A Phabricator admin needs to enable one of the auth methods on installation. In a Cloudron app, we want to auto-enable and configure LDAP. This is tricky because Phabricator does not allow the admin user to login anymore if we setup LDAP automatically. This leaves a system with no admin user. (admin user required to enable various permisions).

See https://secure.phabricator.com/T8282 and https://secure.phabricator.com/T5310

To hack this:

• We create an admin user
• Dump the sql database
• Import this database on first run
• This approach allows the admin user to link to an LDAP account and grant admin previleges to others.

Creating the SQL Dump

• Start in developmentMode
• cloudron exec -- /app/code/start.sh --no-import-db
• cloudron open to create administrator account
  • Username superadmin
  • Password changeme123
  • email as admin@server.test
• Setup the auth providers (in the exact order as below)
  • Add username/password provider (just add with defaults)
  • Add LDAP provider (leave everything empty, just add with defaults). Check mark trust emails
• Stop the previous cloudron exec
• In another shell, cloudron exec -- bash -c 'mysqldump --all-databases -h${MYSQL_HOST} -u${MYSQL_USERNAME} -p${MYSQL_PASSWORD}' > db_seed.sql
• DB_PREFIX=$(cloudron exec -- bash -c 'echo $MYSQL_DATABASE_PREFIX')
• Finally,

    sed -e "s/\`${DB_PREFIX}/\`dbprefixgoeshere_/" -i db_seed.sql

• Commit db_seed.sql
• Build the docker image again (so it has the new seed file)

Testing

The e2e tests are located in the test/ folder and require nodejs. They are creating a fresh build, install the app on your Cloudron, perform tests, backup, restore and test if the repos are still ok. The tests expect port 29418 to be available.

cd phabricator-app/test

npm install
USERNAME=<cloudron username> PASSWORD=<cloudron password> mocha --bail test.js