//Cloudogu EcoSystem Docs

Setup for the integration tests

This section describes the steps required to properly run the integration tests.


  • It is necessary to install the program yarn


In order for all integration tests to work properly, some configuration has to be set before starting them.

Configure cypress.json


  • The base URL must be adapted to the host system.

    • For this the field baseUrl has to be adjusted to the host FQDN (e.g. https://local.cloudogu.com).
  • DoguName - Determines the name of the current dogu and will be used in routing.
  • MaxLoginRetries - Determines the number of login attempts before a test fails.
  • AdminUsername - The username of the CES admin.
  • AdminPassword - The password of the CES admin.
  • AdminGroup - The user group for CES administrators.

Set admin role

For the integration tests to succeed, the admin_role key has to be set:

  • Set the admin role via etcdctl set /config/backup/admin_role IntegrationTestAdmin
  • Restart the dogu via docker restart backup

Starting the integration tests

The integration tests can be started in two ways:

  1. with yarn cypress run the tests start only in the console without UI feedback. This mode is useful when execution is the main focus, for example, in a Jenkins pipeline.
  2. yarn cypress open starts an interactive window where you can run, visually observe and debug the tests. This mode is especially useful when developing new tests and finding bugs.

Updating included tests from the test library

From time to time it is necessary to update the test library @cloudogu/dogu-integration-test-library.

Update the test library with the following call and don't forget to commit any changes to the tests.

yarn run updateTests