Skip to main content

Edit Routine

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

Prerequisites

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.

Job​

tip

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.
      tip

      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.

Step​

tip

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.

info

For routine YAML syntax, see Routine YAML syntax.

example.yaml
name: sample routine

on:
  workflow_dispatch:

env:
  YOUR_CUSTOM_ENV: 'custom env global'

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

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