Linux 用 Migrate to Containers CLI リファレンス
m2c
は、ローカルマシンで移行を設定して実行できるようにするコマンドライン ツールです。
m2c
Migrate to Containers のコマンドライン インターフェース。
次の 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