dokku/docs/development/testing.md

Dokku test suite

Dokku now has a full test suite to assist in quick iterating development. These tests include a linter using shellcheck, functional unit tests using the bats testing framework, and a deployment suite of example apps that use the most popular languages and frameworks.

Bats tests can be found here:

tests/unit/*.bats

Example apps can be found here:

tests/apps/

Executing tests locally

• Setup dokku in a vagrant vm

• Test setup and execution

  vagrant ssh
  sudo su -
  cd ~/dokku
  make ci-dependencies setup-deploy-tests
  
  # execute the entire test suite (linter, bats tests, and app deployment tests)
  make test
  
  # run linter & update vagrant dokku install from local git clone
  make lint copyfiles
  
  # execute all bats tests
  make unit-tests
  
  # execute all app deployment tests
  make deploy-tests
  

• Additionally you may run a specific app deployment tests with a target similar to:

  $ make deploy-test-nodejs-express
  

• For a full list of test make targets check out tests.mk in the root of the dokku repository.