將 Linux 應用程式遷移至容器

Migrate to Containers 與 Cloud Code 整合後，您就能在 Linux 機器中，直接在 IDE 中使用 Linux 機器，翻新在虛擬機器 (VM) 上執行的 Linux 應用程式元件，並產生可部署至 Google Kubernetes Engine 和 Cloud Run 的構件。

本指南說明如何在 Linux 電腦的 IDE 中，使用 Cloud Code 擴充功能將現有應用程式重新平台化至 GKE 容器。

本指南適用於 Linux 機器上的開發人員，他們具備 VS Code 的實際知識、熟悉 Google Cloud，並且有執行應用程式元件的 VM。

事前準備

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Google Kubernetes Engine API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Google Kubernetes Engine API.

    Enable the API

    8.
  8. 如果尚未安裝 Cloud Code 擴充功能，請先安裝。
  9. 建立及設定 GKE 叢集。
  10. 請確認您要執行哪種類型的遷移作業。如要進一步瞭解支援的工作負載，請參閱「查看相容的作業系統、工作負載和 Kubernetes 版本」。
  11. 為來源和本機電腦做好翻新準備。Cloud Code 僅支援 Linux 現代化。

    12. 新增轉移平台來源

    在本節中，您將在本機電腦上安裝 Migration Center 用戶資產評估器 CLI (mcdc) 和其他 Migration to Containers 工具 (如有需要)，然後按照下列步驟新增重新平台化來源：

    1. 在 IDE 的活動列中，按一下 「Cloud Code」，然後展開「Replatform Apps」Explorer。

    2. 如果您是第一次在 Cloud Code 中使用「遷移至容器」工具，請按一下「安裝工具」，在本機電腦上安裝 mcdc CLI 和其他「遷移至容器」工具。否則，請繼續下一步。

    3. 按一下「編輯來源」。即可開啟空白的 mcdc-sources.json 檔案。請按照下列格式新增來源：

      [
  {
    "title": "SOURCE_NAME",
    "host": "HOSTNAME",
    "user": "USER",
    "identityFile":"IDENTITY-FILE-PATH"
  }
]

    4. 如要查看來源在「Replatform Apps」探索工具中顯示，請將游標懸停在「Replatform Apps」探索工具上，然後按一下隨即顯示的「cached」「Reload sources」按鈕。

    選用：產生適配評估

    在嘗試將應用程式重新平台化至容器之前，建議您先產生來源的適合性評估，這項評估會通知您來源是否能夠重新平台化容器。

    如要產生來源的適合性評估，請在來源上按一下滑鼠右鍵，然後選取「評估來源」。系統會在 IDE 中開啟終端機，並顯示來源評估的記錄。

    評估完成後，mcdc 會在 IDE 中產生 Fit 評估報告。

    如果系統回報您的來源為「適合」，表示您已可重新架設應用程式。

    重新架構應用程式

    Cloud Code 會為每個轉移平台建立專屬工作區，讓您在工作區中執行「複製」、「分析」和「產生」工作，以便自動執行轉移平台步驟。如果您在執行「產生」工作前，先執行「複製」和「分析」工作，系統會在產生構件之前自動執行這些工作。

    以下各節將引導您執行這些任務，並使用 Cloud Code 將應用程式重新平台化至容器。

    如要進一步瞭解遷移作業的生命週期，請參閱「Migrate to Containers CLI 架構」。

    建立新的轉移平台工作區

    建立新的遷移平台工作區之前，您必須先瞭解要為遷移類型選取哪些遷移參數。如要進一步瞭解各個遷移類型的參數，請參閱「建立遷移計畫」。

    如要在 IDE 中建立含有構件的新轉移平台工作區，請按照下列步驟操作：

    1. 在「Replatform Apps」總管中，按一下要重新平台化的來源，然後點選「Replatform」。

    2. 從選單中顯示的選項清單中，選取遷移平台歷程。

    3. 選取要用來重新架構應用程式的新工作區目錄，按一下「OK」，然後按一下「Create replatform workspace」。

    4. 選取遷移類型的遷移參數。

    5. 選用：如果您選取了 WebSphere 遷移類型，且想使用二進位掃描器，請選取 binaryAppScanner.jar 檔案。

      系統需要幾秒鐘的時間才能產生工作區。這麼做會在 IDE 的新視窗中開啟新的工作區目錄。

    將檔案從 VM 複製到工作區

    如要將檔案從 VM 複製到 IDE 工作區，請執行下列步驟：

    1. 選用：mcdc CLI 會套用篩選器來縮減副本的大小，但您可以修改 filters.txt 檔案，進一步縮減副本的大小。如要瞭解如何減少複本大小，請參閱「縮減複製的檔案系統大小」。

    2. 按下 Ctrl + Shift + P 鍵開啟指令面板。

    3. 搜尋並選取「Tasks: Run Task」，然後選取「m2c: Copy」。複製檔案可能需要幾分鐘的時間。

    分析 VM 檔案系統並產生遷移計畫

    如要分析 VM 檔案系統並產生遷移計畫，請執行下列步驟：

    1. 按下 Ctrl + Shift + P 鍵開啟指令面板。

    2. 搜尋並選取「Tasks: Run Task」，然後選取「m2c: Analyze」。

      如果分析工作失敗，您必須透過 analyze-args.ini 檔案修改遷移參數。這個檔案每個參數一行，並附上參數的相關說明文件。

      分析成功後，Cloud Code 會建立名為 migration-plan 的目錄，其中包含以 config.yaml 檔案格式呈現的分析結果。您可以編輯這個檔案，變更產生構件的方式。

      config.yaml 檔案的結構會因遷移類型而異。如要進一步瞭解支援的遷移類型，請參閱下列頁面：

    產生構件

    如要產生構件，您必須在 IDE 中執行「Generate」工作。如果您尚未執行先前章節中的「複製」和「分析」工作，系統會在產生構件前自動執行這兩項工作。

    如要產生構件，請執行下列步驟：

    1. 按下 Ctrl + Shift + P 鍵開啟指令面板。

    2. 搜尋並選取「Tasks: Run Task」，然後選取「m2c: Generate」。這會在 src 目錄中產生構件，其中包含用於建構及部署容器映像檔的 skaffold.yaml 檔案。每種遷移類型都會產生不同的構件，但所有遷移類型通常會建立一或多個 dockerfile，以及 skaffold.yaml 參照的 GKE 部署規格。

      產生構件完成後，您就完成應用程式的重新平台化作業了！

    3. 選用：如要修改遷移計畫，請編輯 config.yaml 檔案，然後重新執行 m2c：產生工作。

      否則，如果您對重新平台化結果感到滿意，可以繼續在 GKE 容器中執行應用程式。

    在 GKE 容器中執行應用程式

    在本節中，您將在 GKE 容器中執行重新平台化的應用程式、查看執行中的應用程式記錄，並清理資源。

    如果您尚未建立及設定 GKE 叢集，請按照「在 Cloud Code for VS Code 中建立及設定 GKE 叢集」中的操作說明進行。

    如要進一步瞭解如何偵錯 GKE 應用程式，請參閱「使用 Cloud Code for VS Code 偵錯 Kubernetes 應用程式」一文。

    執行及查看應用程式

    設定完成後，您可以執行應用程式並查看即時畫面。Cloud Code 會監控檔案系統的變更，讓您能夠即時編輯及重新執行應用程式。

    如要執行應用程式，請按照下列步驟操作：

    1. 在 Cloud Code 狀態列中，按一下目前專案名稱。

      狀態列中的有效專案名稱

    2. 在隨即顯示的「快速挑選」選單中，選取「在 Kubernetes 中執行」。

    3. 確認是否要使用目前的叢集結構定義，或切換至其他結構定義。

    4. 如果系統顯示提示，請選擇要將圖片推送至哪個圖片註冊中心。如果您要使用 gcr.io/PROJECT_ID 建立新的映像註冊檔，請確認映像註冊檔與叢集位於相同專案中。

      輸出視窗會隨即顯示，您可以在此追蹤執行中應用程式的進度。您也會在終端機輸出內容中，看到執行中 Pod 的記錄直播。

    5. 應用程式在 Kubernetes 上執行後，輸出視窗會顯示 IP 位址。如要使用這個已連結的 IP 位址存取應用程式，請按住 Ctrl 鍵，然後按一下該位址。

    偵錯工作階段開始後，「Development sessions」窗格會顯示結構化記錄檢視畫面。任務開始時，會顯示任務和旋轉半圓形 progress_activity。

    如果工作成功，步驟旁會顯示勾號 check_circle。

    如要查看步驟的詳細資料，請在「Development session」窗格中按一下該步驟。「Output」窗格會在記錄輸出內容中顯示步驟。

    清除所用資源

    停止應用程式後，系統會自動刪除執行期間部署的所有 Kubernetes 資源。

    如要避免系統向您的帳戶收取這份快速入門課程中所用其他資源的費用，請務必刪除專案，或刪除您建立的叢集 (如果您想重複使用專案的話)。

    如要刪除叢集：

    1. 按一下 「Cloud Code」，然後展開「Kubernetes」探索工具。
    2. 將游標懸停在叢集名稱上，然後按一下「open_in_new」open_in_new。
    3. 按一下「Delete」(刪除)，然後點選「Delete」(刪除)。

    如要刪除專案 (以及相關聯的資源，包括任何叢集)，請按照下列步驟操作：

    1. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

    如要刪除在轉移平台程序期間建立的所有本機檔案，請按照下列步驟操作：

    1. 開啟指令面板 (Ctrl+Shift+P)。
    2. 搜尋並選取「Tasks: Run Task」，然後選取「m2c: Cleanup」。