test: k6 utils to get test domain under test

.github/workflows/k6-web-socket.yaml

@@ -2,7 +2,6 @@ name: K6 WebSocket server load tests
 
 on:
   workflow_dispatch:
-    branches: ['master', 'feat/web-socket-network-info-provider']
     inputs:
       environment:
         description: 'Target environment'
@@ -12,7 +11,7 @@ on:
           - 'dev'
           - 'ops'
           - 'staging'
-          - 'prod'
+          - 'live'
       network:
         description: 'Target network'
         type: choice
@@ -34,6 +33,16 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v3
+      - name: 🧰 Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18.12.0
+      - name: 🔨 Build
+        run: |
+          yarn install --immutable --inline-builds --mode=skip-build
+          yarn workspace @cardano-sdk/util-dev build:cjs
+        env:
+          NODE_OPTIONS: '--max_old_space_size=8192'
       - name: Run k6 cloud test
         uses: grafana/k6-action@v0.3.1
         env:

packages/e2e/test/k6/scenarios/web-socket.test.js

@@ -1,18 +1,15 @@
-// cSpell:ignore loadimpact
-
+import * as k6Utils from '../../../../util-dev/dist/cjs/k6-utils.js';
 import { Counter, Trend } from 'k6/metrics';
 import { check } from 'k6';
 import ws from 'k6/ws';
 
 // eslint-disable-next-line no-undef
-const { TARGET_ENV, TARGET_NET, URL, WALLETS } = Object.assign({ WALLETS: '10000' }, __ENV);
-const url = TARGET_ENV ? `wss://${TARGET_ENV}-${TARGET_NET}${TARGET_ENV === 'ops' ? '-1' : ''}.lw.iog.io/ws` : URL;
+const { WALLETS } = Object.assign({ WALLETS: '10000' }, __ENV);
+// eslint-disable-next-line no-undef
+const dut = k6Utils.getDut(__ENV);
+console.log(`Domain under test is: ${dut}`);
 
