CLI ガイド

手順

1. MTA ダウンロードページ に移動し、以下のオペレーティングシステム固有の CLI ファイルまたは src ファイルをダウンロードします。

   • mta-7.3.2-cli-linux-amd64.zip
   • mta-7.3.2-cli-linux-arm64.zip
   • mta-7.3.2-cli-darwin-amd64.zip
   • mta-7.3.2-cli-darwin-arm64.zip
   • mta-7.3.2-cli-windows-amd64.zip
   • mta-7.3.2-cli-windows-arm64.zip
   • mta-7.3.2-cli-src.zip
2. .zip ファイルを $HOME ディレクトリー内の .kantra ディレクトリーに展開します。.zip ファイルを展開すると、mta-cli バイナリーとその他の必要なディレクトリーおよびファイルが作成されます。

3. mta-cli バイナリーを $PATH 変数に移動します。

   注記

   mta-cli バイナリーは $PATH 変数に含まれる任意のフォルダーに配置できます。または、mta-cli を含むフォルダーを $PATH に追加することもできます。これにより、CLI の使用時に完全パスを指定する必要はありません。

1. 外部のコンピューターを使用して必要なイメージをダウンロードします。
2. ダウンロードしたイメージを、MTA CLI をインストールするシステムにコピーします。

手順

1. 接続されたデバイスで、次の手順を実行します。

   1. registry.redhat.io に対して認証します。

      $ podman login registry.redhat.io

      Copy to Clipboard Toggle word wrap

   2. mta-cli バイナリーファイルを実行します。バイナリーファイルは必要なプロバイダーイメージを取得します。以下に例を示します。

      $ mta-cli analyze

      Copy to Clipboard Toggle word wrap
      重要

      このコマンドは必要なイメージのみをプルします。たとえば、Java イメージを必要とするコマンドを実行すると、.NET イメージはプルされません。

   3. イメージリストを表示します。

      $ podman images
      REPOSITORY                                                        TAG         IMAGE ID      CREATED       SIZE
      registry.redhat.io/mta/mta-generic-external-provider-rhel9        7.3.1       8b8d7fa14570  13 days ago   692 MB
      registry.redhat.io/mta/mta-cli-rhel9                              7.3.1       45422a12d936  13 days ago   1.6 GB
      registry.redhat.io/mta/mta-java-external-provider-rhel9           7.3.1       4d6d0912a38b  13 days ago   715 MB
      registry.redhat.io/mta/mta-dotnet-external-provider-rhel9         7.3.1       66ec9fc51408  13 days ago   1.27 GB

      Copy to Clipboard Toggle word wrap

   4. イメージを保存します。

      $ podman save <image_ID> -o <image_name>.image

      Copy to Clipboard Toggle word wrap
   5. イメージを USB ドライブにコピーするか、非接続デバイスのファイルシステムに直接コピーします。

2. 非接続デバイスで、次のように入力します。

   $ podman load --input <image_name>.image

   Copy to Clipboard Toggle word wrap

手順

1. 管理者権限で PowerShell を開きます。

2. Hyper-V がインストールされ、有効になっていることを確認します。

   PS C:\Users\<user_name>> Enable-WindowsOptionalFeature -Online ` -FeatureName Microsoft-Hyper-V-All

   Copy to Clipboard Toggle word wrap

   PS C:\Users\<user_name>> Enable-WindowsOptionalFeature -Online ` -FeatureName Containers

   Copy to Clipboard Toggle word wrap
   注記

   変更を有効にするには、Windows を再起動する必要がある場合があります。

3. Windows に Docker Desktop をインストールします。

   1. Docker_Desktop_Installer.exe ファイルをダブルクリックしてインストーラーを実行します。

      デフォルトでは、Docker Desktop は C:\Program Files\Docker\Docker パスにインストールされます。

   2. Docker が Linux コンテナーではなく Windows コンテナーをバックエンドとして実行するようにしてください。

      1. Windows タスクバーで、Docker アイコンを右クリックします。
      2. Switch to Windows containers をクリックします。

4. PowerShell で、MTA 用のフォルダーを作成します。

   PS C:\Users\<user_name>> mkdir C:\Users\<user_name>\MTA

   Copy to Clipboard Toggle word wrap

5. mta-7.3.2-cli-windows.zip ファイルを MTA フォルダーに展開します。

   PS C:\Users\<user_name>> cd C:\Users\<user_name>\Downloads

   Copy to Clipboard Toggle word wrap

   PS C:\Users\<user_name>> Expand-Archive ` -Path "{ProductShortNameLower}-{ProductVersion}-cli-windows.zip" ` -DestinationPath "C:\Users\<user_name>\MTA"

   Copy to Clipboard Toggle word wrap

