From 20c4716cedb67cab821907f2e3ba5c244d8a5905 Mon Sep 17 00:00:00 2001
From: Josh Dover <1813008+joshdover@users.noreply.github.com>
Date: Tue, 27 Jul 2021 23:32:35 +0200
Subject: [PATCH] Add ability for types to define an excludeOnUpgrade hook
(#106534)
* Add ability for types to define an exclude from upgrade hook
* Update test to use 7.13 fixture
* Add 404 handling to oldest action task query
* Update api docs
* Update and add unit tests
* Rename deleteOnUpgrade to excludeOnUpgrade
* Disable reporting browser download for integration test
* Update exports and TSDocs
* Disable reporting plugin entirely
* Typo in config key name
* Update api docs
* Fix eslint
* Add timeouts for hooks
* Make adjustments to getOldestIdleActionTask
* Add type name to log messages for failed hooks
* Update api docs
---
...ugin-core-public.kibanaexecutioncontext.md | 2 +-
...core-public.kibanaexecutioncontext.type.md | 2 +-
.../core/server/kibana-plugin-core-server.md | 1 +
...erver.savedobjectstype.excludeonupgrade.md | 13 ++
...ana-plugin-core-server.savedobjectstype.md | 1 +
...dobjecttypeexcludefromupgradefilterhook.md | 19 +++
src/core/server/index.ts | 1 +
src/core/server/saved_objects/index.ts | 1 +
.../actions/calculate_exclude_filters.test.ts | 113 ++++++++++++++
.../actions/calculate_exclude_filters.ts | 107 +++++++++++++
.../migrationsv2/actions/index.ts | 6 +
.../migrationsv2/initial_state.test.ts | 26 ++++
.../migrationsv2/initial_state.ts | 7 +
.../7.13_1.5k_failed_action_tasks.zip | Bin 0 -> 2651548 bytes
...gration_7_13_0_failed_action_tasks.test.ts | 147 ++++++++++++++++++
.../migrations_state_action_machine.test.ts | 4 +
.../migrationsv2/model/model.test.ts | 61 +++++++-
.../saved_objects/migrationsv2/model/model.ts | 28 +++-
.../server/saved_objects/migrationsv2/next.ts | 6 +
.../saved_objects/migrationsv2/types.ts | 14 ++
src/core/server/saved_objects/types.ts | 21 +++
src/core/server/server.api.md | 8 +
x-pack/plugins/actions/server/plugin.ts | 7 +-
.../actions/server/saved_objects/index.ts | 18 ++-
x-pack/plugins/task_manager/server/index.ts | 1 +
.../queries/oldest_idle_action_task.test.ts | 71 +++++++++
.../server/queries/oldest_idle_action_task.ts | 79 ++++++++++
.../server/saved_objects/index.ts | 48 ++++++
28 files changed, 805 insertions(+), 7 deletions(-)
create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md
create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md
create mode 100644 src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.test.ts
create mode 100644 src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.ts
create mode 100644 src/core/server/saved_objects/migrationsv2/integration_tests/archives/7.13_1.5k_failed_action_tasks.zip
create mode 100644 src/core/server/saved_objects/migrationsv2/integration_tests/migration_7_13_0_failed_action_tasks.test.ts
create mode 100644 x-pack/plugins/task_manager/server/queries/oldest_idle_action_task.test.ts
create mode 100644 x-pack/plugins/task_manager/server/queries/oldest_idle_action_task.ts
diff --git a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.md b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.md
index afd66fbba18d3..06154c814c4e7 100644
--- a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.md
+++ b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.md
@@ -18,6 +18,6 @@ export interface KibanaExecutionContext
| [description](./kibana-plugin-core-public.kibanaexecutioncontext.description.md) | string | human readable description. For example, a vis title, action name |
| [id](./kibana-plugin-core-public.kibanaexecutioncontext.id.md) | string | unique value to identify the source |
| [name](./kibana-plugin-core-public.kibanaexecutioncontext.name.md) | string | public name of a user-facing feature |
-| [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | string | Kibana application initated an operation. Can be narrowed to an enum later. |
+| [type](./kibana-plugin-core-public.kibanaexecutioncontext.type.md) | string | Kibana application initated an operation. |
| [url](./kibana-plugin-core-public.kibanaexecutioncontext.url.md) | string | in browser - url to navigate to a current page, on server - endpoint path, for task: task SO url |
diff --git a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
index ca339ddd9d646..48009ebaaeaa5 100644
--- a/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
+++ b/docs/development/core/public/kibana-plugin-core-public.kibanaexecutioncontext.type.md
@@ -4,7 +4,7 @@
## KibanaExecutionContext.type property
-Kibana application initated an operation. Can be narrowed to an enum later.
+Kibana application initated an operation.
Signature:
diff --git a/docs/development/core/server/kibana-plugin-core-server.md b/docs/development/core/server/kibana-plugin-core-server.md
index a26f8bd7b1594..a3f925151af61 100644
--- a/docs/development/core/server/kibana-plugin-core-server.md
+++ b/docs/development/core/server/kibana-plugin-core-server.md
@@ -329,6 +329,7 @@ The plugin integrates with the core system via lifecycle events: `setup`
| [SavedObjectsImportHook](./kibana-plugin-core-server.savedobjectsimporthook.md) | A hook associated with a specific saved object type, that will be invoked during the import process. The hook will have access to the objects of the registered type.Currently, the only supported feature for import hooks is to return warnings to be displayed in the UI when the import succeeds. The only interactions the hook can have with the import process is via the hook's response. Mutating the objects inside the hook's code will have no effect. |
| [SavedObjectsImportWarning](./kibana-plugin-core-server.savedobjectsimportwarning.md) | Composite type of all the possible types of import warnings.See [SavedObjectsImportSimpleWarning](./kibana-plugin-core-server.savedobjectsimportsimplewarning.md) and [SavedObjectsImportActionRequiredWarning](./kibana-plugin-core-server.savedobjectsimportactionrequiredwarning.md) for more details. |
| [SavedObjectsNamespaceType](./kibana-plugin-core-server.savedobjectsnamespacetype.md) | The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: \* single (default): This type of saved object is namespace-isolated, e.g., it exists in only one namespace. \* multiple: This type of saved object is shareable, e.g., it can exist in one or more namespaces. \* multiple-isolated: This type of saved object is namespace-isolated, e.g., it exists in only one namespace, but object IDs must be unique across all namespaces. This is intended to be an intermediate step when objects with a "single" namespace type are being converted to a "multiple" namespace type. In other words, objects with a "multiple-isolated" namespace type will be \*share-capable\*, but will not actually be shareable until the namespace type is changed to "multiple". \* agnostic: This type of saved object is global. |
+| [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) | If defined, allows a type to run a search query and return a query filter that may match any documents which may be excluded from the next migration upgrade process. Useful for cleaning up large numbers of old documents which are no longer needed and may slow the migration process.If this hook fails, the migration will proceed without these documents having been filtered out, so this should not be used as a guarantee that these documents have been deleted.Experimental and subject to change |
| [SavedObjectUnsanitizedDoc](./kibana-plugin-core-server.savedobjectunsanitizeddoc.md) | Describes Saved Object documents from Kibana < 7.0.0 which don't have a references root property defined. This type should only be used in migrations. |
| [ScopeableRequest](./kibana-plugin-core-server.scopeablerequest.md) | A user credentials container. It accommodates the necessary auth credentials to impersonate the current user.See [KibanaRequest](./kibana-plugin-core-server.kibanarequest.md). |
| [ServiceStatusLevel](./kibana-plugin-core-server.servicestatuslevel.md) | A convenience type that represents the union of each value in [ServiceStatusLevels](./kibana-plugin-core-server.servicestatuslevels.md). |
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md
new file mode 100644
index 0000000000000..f5446b37dc29c
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md
@@ -0,0 +1,13 @@
+
+
+[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsType](./kibana-plugin-core-server.savedobjectstype.md) > [excludeOnUpgrade](./kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md)
+
+## SavedObjectsType.excludeOnUpgrade property
+
+If defined, allows a type to exclude unneeded documents from the migration process and effectively be deleted. See [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) for more details.
+
+Signature:
+
+```typescript
+excludeOnUpgrade?: SavedObjectTypeExcludeFromUpgradeFilterHook;
+```
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
index c3aba5261561f..bdb90be2bc8fc 100644
--- a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md
@@ -52,6 +52,7 @@ Example after converting to a multi-namespace (shareable) type in 8.1:
```
Note: migration function(s) can be optionally specified for any of these versions and will not interfere with the conversion process. |
+| [excludeOnUpgrade](./kibana-plugin-core-server.savedobjectstype.excludeonupgrade.md) | SavedObjectTypeExcludeFromUpgradeFilterHook | If defined, allows a type to exclude unneeded documents from the migration process and effectively be deleted. See [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md) for more details. |
| [hidden](./kibana-plugin-core-server.savedobjectstype.hidden.md) | boolean | Is the type hidden by default. If true, repositories will not have access to this type unless explicitly declared as an extraType when creating the repository.See [createInternalRepository](./kibana-plugin-core-server.savedobjectsservicestart.createinternalrepository.md). |
| [indexPattern](./kibana-plugin-core-server.savedobjectstype.indexpattern.md) | string | If defined, the type instances will be stored in the given index instead of the default one. |
| [management](./kibana-plugin-core-server.savedobjectstype.management.md) | SavedObjectsTypeManagementDefinition<Attributes> | An optional [saved objects management section](./kibana-plugin-core-server.savedobjectstypemanagementdefinition.md) definition for the type. |
diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md
new file mode 100644
index 0000000000000..bd1c43529895c
--- /dev/null
+++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md
@@ -0,0 +1,19 @@
+
+
+[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectTypeExcludeFromUpgradeFilterHook](./kibana-plugin-core-server.savedobjecttypeexcludefromupgradefilterhook.md)
+
+## SavedObjectTypeExcludeFromUpgradeFilterHook type
+
+If defined, allows a type to run a search query and return a query filter that may match any documents which may be excluded from the next migration upgrade process. Useful for cleaning up large numbers of old documents which are no longer needed and may slow the migration process.
+
+If this hook fails, the migration will proceed without these documents having been filtered out, so this should not be used as a guarantee that these documents have been deleted.
+
+Experimental and subject to change
+
+Signature:
+
+```typescript
+export declare type SavedObjectTypeExcludeFromUpgradeFilterHook = (toolkit: {
+ readonlyEsClient: Pick;
+}) => estypes.QueryDslQueryContainer | Promise;
+```
diff --git a/src/core/server/index.ts b/src/core/server/index.ts
index c77a3a967364c..191a3bd972f15 100644
--- a/src/core/server/index.ts
+++ b/src/core/server/index.ts
@@ -312,6 +312,7 @@ export type {
SavedObjectsCreatePointInTimeFinderDependencies,
SavedObjectsCreatePointInTimeFinderOptions,
SavedObjectsCreateOptions,
+ SavedObjectTypeExcludeFromUpgradeFilterHook,
SavedObjectsExportResultDetails,
SavedObjectsExportExcludedObject,
SavedObjectsFindResult,
diff --git a/src/core/server/saved_objects/index.ts b/src/core/server/saved_objects/index.ts
index 5f853d49219dc..b689b348e9e4c 100644
--- a/src/core/server/saved_objects/index.ts
+++ b/src/core/server/saved_objects/index.ts
@@ -90,6 +90,7 @@ export type {
SavedObjectStatusMeta,
SavedObjectsType,
SavedObjectsTypeManagementDefinition,
+ SavedObjectTypeExcludeFromUpgradeFilterHook,
} from './types';
export { savedObjectsConfig, savedObjectsMigrationConfig } from './saved_objects_config';
diff --git a/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.test.ts b/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.test.ts
new file mode 100644
index 0000000000000..0f41233fd58f2
--- /dev/null
+++ b/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.test.ts
@@ -0,0 +1,113 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import * as Either from 'fp-ts/lib/Either';
+import { errors as esErrors } from '@elastic/elasticsearch';
+import { elasticsearchClientMock } from '../../../elasticsearch/client/mocks';
+import { calculateExcludeFilters } from './calculate_exclude_filters';
+
+describe('calculateExcludeFilters', () => {
+ const client = elasticsearchClientMock.createInternalClient();
+
+ it('calls each provided hook and returns combined filter', async () => {
+ const hook1 = jest.fn().mockReturnValue({ bool: { must: { term: { fieldA: '123' } } } });
+ const hook2 = jest.fn().mockResolvedValue({ bool: { must: { term: { fieldB: 'abc' } } } });
+
+ const task = calculateExcludeFilters({
+ client,
+ excludeFromUpgradeFilterHooks: { type1: hook1, type2: hook2 },
+ });
+ const result = await task();
+
+ expect(hook1).toHaveBeenCalledWith({ readonlyEsClient: { search: expect.any(Function) } });
+ expect(hook2).toHaveBeenCalledWith({ readonlyEsClient: { search: expect.any(Function) } });
+ expect(Either.isRight(result)).toBe(true);
+ expect((result as Either.Right).right).toEqual({
+ excludeFilter: {
+ bool: {
+ must_not: [
+ { bool: { must: { term: { fieldA: '123' } } } },
+ { bool: { must: { term: { fieldB: 'abc' } } } },
+ ],
+ },
+ },
+ errorsByType: {},
+ });
+ });
+
+ it('ignores hooks that return non-retryable errors', async () => {
+ const error = new Error('blah!');
+ const hook1 = jest.fn().mockRejectedValue(error);
+ const hook2 = jest.fn().mockResolvedValue({ bool: { must: { term: { fieldB: 'abc' } } } });
+
+ const task = calculateExcludeFilters({
+ client,
+ excludeFromUpgradeFilterHooks: { type1: hook1, type2: hook2 },
+ });
+ const result = await task();
+
+ expect(Either.isRight(result)).toBe(true);
+ expect((result as Either.Right).right).toEqual({
+ excludeFilter: {
+ bool: {
+ must_not: [{ bool: { must: { term: { fieldB: 'abc' } } } }],
+ },
+ },
+ errorsByType: { type1: error },
+ });
+ });
+
+ it('returns Either.Left if a hook returns a retryable error', async () => {
+ const error = new esErrors.NoLivingConnectionsError(
+ 'reason',
+ elasticsearchClientMock.createApiResponse()
+ );
+ const hook1 = jest.fn().mockRejectedValue(error);
+ const hook2 = jest.fn().mockResolvedValue({ bool: { must: { term: { fieldB: 'abc' } } } });
+
+ const task = calculateExcludeFilters({
+ client,
+ excludeFromUpgradeFilterHooks: { type1: hook1, type2: hook2 },
+ });
+ const result = await task();
+
+ expect(Either.isLeft(result)).toBe(true);
+ expect((result as Either.Left).left).toEqual({
+ type: 'retryable_es_client_error',
+ message: 'reason',
+ error,
+ });
+ });
+
+ it('ignores and returns errors for hooks that take longer than timeout', async () => {
+ const hook1 = jest.fn().mockReturnValue(new Promise((r) => setTimeout(r, 40_000)));
+ const hook2 = jest.fn().mockResolvedValue({ bool: { must: { term: { fieldB: 'abc' } } } });
+
+ const task = calculateExcludeFilters({
+ client,
+ excludeFromUpgradeFilterHooks: { type1: hook1, type2: hook2 },
+ hookTimeoutMs: 100,
+ });
+ const resultPromise = task();
+ await new Promise((r) => setTimeout(r, 110));
+ const result = await resultPromise;
+
+ expect(Either.isRight(result)).toBe(true);
+ expect((result as Either.Right).right).toEqual({
+ excludeFilter: {
+ bool: {
+ must_not: [{ bool: { must: { term: { fieldB: 'abc' } } } }],
+ },
+ },
+ errorsByType: expect.any(Object),
+ });
+ expect((result as Either.Right).right.errorsByType.type1.toString()).toMatchInlineSnapshot(
+ `"Error: excludeFromUpgrade hook timed out after 0.1 seconds."`
+ );
+ });
+});
diff --git a/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.ts b/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.ts
new file mode 100644
index 0000000000000..9d57db079e33e
--- /dev/null
+++ b/src/core/server/saved_objects/migrationsv2/actions/calculate_exclude_filters.ts
@@ -0,0 +1,107 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+import { estypes } from '@elastic/elasticsearch';
+import { withTimeout } from '@kbn/std';
+import * as Either from 'fp-ts/lib/Either';
+import * as TaskEither from 'fp-ts/lib/TaskEither';
+import { RetryableEsClientError } from '.';
+import { ElasticsearchClient } from '../../../elasticsearch';
+import { SavedObjectTypeExcludeFromUpgradeFilterHook } from '../../types';
+import { catchRetryableEsClientErrors } from './catch_retryable_es_client_errors';
+
+export interface CalculateExcludeFiltersParams {
+ client: ElasticsearchClient;
+ excludeFromUpgradeFilterHooks: Record;
+ hookTimeoutMs?: number;
+}
+
+export interface CalculatedExcludeFilter {
+ /** Composite filter of all calculated filters */
+ excludeFilter: estypes.QueryDslQueryContainer;
+ /** Any errors that were encountered during filter calculation, keyed by the type name */
+ errorsByType: Record;
+}
+
+export const calculateExcludeFilters = ({
+ client,
+ excludeFromUpgradeFilterHooks,
+ hookTimeoutMs = 30_000, // default to 30s, exposed for testing
+}: CalculateExcludeFiltersParams): TaskEither.TaskEither<
+ RetryableEsClientError,
+ CalculatedExcludeFilter
+> => () => {
+ return Promise.all<
+ | Either.Right
+ | Either.Left<{ soType: string; error: Error | RetryableEsClientError }>
+ >(
+ Object.entries(excludeFromUpgradeFilterHooks).map(([soType, hook]) =>
+ withTimeout({
+ promise: Promise.resolve(
+ hook({ readonlyEsClient: { search: client.search.bind(client) } })
+ ),
+ timeoutMs: hookTimeoutMs,
+ })
+ .then((result) =>
+ result.timedout
+ ? Either.left({
+ soType,
+ error: new Error(
+ `excludeFromUpgrade hook timed out after ${hookTimeoutMs / 1000} seconds.`
+ ),
+ })
+ : Either.right(result.value)
+ )
+ .catch((error) => {
+ const retryableError = catchRetryableEsClientErrors(error);
+ if (Either.isLeft(retryableError)) {
+ return Either.left({ soType, error: retryableError.left });
+ } else {
+ // Really should never happen, only here to satisfy TypeScript
+ return Either.left({
+ soType,
+ error: new Error(
+ `Unexpected return value from catchRetryableEsClientErrors: "${retryableError.toString()}"`
+ ),
+ });
+ }
+ })
+ .catch((error: Error) => Either.left({ soType, error }))
+ )
+ ).then((results) => {
+ const retryableError = results.find(
+ (r) =>
+ Either.isLeft(r) &&
+ !(r.left.error instanceof Error) &&
+ r.left.error.type === 'retryable_es_client_error'
+ ) as Either.Left<{ soType: string; error: RetryableEsClientError }> | undefined;
+ if (retryableError) {
+ return Either.left(retryableError.left.error);
+ }
+
+ const errorsByType: Array<[string, Error]> = [];
+ const filters: estypes.QueryDslQueryContainer[] = [];
+
+ // Loop through all results and collect successes and errors
+ results.forEach((r) =>
+ Either.isRight(r)
+ ? filters.push(r.right)
+ : Either.isLeft(r) && errorsByType.push([r.left.soType, r.left.error as Error])
+ );
+
+ // Composite filter from all calculated filters that successfully executed
+ const excludeFilter: estypes.QueryDslQueryContainer = {
+ bool: { must_not: filters },
+ };
+
+ return Either.right({
+ excludeFilter,
+ errorsByType: Object.fromEntries(errorsByType),
+ });
+ });
+};
diff --git a/src/core/server/saved_objects/migrationsv2/actions/index.ts b/src/core/server/saved_objects/migrationsv2/actions/index.ts
index 6bfcddfe1f6de..97ffcff25dd76 100644
--- a/src/core/server/saved_objects/migrationsv2/actions/index.ts
+++ b/src/core/server/saved_objects/migrationsv2/actions/index.ts
@@ -98,6 +98,12 @@ export { searchForOutdatedDocuments } from './search_for_outdated_documents';
export type { BulkOverwriteTransformedDocumentsParams } from './bulk_overwrite_transformed_documents';
export { bulkOverwriteTransformedDocuments } from './bulk_overwrite_transformed_documents';
+export type {
+ CalculateExcludeFiltersParams,
+ CalculatedExcludeFilter,
+} from './calculate_exclude_filters';
+export { calculateExcludeFilters } from './calculate_exclude_filters';
+
export { pickupUpdatedMappings, waitForTask, waitForIndexStatusYellow };
export type { AliasNotFound, RemoveIndexNotAConcreteIndex };
diff --git a/src/core/server/saved_objects/migrationsv2/initial_state.test.ts b/src/core/server/saved_objects/migrationsv2/initial_state.test.ts
index 74d29c8fa15a9..4066efeb65de0 100644
--- a/src/core/server/saved_objects/migrationsv2/initial_state.test.ts
+++ b/src/core/server/saved_objects/migrationsv2/initial_state.test.ts
@@ -39,6 +39,7 @@ describe('createInitialState', () => {
batchSize: 1000,
controlState: 'INIT',
currentAlias: '.kibana_task_manager',
+ excludeFromUpgradeFilterHooks: {},
indexPrefix: '.kibana_task_manager',
kibanaVersion: '8.1.0',
knownTypes: [],
@@ -136,6 +137,31 @@ describe('createInitialState', () => {
expect(initialState.knownTypes).toEqual(['foo', 'bar']);
});
+ it('returns state with the correct `excludeFromUpgradeFilterHooks`', () => {
+ const fooExcludeOnUpgradeHook = jest.fn();
+ typeRegistry.registerType({
+ name: 'foo',
+ namespaceType: 'single',
+ hidden: false,
+ mappings: { properties: {} },
+ excludeOnUpgrade: fooExcludeOnUpgradeHook,
+ });
+
+ const initialState = createInitialState({
+ kibanaVersion: '8.1.0',
+ targetMappings: {
+ dynamic: 'strict',
+ properties: { my_type: { properties: { title: { type: 'text' } } } },
+ },
+ migrationVersionPerType: {},
+ indexPrefix: '.kibana_task_manager',
+ migrationsConfig,
+ typeRegistry,
+ });
+
+ expect(initialState.excludeFromUpgradeFilterHooks).toEqual({ foo: fooExcludeOnUpgradeHook });
+ });
+
it('returns state with a preMigration script', () => {
const preMigrationScript = "ctx._id = ctx._source.type + ':' + ctx._id";
const initialState = createInitialState({
diff --git a/src/core/server/saved_objects/migrationsv2/initial_state.ts b/src/core/server/saved_objects/migrationsv2/initial_state.ts
index e13a4b441fb25..dce37b384a4f7 100644
--- a/src/core/server/saved_objects/migrationsv2/initial_state.ts
+++ b/src/core/server/saved_objects/migrationsv2/initial_state.ts
@@ -58,6 +58,12 @@ export const createInitialState = ({
};
const knownTypes = typeRegistry.getAllTypes().map((type) => type.name);
+ const excludeFilterHooks = Object.fromEntries(
+ typeRegistry
+ .getAllTypes()
+ .filter((type) => !!type.excludeOnUpgrade)
+ .map((type) => [type.name, type.excludeOnUpgrade!])
+ );
return {
controlState: 'INIT',
@@ -79,5 +85,6 @@ export const createInitialState = ({
logs: [],
unusedTypesQuery: excludeUnusedTypesQuery,
knownTypes,
+ excludeFromUpgradeFilterHooks: excludeFilterHooks,
};
};
diff --git a/src/core/server/saved_objects/migrationsv2/integration_tests/archives/7.13_1.5k_failed_action_tasks.zip b/src/core/server/saved_objects/migrationsv2/integration_tests/archives/7.13_1.5k_failed_action_tasks.zip
new file mode 100644
index 0000000000000000000000000000000000000000..b445dbdfeb43532b8f7f36d82ad7d00fe05aaf07
GIT binary patch
literal 2651548
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