-if (TARGET_ENV && !['dev', 'ops', 'staging', 'prod'].includes(TARGET_ENV))
-  throw new Error(`Not valid TARGET_ENV: ${TARGET_ENV}`);
-if (TARGET_NET && !['preview', 'preprod', 'sanchonet', 'mainnet'].includes(TARGET_NET))
-  throw new Error(`Not valid TARGET_NET: ${TARGET_NET}`);
-if (!(TARGET_ENV && TARGET_NET) && !URL) throw new Error('Please specify both TARGET_ENV and TARGET_NET or URL');
+const url = `wss://${dut}/ws`;
 
 export const options = {
   ext: {

packages/util-dev/src/k6-utils.ts

@@ -0,0 +1,97 @@
+/* eslint-disable sonarjs/cognitive-complexity */
+export enum Environment {
+  dev = 'dev',
+  ops = 'ops',
+  staging = 'staging',
+  live = 'live'
+}
+
+export enum Network {
+  mainnet = 'mainnet',
+  preprod = 'preprod',
+  preview = 'preview',
+  sanchonet = 'sanchonet'
+}
+
+/**
+ * Gets the target URL domain under test (dut) based on `TARGET_ENV`, `TARGET_NET` or `DUT` environment variables.
+ *
+ * @param options default `undefined`: use default value for each option.<br />
+ * - `environments`: the array of allowed environments - default: `['dev', 'ops', 'staging', 'prod']`.
+ * - `networks`: the array of allowed networks - default: `['mainnet', 'preprod', 'preview', 'sanchonet']`.
+ * @returns the domain under test (dut) based on the environment variables, (e.g. `live-preprod.lw.iog.io`)
+ * @throws if none of `TARGET_ENV` and `TARGET_NET`, or `DUT` are configured, or if the options are invalid.
+ */
+// eslint-disable-next-line complexity, sonarjs/cognitive-complexity
+export const getDut = (
+  k6Env: { TARGET_ENV?: string; TARGET_NET?: string; DUT?: string },
+  options?: { environments?: Environment[]; networks?: Network[] }
+) => {
+  const allowedEnvironments = new Set<Environment>([
+    Environment.dev,
+    Environment.ops,
+    Environment.staging,
+    Environment.live
+  ]);
+  const allowedNetworks = new Set<Network>([Network.mainnet, Network.preprod, Network.preview, Network.sanchonet]);
+  const allowedOptions = new Set(['environments', 'networks']);
+
+  const { TARGET_ENV, TARGET_NET, DUT } = k6Env;
+
+  if (!(TARGET_ENV && TARGET_NET) && !DUT)
+    throw new Error('Please specify both TARGET_ENV and TARGET_NET or DUT (Domain Under Test');
+
+  let urlEnvironments = [...allowedEnvironments];
+  let urlNetworks = [...allowedNetworks];
+
+  if (options) {
+    if (typeof options !== 'object') throw new Error(`${typeof options}: not allowed type for options`);
+
+    for (const option of Object.keys(options))
+      if (!allowedOptions.has(option)) throw new Error(`${options}: not allowed option`);
+
+    const { environments, networks } = options;
+
+    switch (typeof environments) {
+      case 'undefined':
+        break;
+
+      case 'object':
+        if (!Array.isArray(environments)) throw new Error('options.environments must be an array');
+
+        for (const environment of environments)
+          if (!allowedEnvironments.has(environment)) throw new Error(`${environment}: not allowed environment`);
+
+        urlEnvironments = environments;
+
+        break;
+
+      default:
+        throw new Error(`${typeof environments}: not allowed type for options.environments`);
+    }
+
+    switch (typeof networks) {
+      case 'undefined':
+        break;
+
+      case 'object':
+        if (!Array.isArray(networks)) throw new Error('options.networks must be an array');
+
+        for (const network of networks)
+          if (!allowedNetworks.has(network)) throw new Error(`${network}: not allowed network`);
+
+        urlNetworks = networks;
+
+        break;
+
+      default:
+        throw new Error(`${typeof networks}: not allowed type for options.networks`);
+    }
+  }
+
+  if (TARGET_ENV && !urlEnvironments.includes(TARGET_ENV as Environment))
+    throw new Error(`${TARGET_ENV}: not allowed environment`);
+  if (TARGET_NET && !urlNetworks.includes(TARGET_NET as Network)) throw new Error(`${TARGET_NET}: not allowed network`);
+
+  return DUT || `${TARGET_ENV}-${TARGET_NET}${TARGET_ENV === 'ops' ? '-1' : ''}.lw.iog.io`;
+};

packages/util-dev/test/k6-utils.test.ts

@@ -0,0 +1,58 @@
+import * as k6Utils from '../src/k6-utils';
+
+describe('K6 utils', () => {
+  const k6Env = { TARGET_ENV: 'dev', TARGET_NET: 'mainnet' };
+
+  it('uses custom DUT if configured', () => {
+    expect(k6Utils.getDut({ DUT: 'localhost:3000' })).toBe('localhost:3000');
+  });
+
+  it('builds the correct domain under test based on TARGET_ENV and TARGET_NET', () => {
+    expect(k6Utils.getDut(k6Env)).toBe('dev-mainnet.lw.iog.io');
+    expect(k6Utils.getDut({ TARGET_ENV: k6Utils.Environment.live, TARGET_NET: k6Utils.Network.preprod })).toBe(
+      'live-preprod.lw.iog.io'
+    );
+    expect(k6Utils.getDut({ TARGET_ENV: k6Utils.Environment.ops, TARGET_NET: k6Utils.Network.preview })).toBe(
+      'ops-preview-1.lw.iog.io'
+    );
+  });
+
+  describe('Runtime validations', () => {
+    it('throws an error if none of TARGET_ENV and TARGET_NETWORK, or DUT are configured', () => {
+      expect(() => k6Utils.getDut({})).toThrow();
+      expect(() => k6Utils.getDut({ TARGET_ENV: k6Utils.Environment.dev })).toThrow();
+      expect(() => k6Utils.getDut({ TARGET_NET: k6Utils.Network.mainnet })).toThrow();
+    });
+
+    it('checks options type', () => {
+      expect(() => k6Utils.getDut(k6Env, 'invalid' as any)).toThrow();
+      expect(() => k6Utils.getDut(k6Env, { unknownProp: 'invalid' } as any)).toThrow();
+    });
+
+    it('checks options.environments and options.network to be array', () => {
+      expect(() => k6Utils.getDut(k6Env, { environments: 'invalid' as any })).toThrow();
+      expect(() => k6Utils.getDut(k6Env, { networks: 'invalid' as any })).toThrow();
+    });
+
+    it('checks options.environments and options.network to be valid', () => {
+      expect(() => k6Utils.getDut(k6Env, { environments: ['invalid' as k6Utils.Environment] })).toThrow();
+      expect(() => k6Utils.getDut(k6Env, { networks: ['invalid' as k6Utils.Network] })).toThrow();
+    });
+
+    it('checks TARGET_ENV and TARGET_NET to be from options allowed values', () => {
+      expect(() =>
+        k6Utils.getDut(
+          { TARGET_ENV: 'dev', TARGET_NET: 'mainnet' },
+          { environments: [k6Utils.Environment.ops], networks: [k6Utils.Network.mainnet] }
+        )
+      ).toThrow();
+
+      expect(() =>
+        k6Utils.getDut(
+          { TARGET_ENV: 'dev', TARGET_NET: 'mainnet' },
+          { environments: [k6Utils.Environment.dev], networks: [k6Utils.Network.preprod] }
+        )
+      ).toThrow();
+    });
+  });
+});