You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/topics/mta-web-configuring-and-running-an-application-analysis.adoc
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -82,12 +82,11 @@ Analysis engines use standard rules for a comprehensive set of migration targets
82
82
. Click *Run*.
83
83
+
84
84
The analysis status is `Scheduled` as {ProductShortName} downloads the image for the container to execute. When the image is downloaded, the status changes to `In-progress.`
85
-
+
85
+
86
86
[NOTE]
87
87
====
88
88
Analysis takes minutes to hours to run depending on the size of the application and the capacity and resources of the cluster.
89
89
====
90
-
+
91
90
[TIP]
92
91
====
93
92
{ProductShortName} relies on Kubernetes scheduling capabilities to determine how many analyzer instances are created based on cluster capacity. If several applications are selected for analysis, by default, only one analyzer can be provisioned at a time. With more cluster capacity, more analysis processes can be executed in parallel.
@@ -98,3 +97,7 @@ Analysis takes minutes to hours to run depending on the size of the application
98
97
Alternatively, hover over the application name to display the pop-over window.
99
98
. When analysis is complete, to see its results, open the application drawer by clicking on the application name.
100
99
100
+
[NOTE]
101
+
====
102
+
After creating an application instance on the Application Inventory page, the language discovery task starts, automatically pre-selecting the target filter option. However, you can choose a different language that you prefer.
Copy file name to clipboardExpand all lines: docs/topics/yaml-rule-structure-syntax.adoc
+52-2Lines changed: 52 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -230,6 +230,9 @@ when:
230
230
231
231
==== Provider conditions
232
232
233
+
The Application Analyzer detects the programming languages, frameworks, and tools used to build an application, and it generates default rulesets for each supported provider using the Language Server Protocol (LSP) accordingly.
234
+
Each supported provider has a ruleset defined by default and is run independently in a separate container.
235
+
233
236
{ProductShortName} supports multi-language source code analysis. Searching for a specific language in the source code is enabled using the `provider` condition. This condition defines a search query for a specific language provider. The `provider` condition also specifies which of the provider's "capabilities" to use for analyzing the code.
234
237
235
238
The `provider` condition has the form `<provider_name>.<capability>`:
@@ -246,7 +249,29 @@ The analyzer currently supports the following `provider` conditions:
| Providers that are fully supported and included in the product
264
+
| Java
265
+
266
+
| Providers that have rules already defined in the product
267
+
| .NET
268
+
269
+
|Providers that require custom rulesets for analysis
270
+
a|
271
+
* Go
272
+
* Python
273
+
* Node.js
274
+
|===
250
275
251
276
===== `builtin` provider
252
277
@@ -407,6 +432,24 @@ when:
407
432
<2> Upper bound on the version of the dependency.
408
433
<3> Lower bound on the version of the dependency.
409
434
435
+
===== `dotnet` provider
436
+
437
+
The `dotnet` is an external provider used to analyze .NET and C# source code. Currently, the provider supports the `referenced` capability.
438
+
439
+
.`referenced`
440
+
441
+
The `referenced` capability enables the provider to find references in the source code.
442
+
443
+
[source,terminal]
444
+
----
445
+
when:
446
+
dotnet.referenced:
447
+
pattern: "<pattern>" <1>
448
+
namespace: "<namespace>" <2>
449
+
----
450
+
<1> `pattern`: A regex pattern to match the desired reference. For example, HttpNotFound.
451
+
<2> `namespace`: Specifies the namespace to search within. For example, System.Web.Mvc.
452
+
410
453
==== Custom variables
411
454
412
455
Provider conditions can have associated custom variables. You can use custom variables to capture relevant information from the matched line in the source code. The values of these variables are interpolated with data matched in the source code. These values can be used to generate detailed templated messages in a rule's action (see xref:yaml-rule-actions_{context}[Message actions]). They can be added to a rule in the `customVariables` field:
@@ -519,4 +562,11 @@ labels: <2>
519
562
- key=val
520
563
----
521
564
<1> The name must be unique within the provided rulesets.
522
-
<2> Ruleset labels are inherited by all rules that belong to the ruleset.
565
+
<2> Ruleset labels are inherited by all rules that belong to the ruleset.
566
+
567
+
To execute any application analysis, run the following command. Replace <application_to_analyze> with your application, <output_dir> with the directory of your choice, and <custom_rule_dir> with the custom rulesets file.
On initiation, the mta-cli tool determines the type of application and the corresponding provider needed for analysis. It then starts the provider in a container that has the required dependencies and tools. Finally, the provider uses the analyzer to execute a series of rulesets to analyze the source code.
0 commit comments