Migrate to Containers CLI 參考資料 (Linux 版)

m2c 是一項指令列工具，可讓您在本機電腦上設定及執行遷移作業。

m2c

Migrate to Containers 的指令列介面。

請按照四個步驟，為工作負載快速進行現代化：

1. 將檔案系統從來源電腦複製到本機。

2. 分析檔案系統，建立翻新計畫。

3. 編輯企劃書，自訂現代化構件。

4. 產生現代化構件。

概要

m2c COMMAND [options]

旗標

-q,--quiet

不輸出任何內容

-v,--verbose

顯示詳細輸出內容

指令

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

插入格式為「名稱=值」的分析參數。可多次指定

-p,--plugin name

外掛程式名稱

-s,--source path

由 m2c copy 指令產生的檔案系統路徑

--volume localPath:remotePath

Bind 會以「localPath:remotePath」格式將檔案或目錄掛接到容器中。可多次指定

m2c 清理

清理由複製指令建立的來源檔案系統。

概要

m2c cleanup -s SOURCE

旗標

-s,--source path

由 m2c copy 建立的來源路徑

m2c completion

為指定的殼層產生 m2c 的自動完成指令碼。

請參閱各個子指令的說明，進一步瞭解如何使用產生的指令碼。

概要

m2c completion

指令

m2c completion bash

為 bash 殼層產生自動完成指令碼。

這個指令碼需要使用「bash-completion」套件。

如果尚未安裝，可以透過 OS 的套件管理工具安裝。

如要在目前的 Shell 工作階段中載入完成作業：

    source <(m2c completion bash)

如要為每個新工作階段載入完成作業，請執行一次：

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 完成魚

為 fish 殼層產生自動完成指令碼。

如要在目前的 Shell 工作階段中載入完成作業：

    m2c completion fish | source

如要為每個新工作階段載入完成作業，請執行一次：

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

您必須啟動新的殼層，才能讓這項設定生效。

概要

m2c completion fish

旗標

--no-descriptions

停用完成說明

m2c completion powershell

產生 Powershell 的自動完成指令碼。

如要在目前的 Shell 工作階段中載入完成作業：

    m2c completion powershell | Out-String | Invoke-Expression

如要為每個新工作階段載入完成作業，請新增上述指令的輸出內容

至 powershell 設定檔。

概要

m2c completion powershell

旗標

--no-descriptions

停用完成說明

m2c completion zsh

為 zsh 殼層產生自動完成指令碼。

如果您尚未在環境中啟用 Shell 完成功能，請

即可啟用。您可以執行下列操作一次：

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

如要在目前的 Shell 工作階段中載入完成項目：

    source <(m2c completion zsh)

如要為每個新工作階段載入完成作業，請執行一次：

Linux：

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

macOS：

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

您必須啟動新的殼層，才能讓這項設定生效。

概要

m2c completion zsh

旗標

--no-descriptions

停用完成說明

m2c 設定

查看及編輯設定屬性。

概要

m2c config COMMAND

指令

m2c 設定取得

列印設定屬性的值。

概要

m2c config get KEY

m2c 設定清單

列印所有設定屬性及其值。

概要

m2c config list

m2c 設定組合

設定設定屬性的值。

概要

m2c config set KEY VALUE

m2c 設定未設定

將設定屬性重設為預設值。

概要

m2c config unset KEY

m2c copy

在本機複製 VM 的檔案系統。

複製作業會透過 rsync 完成，並可使用 gcloud 或直接 SSH 執行。

概要

m2c copy COMMAND

指令

m2c 複製預設篩選器

顯示複製作業使用的預設 rsync 篩選器。

這可用來建立自訂篩選器檔案，並透過 --filters 標記提供。

概要

m2c copy default-filters

m2c 複製 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 位址連線至執行個體。您可以使用此方法，透過 VPN 連線或在兩個對等互連的虛擬私有雲網路之間，從一個執行個體連線至另一個執行個體。如要讓這項連線運作，您必須設定網路和防火牆，允許 SSH 連線至您要連線的執行個體內部 IP 位址。如要瞭解如何使用這個標記，請參閱 https://cloud.google.com/compute/docs/instances/connecting-advanced#sshbetweeninstances。

-o,--output path

已複製的檔案系統的輸出路徑

-p,--project project

Google Cloud 專案

--remote-sudo

在 rsync 的遠端端使用 sudo。如果您傳遞的憑證並非屬於 root 使用者，請使用這個選項。如未以超級使用者身分執行，則無法複製整個檔案系統。等同於將 --rsync-path 'sudo rsync' 傳遞至 rsync。

--tunnel-through-iap

透過 Cloud Identity-Aware Proxy 建立 SSH 連線，以便進行 TCP 轉送。如需瞭解詳情，請參閱 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-path 'sudo rsync' 傳遞至 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 說明

說明會提供應用程式中任何指令的說明。

只要輸入 m2c help [指令路徑] 即可取得完整詳細資料。

概要

m2c help [command]

m2c migrate-data

根據資料遷移計畫，將資料從本機電腦遷移至目前已連線叢集中的 PVC。

概要

m2c migrate-data -i INPUT_PATH [options]

旗標

-i,--input path

由 m2c analyze 產生目錄的路徑

-n,--namespace namespace

目標叢集中目標 PVC 的命名空間

m2c 外掛程式

概要

m2c plugins COMMAND

指令

m2c 外掛程式解除封裝

從本機檔案匯入外掛程式。

如要下載外掛程式套件檔案，請參閱 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

可供目標叢集使用的容器登錄。資料遷移程序使用的圖片會推送至這個登錄，確保資料遷移作業能夠正常運作，而不需要從網路上擷取圖片。

m2c 版本

列印 CLI 版本。

概要

m2c version