CLI 指南

Migration Toolkit for Applications (MTA)支持以下迁移：

MTA 提供了一组全面的规则，用于评估应用程序以在 Red Hat OpenShift Container Platform (RHOCP) 上进行容器化和部署。您可以运行 MTA 分析来评估您的应用程序是否适合迁移到多个目标平台。

有关用例和迁移路径的更多信息，请参阅适用于开发人员网页的 MTA。

您可以使用 podman pull 安装 CLI。

您可以安装 CLI 以用于 Windows 上的 Docker。在将使用 .NET 框架 4.5 或更高版本构建的应用程序迁移到跨平台 .NET 8.0 时，这是必要的方法。

但是，当运行基于 Red Hat Enterprise Linux 9 (RHEL9)或 Universal Base Image 9 (UBI9)的容器镜像时，启动容器时可以返回以下错误：

Fatal glibc error: CPU does not support x86-64-v2

造成此错误的原因是 Red Hat Enterprise Linux 9 或 Universal Base Image 9 容器镜像必须在支持 x86-64-v2 的 CPU 架构上运行。

如需了解更多详细信息，请参阅 （运行 Red Hat Enterprise Linux 9 (RHEL)或 Universal Base Image (UBI) 9 容器镜像会失败，并显示 "Fatal glibc 错误：CPU 不支持 x86-64-v2"）。

CLI 正确运行容器运行时。但是，不支持不同的容器运行时配置。

虽然不支持，但您可以使用 Docker 而不是 Podman 运行 CLI，这将解决这个问题。

要达到此目的，您需要将 PODMAN_BIN 路径替换为 Docker 的路径。

例如，如果您遇到这个问题，而不是发出：

PODMAN_BIN=/usr/local/bin/docker mta-cli analyze

您可以将 PODMAN_BIN 替换为 Docker 的路径：

<Docker Root Dir>=/usr/local/bin/docker mta-cli analyze

虽然这不受支持，但您可以探索 CLI，同时准备升级硬件或移至支持 x86_64-v2 的硬件。

您可以针对应用程序运行 Migration Toolkit for Applications (MTA) CLI。

$ <MTA_HOME>/mta-cli analyze \
    --input <path_to_jee-example-app-1.0.0.ear> \
    --output <path_to_report_output> --source eap5 --target eap7 \

$ <MTA_HOME>/mta-cli analyze --mode source-only --input <path_to_customer-management>
--output <path_to_report_output> --target eap8

$ <MTA_HOME>/mta-cli analyze --input <path_to_jee-example-app-1.0.0.ear> \
    --output <path_to_report_output> \
    --target eap7

现在，您可以针对多个应用程序运行 Migration Toolkit for Applications (MTA) CLI，并生成组合报告。这可以节省时间，并让您更好地了解如何为迁移准备一组应用程序。

此功能目前是开发者技术预览功能。

从 MTA 7.2.0 开始，您可以使用不需要安装容器运行时的 MTA CLI 对 Java 应用程序执行应用程序分析。

--run-local=false

分析 支持使用 analyzer-lsp 工具运行源代码和二进制分析。analyzer-lsp 评估提供程序的规则，并确定规则匹配。

mta-cli analyze --input=<path_to_source_code> --output=<path_to_output_directory>

all 标记：

Analyze application source code

Usage:
  mta-cli analyze [flags]

Flags:

      --analyze-known-libraries           Analyze known open-source libraries.
      --context-lines (int)               Number of lines of source code to
                                          include in the output for each
                                          incident (default: `100`).
  -d, --dependency-folders (stringArray)  Directory for dependencies.
      --enable-default-rulesets           Run default rulesets with analysis
                                          (default: `true`).
  -h, --help                              Help for analyze.
      --http-proxy (string)               HTTP proxy string URL.
      --https-proxy (string)              HTTPS proxy string URL.
      --incident-selector (string)        An expression to select incidents
                                          based on custom variables.
                                          Example:
                                          !package=io.demo.config-utils
  -i, --input (string)                    Path to application source code or
                                          a binary.
      --jaeger-endpoint (string)          Jaeger endpoint to collect traces.
      --json-output                       Create analysis and dependency
                                          output as JSON.
      --list-sources                      List rules for available
                                          migration sources.
      --list-targets                      List rules for available
                                          migration targets.
  -l, --label-selector (string)           Run rules based on specified label
                                          selector expression.
      --maven-settings (string)           Path to the custom maven
                                          settings file to use.
      --overwrite                         Overwrite output directory.
      --skip-static-report                Do not generate the static report.
  -m, --mode (string)                     Analysis mode, must be one of
                                          `full` or `source-only`
                                          (default: `full`).
      --no-proxy (string)                 Proxy-excluded URLs
                                          (relevant only with proxy).
  -o, --output (string)                   Path to the directory for analysis
                                          output.
      --overwrite                         Overwrite output directory.
      --rules (stringArray)               Filename or directory containing
                                          rule files.
      --skip-static-report                Do not generate the static report.
  -s, --source (string)                   Source technology to consider
                                          for analysis.
                                          To specify multiple sources,
                                          repeat the parameter:
                                          `--source <source_1>
                                          --source <source_2>` etc.
  -t, --target (string)                   Target technology to consider
                                          for analysis.
                                          To specify multiple targets,
                                          repeat the parameter:
                                          `--target <target_1>
                                          --target <target_2>` etc.


