第2章 CLI のインストールおよび実行

手順

1. MTA Download page に移動し、OS 固有の CLI ファイルまたは src ファイルをダウンロードします。

   • MTA-7.2.3-cli-linux-amd64.zip
   • MTA-7.2.3-cli-linux-arm64.zip
   • MTA-7.2.3-cli-darwin-amd64.zip
   • MTA-7.2.3-cli-darwin-arm64.zip
   • MTA-7.2.3-cli-windows-amd64.zip
   • MTA-7.2.3-cli-windows-arm64.zip
   • MTA-7.2.3-cli-src.zip

2. .zip ファイルを $HOME ディレクトリー内の .kantra ディレクトリーに展開します。この .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 Desktop をインストールします。

   1. Docker_Desktop_Installer.exe をダブルクリックしてインストーラーを実行します。デフォルトでは、Docker Desktop は C:\Program Files\Docker\Docker にインストールされます。
   2. 設定ページで Use WSL 2 instead of Hyper-V オプションの選択を解除して、Docker が Linux コンテナーではなく Windows コンテナーをバックエンドとして実行するようにします。

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.2.3-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. Docker を使用するように PODMAN_BIN 環境変数を設定します。

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

   Copy to Clipboard Toggle word wrap

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

   PS C:\Users\<your_user_name>> $env:DOTNET_PROVIDER_IMG="registry.redhat.io/mta/mta-dotnet-external-provider-rhel9:7.1.0"

   Copy to Clipboard Toggle word wrap

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

   # double-check reference
   PS C:\Users\<your_user_name>> $env:RUNNER_IMG="registry.redhat.io/mta/mta-cli-rhel9:7.1.0"

   Copy to Clipboard Toggle word wrap