Linux 用 Migrate to Containers CLI リファレンス

m2c は、ローカルマシンで移行を設定して実行できるようにするコマンドライン ツールです。

m2c

Migrate to Containers のコマンドライン インターフェース。

次の 4 つの手順でワークロードをすばやくモダナイズします。

  1. ソースマシンからローカルにファイル システムをコピーします。

  2. ファイル システムを分析して、モダナイゼーション計画を作成します。

  3. プランを編集してモダナイゼーション アーティファクトをカスタマイズします。

  4. モダナイゼーション アーティファクトを生成します。

概要

m2c COMMAND [options]

フラグ

-q,--quiet
何も出力しない
-v,--verbose
詳細出力を表示

コマンド

コマンド 説明
m2c analyze 指定されたファイル システムでワークロードの構成を分析します。
m2c cleanup 移行元のファイル システムをクリーンアップします。
m2c completion 指定されたシェルにオートコンプリート スクリプトを生成します。
m2c config 構成プロパティの表示と編集を行います。
m2c copy VM のファイル システムをローカルにコピーします。
m2c generate 指定されたファイル システムから移行アーティファクトを生成します。
m2c help コマンドに関するヘルプ
m2c migrate-data ローカルマシンから PVC にデータを移行します。
m2c plugins 移行プラグインを管理します。
m2c version CLI バージョンを出力します。

m2c analyze

特定のプラグインを使用して、特定のファイル システムでワークロードの構成を分析します。

生成されたモダナイゼーション計画は、指定された出力ディレクトリの config.yaml ファイルで確認できます。

概要

m2c analyze --source COPIED_FILESYSTEM_PATH --plugin PLUGIN_NAME --output OUTPUT_DIR [options]

フラグ

-o,--output path
m2c generate コマンドへの入力として使用できる出力パス
-r,--parameter name=value
name=value 形式のプラグイン分析パラメータ。複数行で指定することもできます。
-p,--plugin name
プラグイン名
-s,--source path
m2c copy コマンドで生成されたファイル システムのパス
--volume localPath:remotePath
Bind は、ファイルまたはディレクトリを localPath:remotePath の形式でコンテナにマウントします。複数行で指定することもできます。

m2c cleanup

copy コマンドで作成されたソースファイル システムをクリーンアップします。

概要

m2c cleanup -s SOURCE

フラグ

-s,--source path
m2c copy によって作成されたソースのパス

m2c completion

指定されたシェルに m2c のオートコンプリート スクリプトを生成します。

生成されたスクリプトの使用方法について詳しくは、各サブコマンドのヘルプをご覧ください。

概要

m2c completion

コマンド

コマンド 説明
m2c completion bash bash のオートコンプリート スクリプトを生成します
m2c completion fish fish のオートコンプリート スクリプトを生成します
m2c completion powershell PowerShell のオートコンプリート スクリプトを生成します
m2c completion zsh zsh のオートコンプリート スクリプトを生成します

m2c completion bash

bash シェルのオートコンプリート スクリプトを生成します。

このスクリプトは、bash-completion パッケージに依存しています。

まだインストールされていない場合は、OS のパッケージ マネージャーを使用してインストールできます。

現在のシェル セッションで補完を読み込むには:

    source <(m2c completion bash)

新しいセッションごとに補完を読み込むには、1 回実行します。

Linux:

    m2c completion bash > /etc/bash_completion.d/m2c

macOS:

    m2c completion bash > $(brew --prefix)/etc/bash_completion.d/m2c

この設定を有効にするには、新しいシェルを起動する必要があります。

概要

m2c completion bash

フラグ

--no-descriptions
補完の説明を無効にします

m2c completion fish

fish シェルのオートコンプリート スクリプトを生成します。

現在のシェル セッションで補完を読み込むには:

    m2c completion fish | source

新しいセッションごとに補完を読み込むには、1 回実行します。

    m2c completion fish > ~/.config/fish/completions/m2c.fish

この設定を有効にするには、新しいシェルを起動する必要があります。

概要

m2c completion fish

フラグ

--no-descriptions
補完の説明を無効にします

m2c completion powershell

PowerShell のオートコンプリート スクリプトを生成します。

現在のシェル セッションで補完を読み込むには:

    m2c completion powershell | Out-String | Invoke-Expression

新しいセッションごとに補完を読み込むには、上記のコマンドの出力を

PowerShell プロファイルに追加します。

概要

m2c completion powershell

フラグ

--no-descriptions
補完の説明を無効にします

m2c completion zsh

zsh シェルのオートコンプリート スクリプトを生成します。

環境でシェル補完がまだ有効になっていない場合は

有効にする必要があります。次のコマンドを 1 回実行できます。

    echo "autoload -U compinit; compinit" >> ~/.zshrc

現在のシェル セッションで補完を読み込むには:

    source <(m2c completion zsh)

新しいセッションごとに補完を読み込むには、1 回実行します。

Linux:

    m2c completion zsh > "${fpath[1]}/_m2c"

macOS:

    m2c completion zsh > $(brew --prefix)/share/zsh/site-functions/_m2c

この設定を有効にするには、新しいシェルを起動する必要があります。

概要

m2c completion zsh

フラグ

--no-descriptions
補完の説明を無効にします

m2c config

構成プロパティの表示と編集を行います。

概要

m2c config COMMAND

コマンド

コマンド 説明
m2c config get 構成プロパティの値を出力するには:
m2c config list すべての構成プロパティとその値を出力します。
m2c config set 構成プロパティの値を設定します。
m2c config unset 構成プロパティをデフォルト値にリセットするには:

