第 2 章 安装和运行 CLI

流程

1. 进入到 MTA Download 页面，并下载特定于操作系统的 CLI 文件或 src 文件：

   • mta-7.1.1-cli-linux.zip
   • mta-7.1.1-cli-macos.zip
   • mta-7.1.1-cli-windows.zip
   • mta-7.1.1-cli-src.zip

2. 将 .zip 文件提取到您选择的目录。.zip 文件提取一个名为 mta-cli 的二进制文件。

   在本指南中遇到 <MTA_HOME> 时，将其替换为 MTA 安装的实际路径。

流程

1. 运行以下命令，使用 Podman 向 registry.redhat.io 进行身份验证：

   $ podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

   输入用户名和密码：

   Username: <username>
   Password: <***********>

   Copy to Clipboard Toggle word wrap

2. 运行以下命令复制二进制 PATH 以启用系统范围的使用：

   $ podman cp $(podman create registry.redhat.com/mta-toolkit/mta-mta-cli-rhel9:{ProductVersion}):/usr/local/bin/mta-cli ./

   Copy to Clipboard Toggle word wrap
   警告

   虽然可以使用 Podman 进行安装，但下载和安装 .zip 文件是首选的安装。

流程

1. 使用管理员特权打开 PowerShell。

2. 确保已安装并启用 Hyper-V：

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
   注意

   您可能需要重启 Windows。

3. 在 Windows 上安装 Docker 桌面。

   1. 双击 Docker_installed_Installer.exe 来运行安装程序。默认情况下，Docker Desktop 安装在 C:\Program Files\Docker\Docker。
   2. 在 Configuration 页面中取消选择 Use WSL 2 而不是 Hyper-V 选项，以确保 Docker 将作为后端运行 Windows 容器，而不是 Linux 容器。

4. 在 PowerShell 中，为 MTA 创建文件夹：

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

   Copy to Clipboard Toggle word wrap

   将 <your_user_name > 替换为您的主目录的用户名。

5. 将 mta-7.1.1-cli-windows.zip 文件提取到 MTA 文件夹：

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

   Copy to Clipboard Toggle word wrap

   将 <your_user_name > 替换为您的主目录的用户名。

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

   Copy to Clipboard Toggle word wrap

   将 <your_user_name > 替换为您的主目录的用户名。

6. 确保 Docker 正在运行 Windows 容器：

   PS C:\Users\<your_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 

   1

   
    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 

   2

   
     Experimental:     false

   Copy to Clipboard Toggle word wrap

   1 2

   确保 OS/Arch 设置是 windows/amd64。

7. 将 PODMAN_BIN 环境变量设置为使用 Docker：

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

   Copy to Clipboard Toggle word wrap

8. 将 DOTNET_PROVIDER_IMG 环境变量设置为使用上游 dotnet-external-provider ：

   PS C:\Users\<your_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\<your_user_name>> $env:RUNNER_IMG="quay.io/konveyor/kantra:v0.5.0"

   Copy to Clipboard Toggle word wrap