使用 Notebooks API 註冊舊版執行個體

本頁說明如何遷移及註冊舊版使用者管理的筆記本執行個體，並使用 Notebooks API。使用 Compute Engine API 建立的執行個體稱為「舊版執行個體」，這類執行個體不會收到最新的功能與機制更新內容。

如要使用 Notebooks API 提供的新功能與機制，您必須向 Notebooks API 註冊舊版執行個體。註冊舊版執行個體前，請先確認是否符合相關規定。您可以migrate不符合規定的執行個體。

如果您在註冊舊版執行個體前啟用 Notebooks API，Notebooks API 啟用程序會嘗試自動註冊現有的舊版執行個體。

需求條件和限制

使用 Notebooks API 註冊舊版執行個體前，請先瞭解下列規定和限制。

  • 來源和目的地可用區必須相符，且是 Notebooks API 的有效可用區。

    舉例來說，如果舊版使用者管理的筆記本執行個體位於 us-west1-a，透過 Notebooks API 註冊後仍會位於 us-west1-a。不過，us-central1-f 中由使用者管理的舊版筆記本執行個體不會向 Notebooks API 註冊，因為 us-central1-f 不是 Notebooks API 的有效區域。

    如要取得 Notebooks API 筆記本執行個體的有效區域清單，請在偏好的終端機或 Cloud Shell 中，使用 Google Cloud CLI 執行下列指令：

    gcloud notebooks locations list

    如果舊版執行個體的區域不是 Notebooks API 的有效區域，請與支援團隊或帳戶管理員聯絡，或將舊版執行個體遷移至新的使用者管理 Notebooks 執行個體。

  • 只有雙磁碟執行個體才能使用所有由使用者管理的筆記本功能。

    即使向 Notebooks API 註冊，單一磁碟舊版執行個體也無法使用部分由使用者管理的筆記本功能，例如自動升級。如要讓單一磁碟舊版執行個體使用所有可用功能，請將單一磁碟執行個體遷移至雙磁碟執行個體。

    從舊版執行個體遷移至透過 Notebooks API 註冊的執行個體時，您可以將單一磁碟執行個體遷移至雙磁碟執行個體。如果您已向 Notebooks API 註冊舊版執行個體，仍可將執行個體遷移至新的雙磁碟執行個體，以解決問題。

    如要驗證磁碟數量，請完成下列步驟。

    控制台

    1. 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

      前往 VM 執行個體

    2. 找出目前的舊版由使用者管理的筆記本執行個體。

    3. 按一下執行個體名稱，開啟「VM instance details」(VM 執行個體詳細資料) 頁面。

    4. 在「啟動磁碟」和「其他磁碟」部分，確認附加至 VM 的磁碟數量。

    gcloud

    1. 在 Cloud Shell 或任何已安裝 Google Cloud CLI 的環境中，輸入下列 Google Cloud CLI 指令：

      gcloud compute instances describe MY_INSTANCE_NAME \
    --zone=MY_ZONE

      更改下列內容：

      • MY_INSTANCE_NAME：執行個體名稱
      • MY_ZONE：執行個體所在的可用區

    2. 查看「disks:」後方的資訊，確認附加至 VM 的磁碟數量。

將舊版執行個體遷移至新的使用者管理筆記本執行個體

如果舊版使用者管理的 Notebooks 執行個體位於 Notebooks API 無效的區域，或是您想從單一磁碟執行個體遷移至雙磁碟執行個體，就必須建立使用者管理的 Notebooks 執行個體，並將使用者資料從舊版執行個體複製到新執行個體。

如要建立由使用者管理的筆記本執行個體，並將舊版執行個體的使用者資料複製到新執行個體，請完成下列步驟：

  1. 如要使用 ssh 連線至舊版執行個體，請在 Cloud Shell 或已安裝 Google Cloud CLI 的任何環境中，輸入下列 Google Cloud CLI 指令：

    export PROJECT_ID="MY_PROJECT_ID"
export ZONE="MY_ZONE"
export INSTANCE_NAME="MY_INSTANCE"
gcloud compute ssh \
    --project $PROJECT_ID \
    --zone $ZONE $INSTANCE_NAME \
    -- -L 8080:localhost:8080

    更改下列內容：

    • MY_PROJECT_ID：您的 Google Cloud 專案 ID
    • MY_ZONE：執行個體所在的可用區
    • MY_INSTANCE：執行個體名稱，並附上相關資訊。

  2. 如要將舊版執行個體的內容複製到 Cloud Storage bucket，請使用 gcloud storage。以下範例指令會將預設目錄 /home/jupyter/ 中的所有筆記本 (.ipynb) 檔案，複製到名為 my-bucket/legacy-notebooks 的 Cloud Storage 目錄。

    gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive

  3. 建立由使用者管理的筆記本執行個體，並使用與舊版執行個體相同的硬體規格。您可以使用Google Cloud 控制台或 Google Cloud CLI 建立執行個體。

    在本範例中，Vertex AI Workbench 會在 example 專案中，使用最新的 TensorFlow 2 映像檔，以 n1-standard-1 機器類型在 us-west1-a 地區中，建立名為 new-notebook 的使用者管理筆記本執行個體。

    在 Cloud Shell 或任何已安裝 Google Cloud CLI 的環境中，輸入下列 Google Cloud CLI 指令：

    gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a

    新的使用者自行管理的筆記本執行個體是雙磁碟。 包含開機磁碟和資料磁碟。

  4. 使用 ssh 連線至您剛建立的由使用者管理的筆記本執行個體。

  5. 如要將舊版執行個體中的內容從 Cloud Storage bucket 複製到新執行個體，請使用 gcloud storage。以下範例指令會將 Cloud Storage 目錄中的所有筆記本 (.ipynb) 檔案，複製到新執行個體的 /home/jupyter/ 目錄。

    gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive

  6. 在新使用者管理的筆記本執行個體中，開啟 JupyterLab，並確認使用者資料和資產已成功複製。

  7. 選用：刪除舊版執行個體。

使用 Notebooks API 註冊舊版執行個體

如要使用 Notebooks API 管理舊版執行個體，您必須向 Notebooks API 註冊舊版執行個體。

如果您在註冊舊版執行個體前啟用 Notebooks API，Notebooks API 啟用程序會嘗試自動註冊現有的舊版執行個體。如果您在啟用 Notebooks API 後建立舊版執行個體，就必須使用下列其中一種方法手動註冊。

如要透過 Notebooks API 註冊舊版執行個體，可以使用 Google Cloud 主控台或 Notebooks API。

控制台

如要在 Google Cloud 控制台中使用「全部註冊」選項，請完成下列步驟：

  1. 前往 Google Cloud 控制台的「User-managed notebooks」頁面。

    前往使用者自行管理的筆記本

  2. 如果您有一或多個舊版使用者管理筆記本執行個體，系統會顯示訊息，指出您需要透過 Notebooks API 註冊這些執行個體。按一下該訊息旁邊的「全部註冊」。

  3. 如果您沒有任何舊版使用者管理的 Notebooks 執行個體，但尚未啟用 Notebooks API，請點選「啟用 Notebooks API」，確保新建立的使用者管理 Notebooks 執行個體會使用 Notebooks API。

Notebooks API

如要使用 Notebooks API 提供的 register 方法，請在 Cloud Shell 或已安裝 Google Cloud CLI 的任何環境中，輸入下列 Google Cloud CLI 指令：

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

更改下列內容：

  • MY_INSTANCE_NAME：執行個體名稱
  • MY_ZONE：執行個體所在的可用區

後續步驟