Configuration

Settings

The application is configured via environment variables. The following application settings are mapped to environment variables.

Setting	Env Variable	Required?
db.common.url	DB_URL	yes
db.readonly.url	DB_READONLY_URL	no
db.super.url	DB_SUPER_URL	no
shared_directory	SHARED_DIR	yes
debug	DEBUG	no
logging.level	DEBUG	no
sentry.dsn	SENTRY_DSN	no
celery.broker	AMQP_URL	yes

See cnx-db configuration docs for more information about configuring the database features.

For information on how the configuration is coded see, press.config.configure().

Logging

The logging configuration is by default set to INFO level logging. If you wish to receive DEBUG level logging you should set the DEBUG environment variable to true.

Celery Asynchronous Tasks

We use Celery with an AMQP enabled queue (i.e. RabbitMQ) to provide components of our application to run as asynchronous tasks outside the scope of a request and response cycle. This is configured via AMQP_URL (e.g. amqp://guest@rabbitmq:5672//).

For information about how to use implement tasks, see Asynchronous Tasks and the press.tasks.task() decorator.

Error Reporting

This application contains integration code to report errors to a Sentry instance. The integration can be configured by supplying the SENTRY_DSN, which is usually provided to you during your projects setup in the sentry software.