Global Flags:
      --log-level uint32                  Log level (default: 4).
      --no-cleanup                        Do not cleanup temporary resources.

您可以使用转换执行以下操作：

Transform application source code or mta XML rules

Usage:
  mta-cli transform [flags]
  mta-cli transform [command]

Available Commands:
  openrewrite Transform application source code using OpenRewrite recipes
  rules       Convert XML rules to YAML

Flags:
  -h, --help   help for transform

Global Flags:
      --log-level uint32   log level (default 4)
      --no-cleanup         do not clean up temporary resources

Use "mta-cli transform [command] --help" for more information about a command.

Transform application source code using OpenRewrite recipes

Usage:
  mta-cli transform openrewrite [flags]

Flags:
  -g, --goal string     target goal (default "dryRun")
  -h, --help            help for openrewrite
  -i, --input string    path to application source code directory
  -l, --list-targets    list all available OpenRewrite recipes
  -s, --maven-settings string   path to a custom maven settings file to use
  -t, --target string   target openrewrite recipe to use. Run --list-targets to get a list of packaged recipes.

Global Flags:
      --log-level uint32   log level (default 4)
      --no-cleanup         do not clean up temporary resources

mta-cli transform openrewrite --input=<path/to/source/code> --target=<exactly_one_target_from_the_list>

Convert XML rules to YAML

Usage:
  mta-cli transform rules [flags]

Flags:
  -h, --help                help for rules
  -i, --input stringArray   path to XML rule file(s) or directory
  -o, --output string       path to output directory

Global Flags:
      --log-level int   log level (default 5)

mta-cli transform rules --input=<path/to/xmlrules> --output=<path/to/output/dir>

当使用 Migration Toolkit for Applications (MTA) CLI 分析多语言应用程序时，您可以根据应用程序语言明确设置受支持的语言供应商，以运行分析。

当使用 Migration Toolkit for Applications (MTA) CLI 分析多语言应用程序时，您可以运行不支持的语言供应商的分析。要做到这一点，您必须使用自己的不支持的语言供应商覆盖现有的支持的语言供应商，使用 --override-provider-settings 选项。

点 Application List 中的应用程序名称，从报告登录页面访问此报告。

控制面板提供整个应用程序迁移工作的概述。总结：

图 3.3. Dashboard

顶部导航栏列出了包含关于迁移此应用程序的更多详情的各种报告。请注意，只有适用于当前应用程序的报告才会可用。

点 Problem 链接，从仪表板 访问 此报告。

此报告包括关于所选迁移路径引发的每一个问题的详细信息。遇到的每个问题都会提供以下信息：

图 3.4. 问题报告

通过单击标题可展开每个报告的问题来获取附加详情。提供了以下信息：

图 3.5. 扩展的问题

默认情况下，问题按照四个类别排序。有关这些类别的信息，请访问请求类别。

在以前的版本中，由带有零工作的规则生成的违反行为会在静态报告中被列为问题。现在，这被列出为一个见解。问题由常规规则生成，而字符串标签则通过标记规则生成。字符串标签表示存在技术，但不显示代码位置。通过引入 Insights，您可以看到应用程序中使用的技术及其代码中的用法。

例如，规则在代码中搜索已弃用的 API 使用量不会影响当前迁移，但在以后需要时可以跟踪和修复。

与问题不同，不需要修复 insights 来成功进行迁移。它们由任何未分配正工作值和类别的规则生成。它们可能含有消息和标签。

您可以在静态报告中的 Insights 选项卡下查看 Insights。

- customVariables: []
  description: Embedded library - Apache Wicket
  labels:
  - konveyor.io/include=always
  links: []
  ruleID: mvc-01000
  tag:
  - Apache Wicket
  - Embedded library - Apache Wicket
  when:
    builtin.file:
      pattern: .*wicket.*\.jar

- category: potential
  customVariables: []
  description: RESTful Web Services @Context annotation has been deprecated
  effort: 0
  message: Future versions of this API will no longer support `@Context` and related
    types such as `ContextResolver`.
  ruleID: jakarta-ws-rs-00001
  when:
    java.referenced:
      location: ANNOTATION
      pattern: jakarta.ws.rs.core.Context

点 Application Details 链接从仪表板访问此报告。

该报告列出了案例点、软件包中的 Java 事件以及应用程序中找到的技术计数。接下来，显示迁移过程中生成的应用程序消息。最后，对过程中分析的每个存档都有此信息分类。

图 3.6. 应用程序详情报告

展开 jee-example-app-1.0.0.ear/jee-example-services.jar 以检查故事点、Java 事件软件包以及此存档中找到的技术计数。此摘要以分配给其迁移的故事总数开始，然后表详细说明存档中每个文件所需的更改。该报告包含以下几列。

请注意，如果某个归档在应用程序中重复多次，它将仅在报告中列出一次，并会标记 [Included multiple times]。

图 3.7. 应用程序中的重复归档

在应用程序内重复归档的案例点仅计算该应用程序的总故事点数一次。

单击 Technologies 链接，从仪表板访问此报告。

报告在分析的应用程序中列出了按功能分组的技术。概述了应用程序中找到的技术，旨在帮助用户快速了解每个应用程序的用途。

下图显示了 jee-example-app 中使用的技术。

图 3.8. 应用程序中的技术

Source 报告会在发现它们的源文件上下文中显示迁移问题。

图 3.9. 源报告