4245 - E2E Testing framework and test runner in Github Actions

.github/workflows/e2e.yml

@@ -0,0 +1,91 @@
+name: Run E2E Tests
+
+on:
+  pull_request:
+    branches:
+      - 'development'
+    workflow_dispatch:
+      inputs:
+        force_refresh:
+          description: 'Force database refresh'
+          required: false
+          default: false
+          type: boolean
+
+jobs:
+  tests:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID_DEV }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_DEV }}
+          aws-region: eu-west-1
+
+      - name: Cache test database
+        id: cache-db
+        uses: actions/cache@v3
+        with:
+          path: ./db/backup
+          key: test-db-${{ runner.os }}-v1-${{ hashFiles('src/test/e2e/docker-compose.test.yml') }}
+          restore-keys: |
+            test-db-${{ runner.os }}-v1-
+            test-db-${{ runner.os }}-
+
+      - name: Download and decrypt test database
+        if: steps.cache-db.outputs.cache-hit != 'true' || ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.force_refresh == true }}
+        run: |
+          mkdir -p ./db
+          aws s3 cp s3://fra-platform-s3-developer-assets/test-assets/database/backup.gpg ./db/backup.gpg
+          ./src/tools/heroku/decrypt.sh ./db/backup.gpg
+        env:
+          BACKUP_PASSPHRASE: ${{ secrets.BACKUP_PASSPHRASE }}
+
+      - name: Build and start containers
+        run: docker compose -f src/test/e2e/docker-compose.test.yml up -d
+        env:
+          NPM_GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}
+
+      - name: Wait for services to be ready
+        run: |
+          timeout 300 bash -c 'until docker compose -f src/test/e2e/docker-compose.test.yml ps web | grep -q "healthy"; do sleep 5; done'
+
+      - name: Create test results directory
+        run: mkdir -p playwright-report
+
+      - name: Run database migrations
+        run: docker compose -f src/test/e2e/docker-compose.test.yml exec -T web yarn migration-steps:run
+
+      - name: Run E2E tests
+        if: always()
+        run: |
+          docker compose -f src/test/e2e/docker-compose.test.yml run \
+            playwright npm run test:e2e
+        env:
+          NPM_GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}
+
+      - name: Zip test results
+        if: always()
+        run: |
+          cd src/test/e2e
+          zip -r ../../../playwright-results.zip test-results/
+
+      - name: Upload test results
+        if: always() && !env.ACT
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-results
+          path: playwright-results.zip
+          retention-days: 30
+
+      - name: Stop containers
+        if: always()
+        run: docker compose -f src/test/e2e/docker-compose.test.yml down -v
+
+      - name: Cleanup database backup
+        if: always()
+        run: |
+          rm -rf ./db

.github/workflows/test.yml

@@ -0,0 +1,72 @@
+name: Run Tests
+
+on:
+  pull_request:
+    branches-ignore:
+      - 'master'
+      - 'production'
+    workflow_dispatch:
+      inputs:
+        force_refresh:
+          description: 'Force database refresh'
+          required: false
+          default: false
+          type: boolean
+
+jobs:
+  tests:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID_DEV }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY_DEV }}
+          aws-region: eu-west-1
+
+      - name: Cache test database
+        id: cache-db
+        uses: actions/cache@v3
+        with:
+          path: ./db/backup
+          key: test-db-${{ runner.os }}-v1-${{ hashFiles('src/test/e2e/docker-compose.test.yml') }}
+          restore-keys: |
+            test-db-${{ runner.os }}-v1-
+            test-db-${{ runner.os }}-
+
+      - name: Download and decrypt test database
+        if: steps.cache-db.outputs.cache-hit != 'true' || ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.force_refresh == 'true' }}
+        run: |
+          mkdir -p ./db
+          aws s3 cp s3://fra-platform-s3-developer-assets/test-assets/database/backup.gpg ./db/backup.gpg
+          ./src/tools/heroku/decrypt.sh ./db/backup.gpg
+        env:
+          BACKUP_PASSPHRASE: ${{ secrets.BACKUP_PASSPHRASE }}
+
+      - name: Build and start containers
+        run: docker compose -f src/test/e2e/docker-compose.test.yml up -d
+        env:
+          NPM_GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}
+
+      - name: Wait for services to be ready
+        run: |
+          timeout 300 bash -c 'until docker compose -f src/test/e2e/docker-compose.test.yml ps web | grep -q "healthy"; do sleep 5; done'
+
+      - name: Run database migrations
+        run: docker compose -f src/test/e2e/docker-compose.test.yml exec -T web yarn migration-steps:run
+
+      - name: Run unit and integration tests
+        run: docker compose -f src/test/e2e/docker-compose.test.yml exec -T web yarn test
+        env:
+          NPM_GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}
+
+      - name: Stop containers
+        if: always()
+        run: docker compose -f src/test/e2e/docker-compose.test.yml down -v
+
+      - name: Cleanup database backup
+        if: always()
+        run: |
+          rm -rf ./db

jest.config.js → jest.config.base.js

@@ -9,7 +9,5 @@ module.exports = {
   rootDir: 'src',
   roots: ['<rootDir>'],
   testEnvironment: 'node',
-  testMatch: ['**/*.test.ts'],
-  testPathIgnorePatterns: ['/node_modules/'],
   verbose: true,
 }

jest.config.integration.js

@@ -0,0 +1,7 @@
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const baseConfig = require('./jest.config.base')
+
+module.exports = {
+  ...baseConfig,
+  testMatch: ['**/integration.test.ts'],
+}

jest.config.unit.js

