Skip to content

0.29.0 Migration Guide

Changes

  • The output of run:detached now uses the container name - eg. node-js-app.run.1 - vs the container id.
  • The ID of cron tasks is now base36-encoded instead of base64-encoded.
  • The nginx.conf.sigil is now extracted when source code is extracted for a build and not from the built image. Users can specify alternative paths via the nginx-conf-sigil-path property of the nginx plugin. See the nginx documentation for more information on how to configure the nginx.conf.sigil path for your application.
    • For deploys via git:from-image, the nginx.conf.sigil file will be extracted from the source image, respecting the value of nginx-conf-sigil-path.
  • The Procfile is now extracted when source code is extracted for a build and not from the built image. Users can specify alternative paths via the procfile-path property of the ps plugin. See the process management documentation for more information on how to configure the Procfile path for your application.
    • For deploys via git:from-image, the Procfile file will be extracted from the source image, respecting the value of procfile-path.
  • The existing pre-restore hook has been renamed to scheduler-pre-restore. There is a new pre-restore hook that is triggered within the ps:restore command prior to restoring any apps.
  • Nginx init commands are now performed via systemctl on Ubuntu systems when /usr/bin/systemctl is available.

Removals

  • The DOKKU_WAIT_TO_RETIRE environment variable has been migrated to a checks property named wait-to-retire and will be ignored if set as an environment variable.
  • The domains-setup trigger has been removed. Initial app domains will now be automatically setup during app creation.
  • The URLS file containing generated urls for an app is no longer generated or referenced. Users should retrieve app urls via the new domains-urls plugin trigger.
  • The common function get_app_urls has been removed. Users should retrieve app urls via the new domains-urls plugin trigger.