Test Harness

This Docker image is a test harness for your self-hosted application. It runs a script that verifies your deployment. If it succeeds, your CI pipeline continues. If it fails, you'll get logs.

Step 1: Authenticate with AWS ECR

Before pulling the image, authenticate your Docker CLI to your AWS ECR registry.

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws/databrain

Step 2: Pull the Docker Image

Go to public ECR: https://gallery.ecr.aws/databrain/dbn-test

docker pull public.ecr.aws/databrain/dbn-test:1.1.9 // use newest tag

Step 3: Run the Container with Required ENV Variables

The container expects some environment variables to be passed for the test to work.

version: '3.8'

services:
  test-runner:
    image: public.ecr.aws/databrain/dbn-test:1.1.9 // use newest tag
    environment:
      TEST_HOST: https://your-selfhosted-url.com
      TEST_DEMO_HOST: https://your-selfhosted-url.com/demo
      TEST_DEMO_TOKEN: 537ks6v3-8614-c535-4870-d47730bd0c70&dashboardId=selfhosted-dashboard
      TEST_USER_EMAIL: [email protected]
      TEST_USER_NAME: CompanyName
      TEST_DELETE_USER_AUTH_TOKEN_SELFHOSTED: delete_token_9so$sm
      TEST_USER_PASSWORD: Company@123
      TEST_NEW_USER_COMPANY: newCompanyName
      TEST_NEW_USER_EMAIL: [email protected]
      TEST_NEW_USER_NAME: newSelfhosted
      TEST_NEW_USER_PASSWORD: newSelfhosted@123
      TEST_NEW_USER_RESET_PASSWORD: resetSelfhosted@123
      TEST_ROLE_USER_EMAIL: [email protected]

    restart: "no"

Run on Github Actions:

- name: Run Application Tests via Docker
  run: |
    docker run --rm \
      -e TEST_HOST=${{ secrets.TEST_HOST }} \
      -e TEST_DEMO_HOST=${{ secrets.TEST_DEMO_HOST }} \
      -e TEST_DEMO_TOKEN=${{ secrets.TEST_DEMO_TOKEN }} \
      -e TEST_USER_EMAIL=${{ secrets.TEST_USER_EMAIL }} \
      -e TEST_USER_NAME=${{ secrets.TEST_USER_NAME }} \
      -e TEST_DELETE_USER_AUTH_TOKEN_SELFHOSTED=${{ secrets.TEST_DELETE_USER_AUTH_TOKEN_SELFHOSTED }}
      -e TEST_USER_PASSWORD=${{ secrets.TEST_USER_PASSWORD }} \
      -e TEST_NEW_USER_COMPANY=${{ secrets.TEST_NEW_USER_COMPANY }} \
      -e TEST_NEW_USER_EMAIL=${{ secrets.TEST_NEW_USER_EMAIL }} \
      -e TEST_NEW_USER_NAME=${{ secrets.TEST_NEW_USER_NAME }} \
      -e TEST_NEW_USER_PASSWORD=${{ secrets.TEST_NEW_USER_PASSWORD }} \
      -e TEST_NEW_USER_RESET_PASSWORD=${{ secrets.TEST_NEW_USER_RESET_PASSWORD }} \
      -e TEST_ROLE_USER_EMAIL=${{ secrets.TEST_ROLE_USER_EMAIL }} \
      public.ecr.aws/databrain/dbn-test:1.1.9