This document contains information related to projects based on the Ubuntu 14.04 image. If you are using the Ubuntu 18.04 image for your projects, please refer to this page.
If you are using the Ubuntu 14.04 image and you want to switch to Ubuntu 18.04, be sure to check our upgrade guide.
Semaphore supports 2 versions of PostgreSQL:
The default version is 9.6, and it's running on port of 5432.
Versions can be changed by adding change-pg-version <version> to your setup commands:
This will shut down the currently active version, start version 10, and export PGCLUSTER=10. After this, the whole PostgreSQL toolchain will be switched to version 10, and port 5432 will be served by the newly selected version as well.
Note that adding this command to a script currently isn't supported.
Credentials for using PostgreSQL are available in environment variables listed below:
If your application doesn't create its own database as part of the start-up process, you can create a PostgreSQL database manually. Adding the following command to your build commands will create a PostgreSQL database:
createdb test_db -U $DATABASE_POSTGRESQL_USERNAME
Note that the createdb command doesn't require password, since PostgreSQL doesn't require password for accessing a database that belongs to the PostgreSQL user that has the same name as host operating system user, by default.
Add a build command which looks something like:
psql -c "some command" -d $DATABASE_NAME_TEST -P pager
List of all packages and versions is available on the supported application stack page.
In case your database setup enables the hstore extension in structure.sql, but it does not work as expected, please check if you have something similar to following in your structure.sql file:
CREATE EXTENSION IF NOT EXISTS hstore WITH SCHEMA public;
The hstore extension is enabled by default, which prevents your structure.sql to re-create it with the public schema, due to:
CREATE EXTENSION IF NOT EXISTS
A simplified solution would be to drop the existing extension, as the first step in the setup, and let structure.sql do its thing afterwards.
psql -c 'DROP EXTENSION hstore' -d template1
Semaphore Docs are open source — Edit on GitHub