[ftr] support filtering tests by es version

[spalger]

Add a new method to suites like this.tags(), for defining a valid esVersion range for the suite.

describe('...', function () {
  this.onlyEsVersion('<=7')

  ...
})

This version range is then validated against the --es-version flag passed to the functional_test_runner CLI, the version number extracted from the ES_SNAPSHOT_MANIFEST environment variable, or the Kibana version (in that order).

Any test which doesn't match the es version number will be excluded automatically.

In addition to the ability to skip a whole suite tests can be updated to use the esVersion service, which exposes a helpful method for conditional logic based on version ranges:

const esVersion = getService('esVersion');

//...

es.indices.create({
  ...
  include_type_name: esVersion.matchRange('>=8') ? undefined : includeTypeName
})

To see this in action I'm also working on #123312, which backports this PR and skips all the suites which are failing in 7.17 when running that branch against an 8.0 snapshot.

[elasticmachine]

Pinging @elastic/kibana-operations (Team:Operations)

[spalger]

@elasticmachine merge upstream

[kibana-ci]

💚 Build Succeeded

• Buildkite Build
• Commit: b2b95d5
• Storybooks Preview

Metrics [docs]

Public APIs missing comments

Total count of every public API that lacks a comment. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats comments for more detailed information.

id	before	after	diff
@kbn/test	180	193	+13

Public APIs missing exports

Total count of every type that is part of your API that should be exported but is not. This will cause broken links in the API documentation system. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats exports for more detailed information.

id	before	after	diff
kibana	956	957	+1

Unknown metric groups

API count

id	before	after	diff
@kbn/test	203	218	+15

History

• 💔 Build #18474 failed a2e1a71
• 💚 Build #18439 succeeded f8d989a
• 💚 Build #18256 succeeded de23de1
• 💔 Build #18232 failed a591c84
• 💔 Build #18215 failed 2c1a793

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

[tylersmalley]

LGTM