@@ -0,0 +1,8 @@
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const baseConfig = require('./jest.config.base')
+
+module.exports = {
+  ...baseConfig,
+  testMatch: ['**/?(*.)+(test).ts'],
+  testPathIgnorePatterns: ['/node_modules/', '/dist/', '/src/test/integration/', '/src/test/e2e/'],
+}

package.json

@@ -27,12 +27,13 @@
     "run:prod:server": "node dist/server/start",
     "start": "run-s migration-public:run run:prod:server",
     "//test": "mochapack --webpack-config webpack.config.babel.test.js",
-    "test": "run-s test:integration",
-    "test:integration": "yarn jest --no-cache --detectOpenHandles --setupFiles dotenv/config",
-    "test:e2e": "playwright test --config ./src/test/e2e/jest-playwright.config.ts",
-    "test:e2e:dev": "playwright test --config ./src/test/e2e/jest-playwright.config.local.ts --debug --headed --ui",
+    "test": "run-p test:unit test:integration",
+    "test:unit": "yarn jest --no-cache --detectOpenHandles --setupFiles dotenv/config --config jest.config.unit.js",
+    "test:integration": "yarn jest --no-cache --detectOpenHandles --setupFiles dotenv/config --config jest.config.integration.js src/test/integration/integration.test.ts",
+    "test:e2e": "playwright test --config ./src/test/e2e/playwright.config.ts",
+    "test:e2e:dev": "playwright test --config ./src/test/e2e/playwright.config.local.ts --debug --headed --ui",
     "test:e2e:docker": "docker-compose -f src/test/e2e/docker-compose.test.yml up --build --exit-code-from playwright",
-    "test:watch": "yarn jest --no-cache --detectOpenHandles --watchAll --setupFiles dotenv/config",
+    "test:watch": "yarn jest --no-cache --detectOpenHandles --watchAll --setupFiles dotenv/config --config jest.config.unit.js",
     "preversion": "git diff --quiet || { echo \"Working directory is dirty\"; exit 1; };",
     "postversion": "git push --tags && echo \"Successfully released version $npm_package_version!\"",
     "prepare": "husky install",
@@ -295,4 +296,4 @@
       "prettier --write"
     ]
   }
-}
+}

src/test/e2e/Dockerfile.playwright

@@ -21,8 +21,6 @@ RUN yarn playwright install --with-deps chromium
 
 COPY . .
 
-RUN ls -la src/test/e2e
-
 EXPOSE 9323
 
 CMD ["yarn", "test:e2e"]

src/test/e2e/docker-compose.test.yml

@@ -60,6 +60,10 @@ services:
       - REDIS_QUEUE_URL=redis://redis-queue:6379
       - REDIS_DATA_URL=redis://redis-data:6379
       - PORT=9001
+      - WWWHISPER_DISABLE=true
+      - FRA_GOOGLE_CLIENT_ID=google-client-id
+      - FRA_GOOGLE_CLIENT_SECRET=goggle-client-secret
+      - TOKEN_SECRET=1234567890
     ports:
       - '9001:9001'
     healthcheck:

src/test/e2e/jest-playwright.config.local.ts → src/test/e2e/playwright.config.local.ts

@@ -1,6 +1,6 @@
 import { PlaywrightTestConfig } from '@playwright/test'
 
-import baseConfig from './jest-playwright.config'
+import baseConfig from './playwright.config'
 
 const config: PlaywrightTestConfig = {
   ...baseConfig,

src/test/e2e/jest-playwright.config.ts → src/test/e2e/playwright.config.ts

@@ -28,18 +28,7 @@ const config: PlaywrightTestConfig = {
     },
   ],
 
-  reporter: [
-    ['list'],
-    [
-      'html',
-      {
-        outputFolder: 'test-results',
-        port: 9323,
-        host: '0.0.0.0',
-        open: 'always', // Remove this or change to 'on-failure'
-      },
-    ],
-  ],
+  reporter: [['list'], ['html', { outputFolder: 'test-results', open: 'never' }]],
 }
 
 export default config

src/test/e2e/tests/01-example.spec.ts

@@ -2,8 +2,8 @@ import { expect, test } from '@playwright/test'
 
 test('homepage has title and links to intro page', async ({ page }) => {
   await page.goto('/')
-
-  await expect(page).toHaveTitle(/FRA platform/, { timeout: 10000 })
+  const title = /FRA Platform | Global Forest Resources Data | Food and Agriculture Organization of the United Nations/
+  await expect(page).toHaveTitle(title, { timeout: 10000 })
   const headerLogo = await page.getByRole('img', { name: 'FAO' })
   await expect(headerLogo).toBeVisible()
   const headerTitle = await page.getByText('Global Forest Resources Assessment').first()

src/test/e2e/tests/03-login.spec.ts

@@ -2,7 +2,7 @@ import { expect, test } from '@playwright/test'
 
 test.describe('Login', () => {
   test('should login with test user credentials', async ({ page }) => {
-    await page.goto('/assessments/fra/2025/login')
+    await page.goto('/assessments/fra/latest/login')
 
     await page.click('button:has-text("Sign in with FRA")')
 
@@ -11,13 +11,13 @@ test.describe('Login', () => {
 
     await page.click('button.btn:has-text("Login")')
 
-    await expect(page).toHaveURL('/assessments/fra/2025')
+    await expect(page).toHaveURL('/assessments/fra/latest')
 
     await expect(page.getByText('Test User')).toBeVisible()
   })
 
   test('should show error with invalid credentials', async ({ page }) => {
-    await page.goto('/assessments/fra/2025/login')
+    await page.goto('/assessments/fra/latest/login')
 
     await page.click('button:has-text("Sign in with FRA")')