From 629caee567794c835cc2c2514154a3f61f20f7ae Mon Sep 17 00:00:00 2001 From: dan-rubinstein Date: Fri, 22 Nov 2024 10:10:43 -0500 Subject: [PATCH 1/2] Adding transforms migration guide for 9.0 --- .../migrate_9_0/transforms-migration-guide.asciidoc | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc diff --git a/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc b/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc new file mode 100644 index 0000000000000..38947c1a8fda3 --- /dev/null +++ b/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc @@ -0,0 +1,9 @@ +[[transforms-migration-guide]] +== Transforms migration guide +This migration guide helps you upgrade your transforms to work with the 9.0 release. Each section will outline a breaking change along with any manual steps you need to take to upgrade your transforms to be compatible with 9.0. + + +=== Updating deprecated transform roles (`data_frame_transforms_admin` and `data_frame_transforms_user`) +If you have existing transforms that use deprecated transform roles (`data_frame_transforms_admin` or `data_frame_transforms_user`) you must update them to use the new equivalent transform roles (`transform_admin` or `transform_user`). To update your transform roles: +1. Switch to a user with the `transform_admin` role (to replace `data_frame_transforms_admin`) or the `transform_user` role (to replace `data_frame_transforms_user`). +2. Call the [update API](https://www.elastic.co/guide/en/elasticsearch/reference/current/update-transform.html) with that user. From 1878c4e41ca0daead6337740dacf95d2ee96a8b2 Mon Sep 17 00:00:00 2001 From: dan-rubinstein Date: Fri, 6 Dec 2024 11:08:39 -0500 Subject: [PATCH 2/2] Adding shared transform attribute and simplifying wording --- .../migrate_9_0/transforms-migration-guide.asciidoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc b/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc index 38947c1a8fda3..d41c524d68d5c 100644 --- a/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc +++ b/docs/reference/migration/migrate_9_0/transforms-migration-guide.asciidoc @@ -1,9 +1,9 @@ [[transforms-migration-guide]] -== Transforms migration guide -This migration guide helps you upgrade your transforms to work with the 9.0 release. Each section will outline a breaking change along with any manual steps you need to take to upgrade your transforms to be compatible with 9.0. +== {transforms-cap} migration guide +This migration guide helps you upgrade your {transforms} to work with the 9.0 release. Each section outlines a breaking change and any manual steps needed to upgrade your {transforms} to be compatible with 9.0. -=== Updating deprecated transform roles (`data_frame_transforms_admin` and `data_frame_transforms_user`) -If you have existing transforms that use deprecated transform roles (`data_frame_transforms_admin` or `data_frame_transforms_user`) you must update them to use the new equivalent transform roles (`transform_admin` or `transform_user`). To update your transform roles: +=== Updating deprecated {transform} roles (`data_frame_transforms_admin` and `data_frame_transforms_user`) +If you have existing {transforms} that use deprecated {transform} roles (`data_frame_transforms_admin` or `data_frame_transforms_user`) you must update them to use the new equivalent {transform} roles (`transform_admin` or `transform_user`). To update your {transform} roles: 1. Switch to a user with the `transform_admin` role (to replace `data_frame_transforms_admin`) or the `transform_user` role (to replace `data_frame_transforms_user`). -2. Call the [update API](https://www.elastic.co/guide/en/elasticsearch/reference/current/update-transform.html) with that user. +2. Call the <> with that user.