6. Docker が Windows コンテナーを実行していることを確認し、OS/Arch が windows/amd64 に設定されていることを確認します。

   PS C:\Users\<user_name>> docker version

   Copy to Clipboard Toggle word wrap

   Client:
    Version:           27.0.3
    API version:       1.46
    Go version:        go1.21.11
    Git commit:        7d4bcd8
    Built:             Sat Jun 29 00:03:32 2024
    OS/Arch:           windows/amd64
    Context:           desktop-windows
   Server: Docker Desktop 4.32.0 (157355)
    Engine:
     Version:          27.0.3
     API version:      1.46 (minimum version 1.24)
     Go version:       go1.21.11
     Git commit:       662f78c
     Built:            Sat Jun 29 00:02:13 2024
     OS/Arch:          windows/amd64
     Experimental:     false

   Copy to Clipboard Toggle word wrap

7. Docker を使用するには、CONTAINER_TOOL 環境変数を設定します。

   PS C:\Users\<user_name>> $env:CONTAINER_TOOL="C:\Windows\system32\docker.exe"

   Copy to Clipboard Toggle word wrap

8. アップストリームの dotnet-external-provider を使用するように DOTNET_PROVIDER_IMG 環境変数を設定します。

   PS C:\Users\<user_name>> $env:DOTNET_PROVIDER_IMG="quay.io/konveyor/dotnet-external-provider:v0.5.0"

   Copy to Clipboard Toggle word wrap

9. アップストリームイメージを使用するように RUNNER_IMG 環境変数を設定します。

   PS C:\Users\<user_name>> $env:RUNNER_IMG="quay.io/konveyor/kantra:v0.5.0"

   Copy to Clipboard Toggle word wrap

手順

1. オプション: 分析に利用可能なターゲットテクノロジーをリストします。

   $ mta-cli analyze --list-targets

   Copy to Clipboard Toggle word wrap

2. 分析を実行します。

   $ mta-cli analyze --input <path_to_input> --output <path_to_output> --source <source_name> --target <target_name>

   Copy to Clipboard Toggle word wrap

   次の引数を指定します。

   • --input: 評価するアプリケーション。

   • --output: 生成されたレポートの出力ディレクトリー。mta-cli analyze は、次の分析レポートを作成します。

     ./
     ├── analysis.log
     ├── dependencies.yaml
     ├── output.yaml
     ├── shim.log
     ├── static-report
     └── static-report.log

     Copy to Clipboard Toggle word wrap
   • --source: アプリケーション移行のソーステクノロジー (例: weblogic)。
   • --target: アプリケーション移行のターゲットテクノロジー (例: eap8)。

3. 生成された分析レポートにアクセスします。

   1. mta-cli analyze コマンドの出力で、index.html 分析レポートファイルへのパスをコピーします。

      Report created: <output_report_directory>/index.html
                	Access it at this URL: file:///<output_report_directory>/index.html

      Copy to Clipboard Toggle word wrap
   2. 選択したブラウザーへのパスを貼り付けます。

   または、Ctrl を押しながらレポートファイルへのパスをクリックします。

手順

1. 複数のアプリケーションに対して分析を実行します。

   重要

   分析コマンドごとに 1 つの入力を指定する必要がありますが、すべての入力に対して同じ出力ディレクトリーを指定するようにしてください。

   たとえば、サンプルアプリケーション A、B、C を分析するには、次のコマンドを入力します。

   1. 入力 A には次のように指定します。

      $ mta-cli analyze --bulk --input <path_to_input_A> --output <path_to_output_ABC> --source <source_A> --target <target_A>

      Copy to Clipboard Toggle word wrap

   2. 入力 B には次のように指定します。

      $ mta-cli analyze --bulk --input <path_to_input_B> --output <path_to_output_ABC> --source <source_B> --target <target_B>

      Copy to Clipboard Toggle word wrap

   3. 入力 C には次のように指定します。

      $ mta-cli analyze --bulk --input <path_to_input_C> --output <path_to_output_ABC> --source <source_C> --target <target_C>

      Copy to Clipboard Toggle word wrap
2. 分析レポートにアクセスします。MTA は、アプリケーションを移行する前に解決する必要があるすべての問題をリストした単一のレポートを生成します。

手順

1. オプション: すべての mta-cli analyze コマンドオプションを表示します。

   $ mta-cli analyze --help

   Copy to Clipboard Toggle word wrap

2. アプリケーション分析を実行します。

   $ mta-cli analyze --overwrite --input <path_to_input> --output <path_to_output> --target <target_source>

   Copy to Clipboard Toggle word wrap
   注記

   --overwrite オプションは、出力フォルダーが存在する場合にそのフィルダーを上書きします。

手順

1. 分析レポートを開きます。詳細は、分析レポートへのアクセス を参照してください。
2. Issues をクリックします。
3. 確認する問題をクリックします。
4. File タブでファイルをクリックすると、問題を引き起こしたインシデントが表示されます。

