Deployment tags

Deployment tags declare where a test suite is expected to run. Add them to every test.describe() (or apiTest.describe() / spaceTest.describe()), then use --grep when running tests to target a specific environment.

Tags follow this shape:

• @<location>-<arch>-<domain>

Where:

• location: local or cloud
• arch: stateful or serverless
• domain: classic, search, observability_complete, security_complete, …

Prefer the tags helper exported by Scout instead of writing raw strings. It returns arrays of Playwright tags you can use directly or combine.

import { test, tags } from '@kbn/scout';

test.describe('My suite', { tag: tags.deploymentAgnostic }, () => {
  test('works', async () => {
    // ...
  });
});
		

Combine multiple targets by spreading:

test.describe('My suite', { tag: [...tags.stateful.classic, ...tags.serverless.search] }, () => {
  // ...
});
		

Unless stated otherwise, these helpers include both @local-* and @cloud-* targets.

For the authoritative list (and the exact tag strings), see src/platform/packages/shared/kbn-scout/src/playwright/tags.ts or just rely on editor autocomplete.