本頁說明如何使用 MConnect,根據您透過 Google Cloud Migration Center 和 CAST 收集的資料,產生 Looker Studio 資訊主頁。
觀看教學課程,瞭解如何開始使用 MConnect。
總覽
MConnect 是一種指令列介面,可協助您合併來自 Migration Center 的資訊,以及 CAST Software 對應用程式執行的靜態程式碼分析結果。然後將資料匯出至 BigQuery 和 Looker Studio,以進行進階資料分析。
這項工具會比較各種轉移層面 (例如工作量、程式碼準備程度和運算資源影響),協助您將應用程式現代化。
事前準備
使用 MConnect 前,請先完成下列步驟:
- 建立 Google 帳戶和「 Google Cloud 」帳戶。
- 建立 Google Cloud 專案,並啟用 BigQuery 和 Migration Center API。
- 如要瞭解如何使用 Migration Center,請參閱「開始使用 Migration Center」。
- 如要瞭解 BigQuery,請參閱「開始使用 BigQuery」。
- 在本機電腦上安裝 Google Cloud CLI。
- 建立名為
analysisResults.csv的 CAST Highlight 報表。
定價
系統可能會根據 BigQuery、Looker Studio 和 CAST 的定價,向您收取相關費用。
生成資料的資訊主頁
以下各節說明如何為 CAST 資料產生 Looker Studio 資訊主頁。
設定工具
使用 MConnect 前,請先完成下列步驟:
如果您使用 Linux,請下載最新二進位檔。 如為其他 OS 平台,請複製
migrationcenter-utils存放區,並在本機電腦上建構 MConnect。向 Google Cloud CLI 進行驗證:
gcloud init gcloud auth application-default login請確認您使用的帳戶具備必要權限,可在遷移中心建立及刪除群組,並在要使用的專案中建立及刪除 BigQuery 資料表。
將資產上傳至 Migration Center
將 CAST 報表中與應用程式相關的資產上傳至遷移中心。如果您已為基礎架構執行目錄探索,可以略過這個步驟。
詳情請參閱「開始探索資產」。
在遷移中心建立群組
使用 CAST 報表中的應用程式,在 Migration Center 中建立群組。在本機上執行下列指令:
mconnect create-groups --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
更改下列內容:
ANALYSIS_PATH:CAST 報告檔案的路徑。PROJECT_ID:專案 ID。REGION:您用於遷移中心的區域。系統僅支援us-central1和europe-west1。
建立群組後,您可以使用 mconnect 標籤在遷移中心中篩選群組。
將資產指派給群組
在 Migration Center 中,將資產指派給對應的應用程式群組。您可以在遷移中心使用者介面中執行這項操作,也可以使用 API。
將 CAST 報告和遷移中心資料匯出至 BigQuery
將 CAST 報表中的資料匯出至 BigQuery:
mconnect export --path=ANALYSIS_PATH --project=PROJECT_ID --region=REGION
這項指令會執行下列動作:
- 系統會在 BigQuery 中建立名為
mcCast的新資料庫。 - 系統會在 BigQuery 中建立名為
castResults的新資料表,並填入 CAST 報告資料。 - 這項工具會建立名為
assets、groups和preference_sets的三個資料表,將遷移中心資料匯出至 BigQuery。
在 BigQuery 中建立檢視表
從上傳至 BigQuery 的資料建立對應的檢視區塊:
mconnect create-views --project=PROJECT_ID --dataset=mcCast
這項指令會建立三個檢視區塊:
migrationcenterinfra_vwcastreadiness_vwmccastreadinesscombined_vw
這個指令的輸出內容會提供連結,可使用 mccastreadinesscombined_vw 檢視畫面查看 Looker Studio 報表。
設定 Looker Studio 報表
您可以透過兩種方式設定產生的 Looker Studio 報表,詳情請參閱下列章節。
使用提供的連結
- 將上一個步驟取得的連結複製到網路瀏覽器。
- 依序點選「儲存並共用」和「確認並儲存」。
手動複製資料
如果提供的連結無效,您可以手動使用資料設定 Looker Studio 報表:
- 在 Looker Studio 中開啟「遷移中心 / CAST 分析」報表。
- 按一下「更多選項」。
- 依序點選「建立副本」>「複製報表」。
- 在新報表中,依序點選「資源」>「管理已新增的資料來源」。
- 使用名為
McCastReadinessCombined_vw的資料來源,然後按一下「編輯」。 - 提供上一個步驟中使用的專案 ID 和資料集 ID,然後選擇
mccastreadinesscombined_vw。 - 依序按一下「重新連線」和「套用」。
- 按一下「完成」,然後重新整理頁面。
系統會使用您的資料建立名為「Migration Center / CAST Analysis」的新報表。
MConnect 參考資料
以下各節提供可用的 MConnect 指令和標記。
mconnect
使用方式:mconnect [command] [args] [flags]
可用的指令
create-groups- 在 Migration Center 中為每個 CAST 應用程式建立群組,並為其新增「mconnect」標籤。
create-views- 使用遷移中心和 CAST 資料,在 BigQuery 中建立三個檢視區塊。
export- 將 CAST 資料匯出至 BigQuery。
help- 任何指令的說明。
旗標
-h, --help- mconnect 說明。
-t, --toggle- 切換按鈕的說明訊息。
-v, --version- mconnect 版本。
create-groups
在 Migration Center 中為每個 CAST 應用程式建立群組,並為其新增「mconnect」標籤。
使用方式:mconnect create-groups path project region [flags]
範例
mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1
mconnect create-groups --path=path/to/cast/analysisResults.csv --project=my-mc-project-id --region=my-region1 --ignore-existing-groups=true
旗標
-h, --help- 建立群組的說明。
-i, --ignore-existing-groups- 如果 mconnect 嘗試建立的群組已存在於遷移中心,請繼續操作。如果設為「true」,系統也會為所有現有群組加上「mconnect」標籤。
--path- 包含 CAST 報表的 CSV 檔案路徑 (
analysisResults.csv)。 (必要) --project- 要在其中建立 Migration Center 群組的專案 ID。請務必為每個指令使用相同的專案 ID。(必填)
--region- 要建立群組的遷移中心區域。 (必要)
匯出
將 CAST 報表和遷移中心資料匯出至 BigQuery。 預設情況下,系統會假設用於遷移中心和 BigQuery 的專案和區域相同。
使用方式:mconnect export path project region dataset [flags]
範例
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 # the default dataset will be set to 'mcCast'.
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id --force=true
mconnect export --path=path/to/cast/analysisResults.csv --project=my-project-id --region=my-region1 --dataset=dataset-id --mc-project=my-mc-project-id --mc-region=my-mc-region
旗標
--dataset- 要將資料匯出至的資料集 ID。如果資料集不存在,系統會建立資料集。如未指定,預設名稱為「mcCast」。請務必為每個指令使用相同的資料集。
-f, --force- 即使目的地資料表存在,仍強制匯出資料。這項作業會刪除原始資料表中的所有內容。
-h, --help- 匯出作業的說明。
--path- CAST 報表的 CSV 檔案路徑 (
analysisResults.csv)。(必填) --project- 要匯出資料的 BigQuery 專案 ID。(必填)
--region- 資料集和資料表建立所在的 BigQuery 區域。(必要)
隱藏的旗子
--mc-project- 用於將資料匯出至 BigQuery 的 Migration Center 專案 ID。
--mc-region- 要匯出資料的 Migration Center 區域。
create-views
使用 Migration Center 和 CAST 資料,在 BigQuery 中建立三個檢視區塊。提供使用 mccastreadinesscombined_vw 檢視畫面建立的 Looker Studio 報表連結。
使用方式:mconnect create-views project dataset [flags]
已建立的檢視畫面
migrationcenterinfra_vw:顯示從遷移中心匯入的資產資料。castreadiness_vw:顯示 CAST 分析檔案中的資料。mccastreadinesscombined_vw:合併前兩個檢視畫面。 Looker Studio 範本也會使用這個檢視區塊。
範例
mconnect create-views --project=my-project-id --dataset=dataset-id
mconnect create-views --project=my-project-id --dataset=dataset-id --force=true
旗標
--dataset- 要建立檢視區塊的 BigQuery 資料集 ID。請務必使用與匯出指令相同的資料集。(必填)
-f, --force- 即使只有一個目的地檢視區塊存在,仍強制建立檢視區塊。 這項作業會取代舊有檢視畫面中的所有內容。
-h, --help- 建立檢視區塊的說明。
--project- 要在其中建立檢視區塊的 BigQuery 專案 ID。(必填)