5. インシデントをトリガーした行にマウスを移動して、インシデントメッセージを表示します。例:

   Use the Quarkus Maven plugin adding the following sections to the pom.xml file:
   <properties>
   <quarkus.platform.group-id>io.quarkus.platform</quarkus.platform.group-id>
   <quarkus.platform.version>3.1.0.Final</quarkus.platform.version>
   </properties>
   <build>
   <plugins>
   <plugin>
   <groupId>$</groupId>
   <artifactId>quarkus-maven-plugin</artifactId>
   <version>$</version>
   <extensions>true</extensions>
   <executions>
   <execution>
   <goals>
   <goal>build</goal>
   <goal>generate-code</goal>
   <goal>generate-code-tests</goal>
   </goals>
   </execution>
   </executions>
   </plugin>
   </plugins>
   </build>

   Copy to Clipboard Toggle word wrap

手順

1. 利用可能な OpenRewrite レシピを表示します。

   $ mta-cli transform openrewrite --list-targets

   Copy to Clipboard Toggle word wrap

2. アプリケーションのソースコードを変換します。

   $ mta-cli transform openrewrite --input=<path_to_source_code> --target=<target_from_the_list>

   Copy to Clipboard Toggle word wrap

手順

1. ターミナルアプリケーションを開き、<MTA_HOME>/ ディレクトリーに移動します。

2. 検出プロセスでサポートされているプラットフォームをリスト表示します。

   $ mta-cli discover --list-platforms

   Copy to Clipboard Toggle word wrap

3. CF アプリケーションの検出マニフェストを出力ファイルとして生成します。

   $ mta-cli discover cloud-foundry \ --input <path_to_application-manifest> \ --output <path_to_discovery-manifest>\

   Copy to Clipboard Toggle word wrap

手順

1. ターミナルアプリケーションを開き、<MTA_HOME>/ ディレクトリーに移動します。

2. デプロイメントマニフェストを出力ファイルとして生成します。

   $ mta-cli generate helm --chart-dir helm_sample \ --input <path_to_discovery-manifest> \ --output-dir <location_of_deployment_manifest> \

   Copy to Clipboard Toggle word wrap

3. ConfigMap を確認します。

   $ mta-cli cd <location_of_deployment_manifest> \
   $ cat configmap.yaml
   $ cat Dockerfile

   Copy to Clipboard Toggle word wrap

4. Dockerfile を確認します。

   $ mta-cli cd <location_of_deployment_manifest> \
   $ cat Dockerfile

   Copy to Clipboard Toggle word wrap

手順

1. ターミナルアプリケーションを開き、<MTA_HOME>/ ディレクトリーに移動します。

2. CF Node.js アプリケーションマニフェストの内容を確認します。

   $ cat cf-nodejs-app.yaml
   name: cf-nodejs
   lifecycle: cnb
   buildpacks:
     - docker://my-registry-a.corp/nodejs
     - docker://my-registry-b.corp/dynatrace
   memory: 512M
   instances: 1
   random-route: true

   Copy to Clipboard Toggle word wrap

3. 検出マニフェストを生成します。

   $ mta-cli discover cloud-foundry \ --input cf-nodejs-app.yaml \ --output discover.yaml \

   Copy to Clipboard Toggle word wrap

4. 検出マニフェストの内容を確認します。

   $ cat discover.yaml
   name: cf-nodejs
   randomRoute: true
   timeout: 60
   buildPacks:
   - docker://my-registry-a.corp/nodejs
   - docker://my-registry-b.corp/dynatrace
   instances: 1

   Copy to Clipboard Toggle word wrap

5. discover.yaml ファイルを使用して、newDir ディレクトリーにデプロイメントマニフェストを生成します。

   $ mta-cli generate helm \ --chart-dir helm_sample \ --input discover.yaml --output-dir newDir

   Copy to Clipboard Toggle word wrap

6. newDir ディレクトリー内の Dockerfile の内容を確認します。

   $ cat ./newDir/Dockerfile
   FROM busybox:latest
   
   RUN echo "Hello cf-nodejs!"

   Copy to Clipboard Toggle word wrap

7. newDir ディレクトリーの ConfigMap の内容を確認します。

   $ cat ./newDir/configmap.yaml
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cf-nodejs-config
   data:
     RANDOM_ROUTE: true
     TIMEOUT: "60"
     BUILD_PACKS: |
       - docker://my-registry-a.corp/nodejs
       - docker://my-registry-b.corp/dynatrace
     INSTANCES: "1"

   Copy to Clipboard Toggle word wrap

8. ConfigMap で、name を nodejs-app に、INSTANCES を 2 にオーバーライドします。

   $ mta-cli generate helm \ --chart-dir helm_sample \ --input discover.yaml --set name="nodejs-app" \ --set instances=2 \ --output-dir newDir \

   Copy to Clipboard Toggle word wrap

9. ConfigMap の内容を再度確認します。

   $ cat ./newDir/configmap.yaml
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: nodejs-app
   data:
     RANDOM_ROUTE: true
     TIMEOUT: "60"
     BUILD_PACKS: |
       - docker://my-registry-a.corp/nodejs
       - docker://my-registry-b.corp/dynatrace
     INSTANCES: "2"

   Copy to Clipboard Toggle word wrap