m2c config get

構成プロパティの値を出力するには:

概要

m2c config get KEY

m2c config list

すべての構成プロパティとその値を出力します。

概要

m2c config list

m2c config set

構成プロパティの値を設定します。

概要

m2c config set KEY VALUE

m2c config unset

構成プロパティをデフォルト値にリセットするには:

概要

m2c config unset KEY

m2c copy

VM のファイル システムをローカルにコピーします。

コピーは rsync を介して行われ、gcloud またはダイレクト SSH を使用して実行できます。

概要

m2c copy COMMAND

コマンド

コマンド 説明
m2c copy default-filters コピー オペレーションで使用されるデフォルトの rsync フィルタを表示します。
m2c copy gcloud gcloud を介して Google Cloud VM のファイル システムをローカルにコピーします。
m2c copy ssh SSH を介して VM のファイル システムをローカルマシンにコピーします。

m2c copy default-filters

コピー オペレーションで使用されるデフォルトの rsync フィルタを表示します。

これは、--filters フラグを使用してカスタム フィルタ ファイルを提供する場合に使用できます。

概要

m2c copy default-filters

m2c copy gcloud

gcloud を介して Google Cloud VM のファイル システムをローカルにコピーします。

概要

m2c copy gcloud -p,--project PROJECT_ID -z,--zone ZONE -n,--vm-name VM_NAME -o,--output OUTPUT_PATH [options]

フラグ

--filters path
カスタム rsync フィルタ ファイルのパス。デフォルトのフィルタをオーバーライドします
--internal-ip
外部 IP アドレスではなく内部 IP アドレスを使用してインスタンスに接続します。これは、同じ VPC ネットワーク上の別のインスタンス、VPN 接続、またはピアリングされた 2 つの VPC ネットワーク間で接続するために使用します。この接続を機能させるには、接続するインスタンスの内部 IP アドレスへの SSH 接続を許可するようにネットワークとファイアウォールを構成する必要があります。このフラグの使用方法については、https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances をご覧ください。
-o,--output path
コピーされたファイル システムの出力パス
-p,--project project
Google Cloud プロジェクト
--remote-sudo
rsync のリモート側で sudo を使用します。渡される認証情報が root ユーザーのものではない場合は、このオプションを使用します。スーパーユーザーとして実行しないと、ファイル システム全体をコピーできません。rsync に --rsync-path 'sudo rsync' を渡す場合と同じです。
--tunnel-through-iap
TCP 転送用に Cloud Identity-Aware Proxy を介して SSH 接続をトンネルします。詳細については、TCP 転送の IAP ドキュメント（https://cloud.google.com/iap/docs/tcp-forwarding-overview）をご覧ください。
-n,--vm-name name
VM 名
-z,--zone zone
Google Cloud ゾーン

m2c copy ssh

SSH を介して VM のファイル システムをローカルマシンにコピーします。

概要

m2c copy ssh [USER@]HOST -o,--output OUTPUT_PATH [options]

フラグ

--filters path
カスタム rsync フィルタ ファイルのパス。デフォルトのフィルタをオーバーライドします
-i,--identity-file key
認証用の鍵を含むファイル
-o,--output path
コピーされたファイル システムの出力パス
--remote-sudo
rsync のリモート側で sudo を使用します。渡される認証情報が root ユーザーのものではない場合は、このオプションを使用します。スーパーユーザーとして実行しないと、ファイル システム全体をコピーできません。rsync に --rsync-path 'sudo rsync' を渡す場合と同じです。

m2c generate

指定されたファイル システムから移行アーティファクトを生成します。

これは、前の分析オペレーションで生成された移行計画構成を利用します。

概要

m2c generate -i ANALYSIS_DIRECTORY -o OUTPUT_PATH [options]

フラグ

-i,--input path
m2c analyze によって生成されたディレクトリのパス
-o,--output path
出力パス
--volume localPath:remotePath
Bind は、ファイルまたはディレクトリを localPath:remotePath の形式でコンテナにマウントします。複数行で指定することもできます。

m2c help

ヘルプは、アプリケーション内のあらゆるコマンドのヘルプを提供します。

m2c help [コマンドのパス] と入力するだけで詳細を確認できます。

概要

m2c help [command]

m2c migrate-data

データ移行計画に沿って、ローカルマシンから現在接続されているクラスタの PVC にデータを移行します。

概要

m2c migrate-data -i INPUT_PATH [options]

フラグ

-i,--input path
m2c 分析によって生成されたディレクトリのパス
-n,--namespace namespace
ターゲット クラスタのターゲット PVC の名前空間

m2c plugins

概要

m2c plugins COMMAND

コマンド

コマンド 説明
m2c plugins unpack ローカル ファイルからプラグインをインポートします。

m2c plugins unpack

ローカル ファイルからプラグインをインポートします。

プラグイン バンドル ファイルをダウンロードするには、https://cloud.google.com/migrate/containers/docs/m2c-cli/prepare-for-migration をご覧ください。

概要

m2c plugins unpack -i,--input PATH [options]

フラグ

-i,--input string
プラグイン ファイルのパス
-r,--registry string
ターゲット クラスタで利用可能な Container Registry。データ移行プロセスで使用されるイメージは、このレジストリに push され、インターネットからイメージを pull しなくてもデータ移行が行われるようにします。

m2c version

CLI バージョンを出力します。

概要

m2c version