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: articles/migrate/appcat/appcat-7-cli-guide.md
+66-9Lines changed: 66 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -42,8 +42,12 @@ The following sections provide a detailed description of the available `appcat a
42
42
| Source & target technologies |||
43
43
||`--list-sources`| Displays the available migration source technologies. |
44
44
||`--list-targets`| Displays the available migration target technologies. |
45
+
||`--list-capabilities`| Displays the available migration capabilities |
46
+
||`--list-os`| Displays the available migration target operating systems. |
45
47
||`--source`, `-s`| Specifies the source technologies for analysis. Use a comma-separated list for multiple values - for example, `--source <source1>,<source2>,...`. Use the `--list-sources` argument to list all available sources. |
46
48
||`--target`, `-t`| Specifies the target technologies for analysis. Use a comma-separated list for multiple values - for example, `--target <target1>,<target2>,...`. Use the `--list-targets` argument to list all available targets. |
49
+
||`--capability`, `-c`| Specifies capability technologies for analysis. Use a comma-separated list for multiple values - for example, `--capability <capability1>,<capability2>,...`. Use the `--list-capabilities` argument to list all available capabilities. |
50
+
||`--os`| Specifies operating systems for analysis. Use a comma-separated list for multiple values - for example, `--os <os1>,<os2>,...`. Use the `--list-os` argument to list all available operating systems. |
47
51
| Analysis options |||
48
52
||`--analyze-known-libraries`| Enables analysis of known open-source libraries - specified in AppCAT's `maven.default.index` - during source code analysis. The default value is `false`. |
49
53
||`--custom-maven-settings`| Specifies the path to a custom Maven settings file. |
@@ -99,7 +103,7 @@ The `--list-sources` parameter shows the following source technologies:
99
103
| EAP | Best practices for migrating Java applications that use JBoss EAP technology. |`eap`|
100
104
| EAP 7 | Best practices for migrating Java applications that use JBoss EAP 7 technology. |`eap7`|
101
105
102
-
##### Support targets
106
+
##### Supported targets
103
107
104
108
The `--list-targets` parameter shows the following target technologies:
105
109
@@ -108,15 +112,30 @@ The `--list-targets` parameter shows the following target technologies:
108
112
| Azure App Service | Best practices for deploying an app to Azure App Service. |`azure-appservice`|
109
113
| Azure Kubernetes Service | Best practices for deploying an app to Azure Kubernetes Service. |`azure-aks`|
110
114
| Azure Container Apps | Best practices for deploying an app to Azure Container Apps. |`azure-container-apps`|
111
-
| Cloud Readiness | General best practices for making an application Cloud (Azure) ready. |`cloud-readiness`|
112
-
| Linux | General best practices for making an application Linux ready. |`linux`|
113
-
| OpenJDK 11 | General best practices for running a Java 8 application with Java 11. |`openjdk11`|
114
-
| OpenJDK 17 | General best practices for running a Java 11 application with Java 17. |`openjdk17`|
115
-
| OpenJDK 21 | General best practices for running a Java 17 application with Java 21. |`openjdk21`|
115
+
116
+
##### Supported operating systems
117
+
118
+
The `--list-os` parameter shows the following operating systems:
| Containerization | Best practices for containerizing applications. |`containerization`|
132
+
| OpenJDK 11 | Best practices for migrating to OpenJDK 11. |`openjdk11`|
133
+
| OpenJDK 17 | Best practices for migrating to OpenJDK 17. |`openjdk17`|
134
+
| OpenJDK 21 | Best practices for migrating to OpenJDK 21. |`openjdk21`|
116
135
117
136
##### Configure ignore files
118
137
119
-
In the AppCAT CLI install path, you can configure the `.appcat-ignore` file to exclude specified folders or paths when running the `appcat analyze` command.
138
+
In the AppCAT CLI install path, you can configure the **.appcat-ignore** file to exclude specified folders or paths when running the `appcat analyze` command.
120
139
121
140
#### Global parameters
122
141
@@ -179,6 +198,24 @@ In the AppCAT CLI install path, you can configure the `.appcat-ignore` file to e
179
198
--target=<target-name>
180
199
```
181
200
201
+
- Analyze a source code directory with specific source to combine target technologies, capabilities, and operating system:
The `--target`, `--capabilities`, and `-os` parameters are combined with an `AND` condition, meaning that the rules must simultaneously match the following criteria:
214
+
215
+
- An Azure service such as `azure-aks`, `azure-appservice`, or `azure-container-apps`.
216
+
- The capability to detect containerization issues.
217
+
- The Windows OS platform.
218
+
182
219
- Analyze a source code directory and keep the detected context lines with custom line numbers:
183
220
184
221
```bash
@@ -188,9 +225,29 @@ In the AppCAT CLI install path, you can configure the `.appcat-ignore` file to e
188
225
--context-lines-number <line-number>
189
226
```
190
227
191
-
The following screenshot shows an example of using `--context-lines-number 3`:
228
+
The following screenshot shows an example of using `--context-lines-number 3`:
229
+
230
+
:::image type="content" source="media/java/appcat-7-cli-command-with-context-line-number.png" alt-text="Screenshot of the appcat report issue code snippet difference with context-lines-number parameter." lightbox="media/java/appcat-7-cli-command-with-context-line-number.png":::
231
+
232
+
- Restrict report content without code snippets:
233
+
234
+
```bash
235
+
appcat analyze \
236
+
--input <path-to-source> \
237
+
--output <path-to-output> \
238
+
--code-snips-number -1
239
+
```
240
+
241
+
When `--code-snips-number -1` is set, code snippets aren't exported to the report. This behavior helps prevent sensitive data from being included.
242
+
243
+
:::image type="content" source="media/java/appcat-7-cli-command-with-code-snips-number.png" alt-text="Screenshot of the AppCAT report showing the difference with and without code snippets." lightbox="media/java/appcat-7-cli-command-with-code-snips-number.png":::
244
+
245
+
You can also check the `metadata.privacyMode` property in `report.json`.
246
+
247
+
`PrivacyMode` values:
192
248
193
-
:::image type="content" source="media/java/appcat-7-cli-command-with-context-line-number.png" alt-text="Screenshot of the appcat report issue code snippet difference with context-lines-number parameter." lightbox="media/java/appcat-7-cli-command-with-context-line-number.png":::
249
+
- Unrestricted – the report includes code snippets.
250
+
- Restricted – the report doesn't include code snippets.
Copy file name to clipboardExpand all lines: articles/migrate/appcat/appcat-7-release-notes.md
+19-1Lines changed: 19 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,12 +18,24 @@ This article provides the release notes for Azure Migrate application and code a
18
18
19
19
## Release history
20
20
21
+
### 7.7.0.4
22
+
23
+
This release contains the following new features and enhancements:
24
+
25
+
-**Enhanced command parameters**: Added new parameters to the `appcat analyze` command:
26
+
-`--list-capabilities`: Display available migration capabilities.
27
+
-`--list-os`: Display available migration target operating systems.
28
+
-`--capability`: Specify capability technologies for analysis.
29
+
-`--os`: Specify operating systems for analysis.
30
+
-**Improved target specification**: Refined the `--targets` parameter by removing OS and capability values, which are now handled by dedicated parameters.
31
+
-**Unified output format**: Introduced a new consolidated **report.json** output file.
32
+
21
33
### 7.7.0.3
22
34
23
35
This release contains the following fixes and enhancements:
24
36
25
37
- Refine issue domain names and category names.
26
-
- Move *.appcat-ignore* into user home path instead of the AppCAT installation folder.
38
+
- Move **.appcat-ignore** into user home path instead of the AppCAT installation folder.
27
39
- Remove unnecessary temporary files during analysis, such as Eclipse-specific configuration.
28
40
- Return error message directly for non-Java projects.
29
41
@@ -136,6 +148,12 @@ This release is based on a different set of components of the Konveyor project.
136
148
137
149
## Known issues
138
150
151
+
### 7.7.0.4
152
+
153
+
- Rules issues:
154
+
- The `azure-system-config-01000` rules aren't being triggered.
155
+
- An error in the **Watcher Error** channel on Windows: `Windows system assumed buffer larger than it is, events have likely been missed`. This error message appears on the command line during long-running jobs on Windows.
0 commit comments