Merge pull request #43248 from sbeskin-redhat/MIG_1040_Document_additional_excluded_resources

MIG 1040 Document additional excluded resources

Author: EricPonvelle

modules/migration-excluding-resources.adoc

@@ -20,7 +20,7 @@ By default, the {mtc-short} excludes service catalog resources and Operator Life
 $ oc edit migrationcontroller <migration_controller> -n openshift-migration
 ----
 
-. Update the `spec` section by adding a parameter to exclude specific resources or by adding a resource to the `excluded_resources` parameter if it does not have its own exclusion parameter:
+. Update the `spec` section by adding parameters to exclude specific resources. For those resources that do not have their own exclusion parameters, add the `additional_excluded_resources` parameter:
 +
 [source,yaml]
 ----
@@ -32,25 +32,15 @@ metadata:
 spec:
   disable_image_migration: true <1>
   disable_pv_migration: true <2>
+  additional_excluded_resources: <3>
+  - resource1
+  - resource2
   ...
-  excluded_resources: <3>
-  - imagetags
-  - templateinstances
-  - clusterserviceversions
-  - packagemanifests
-  - subscriptions
-  - servicebrokers
-  - servicebindings
-  - serviceclasses
-  - serviceinstances
-  - serviceplans
-  - operatorgroups
-  - events
-  - events.events.k8s.io
 ----
-<1> Add `disable_image_migration: true` to exclude image streams from the migration. Do not edit the `excluded_resources` parameter. `imagestreams` is added to `excluded_resources` when the `MigrationController` pod restarts.
-<2> Add `disable_pv_migration: true` to exclude PVs from the migration plan. Do not edit the `excluded_resources` parameter. `persistentvolumes` and `persistentvolumeclaims` are added to `excluded_resources` when the `MigrationController` pod restarts. Disabling PV migration also disables PV discovery when you create the migration plan.
-<3> You can add {product-title} resources to the `excluded_resources` list. Do not delete the default excluded resources. These resources are problematic to migrate and must be excluded.
+<1> Add `disable_image_migration: true` to exclude image streams from the migration. `imagestreams` is added to the `excluded_resources` list in `main.yml` when the `MigrationController` pod restarts.
+<2> Add `disable_pv_migration: true` to exclude PVs from the migration plan. `persistentvolumes` and `persistentvolumeclaims` are added to the `excluded_resources` list in `main.yml` when the `MigrationController` pod restarts. Disabling PV migration also disables PV discovery when you create the migration plan.
+<3> You can add {product-title} resources that you want to exclude to the `additional_excluded_resources` list.
+
 
 . Wait two minutes for the `MigrationController` pod to restart so that the changes are applied.
 
@@ -66,7 +56,7 @@ The output contains the excluded resources:
 .Example output
 [source,yaml]
 ----
-    - name: EXCLUDED_RESOURCES
-      value:
-      imagetags,templateinstances,clusterserviceversions,packagemanifests,subscriptions,servicebrokers,servicebindings,serviceclasses,serviceinstances,serviceplans,imagestreams,persistentvolumes,persistentvolumeclaims
+name: EXCLUDED_RESOURCES
+value:
+resource1,resource2,imagetags,templateinstances,clusterserviceversions,packagemanifests,subscriptions,servicebrokers,servicebindings,serviceclasses,serviceinstances,serviceplans,imagestreams,persistentvolumes,persistentvolumeclaims
 ----