Adding transforms migration guide for 9.0 (#117353)

* Adding transforms migration guide for 9.0 * Adding shared transform attribute and simplifying wording --------- Co-authored-by: Elastic Machine <[email protected]>
elastic · Dec 9, 2024 · f40dc99 · f40dc99
1 parent e593eb3
commit f40dc99
Showing 1 changed file with 9 additions and 0 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
@@ -0,0 +1,9 @@
+[[transforms-migration-guide]]
+== {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:
+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-transform, update {transforms} API>> with that user.