Skip to main content

Edit Routine

You can create routines in the Dogu console in two ways.


To create and execute routines, you need to link a Git repository that contains your test scripts.

For more details, please refer to the Git Integration document.

Writing in the GUI editor

A GUI editor is provided for users who are not familiar with YAML syntax. In the GUI editor, you can use basic functions such as installing and running apps and running test scripts.

If you want to use actions or arguments that are not provided by the GUI editor, you must use the YAML editor.

  1. Enter a routine name.
  2. Add or delete tasks, or change their location.
  3. Add, delete or reposition steps within the job.



Tasks run in parallel unless they are linked as predecessors.

  1. Job name
    • You can enter or edit the task name.
  2. Predecessor job
    • You can select a predecessor before executing the task. You can select multiple actions.
    • When the selected task is completed, the task will be executed.
  3. Browser or app package name
    • For web template: You can choose the browser in which the job will run.
    • For mobile app, game templates: You can select the app package name where the task will be executed.

      Automatically downloads the app with the latest build version from the list of apps with the same package name.

  4. Device
    • You can choose the device or device tag on which the job will run.
    • If group execution is disabled, one device with the selected tag will be randomly chosen to execute the job. If you select a specific device, that device will be used for execution.
    • If group execution is enabled, all devices with the selected tag from devices allocated to the project or public devices will be used for execution.
  5. Record device screen
    • Choose whether to record the device screen when the task is executed.
    • If you enable the recording option, you can view the video on the device job result page.



Steps are executed sequentially.

  1. Step name
    • You can enter or edit the step name.
  2. Step types
    • You can choose between actions and shell commands.
  3. Actions
    • Define what the step should do.
    • The GUI editor provides three options:
      • Run test (Recommended): Execute the test script.
      • Prepare: Install and run the app. Select the app version to install for the job.
      • Checkout: Fetch the repository linked from the Git storage.
  4. Shell commands
    • Enter the shell command to be executed in this step.

Writing in the YAML editor

With the YAML editor, you can use various actions and arguments not provided by the GUI editor.


For routine YAML syntax, see Routine YAML syntax.

name: sample routine


YOUR_CUSTOM_ENV: 'custom env global'

group: android
android: 1.0.0
- name: test-tutorial
uses: dogu-actions/run-test
cwd: appium/typescript/jest
checkout: true
clean: true
environment: node
command: |
yarn install
yarn test
- name: custom-cli
run: echo hi
YOUR_CUSTOM_ENV: 'custom job env'

- my-device-name
browserName: chrome
- name: chrome-test
uses: dogu-actions/run-test
cwd: selenium/python/pytest
checkout: true
clean: true
environment: python
command: |
pip install -r requirements.txt