建立 VMware Engine 網路

本文說明如何使用 VMware Engine 入口網站、gcloud CLI 或 API 建立 標準 VMware Engine 網路。您可以建立多個 VMware Engine 網路來區隔私有雲,並定義專屬的虛擬私有雲網路對等互連。VMware Engine 網路會根據您另外定義的網路政策,處理私有雲的進出連線。

事前準備

Google Cloud CLI 和 API 需求

如要使用 gcloud 指令列工具或 API 管理 VMware Engine 資源,建議您按照下列說明設定工具。

gcloud

  1. 設定預設專案 ID:

    gcloud config set project PROJECT_ID
    
  2. 設定預設地區和區域:

    gcloud config set compute/region REGION
    
    gcloud config set compute/zone ZONE
    

如要進一步瞭解 gcloud vmware 工具,請參閱 Cloud SDK 參考文件

API

本套說明文件中的 API 範例會使用 cURL 指令列工具查詢 API。cURL 要求中必須提供有效的存取權杖。取得有效存取權杖的方法有很多種,以下步驟會使用 gcloud 工具產生存取權杖:

  1. 登入 Google Cloud:

    gcloud auth login
    
  2. 產生存取權杖並匯出至 TOKEN:

    export TOKEN=`gcloud auth print-access-token`
    
  3. 確認已正確設定 TOKEN:

    echo $TOKEN
    

接著,請在 API 要求中使用授權權杖。例如:

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

本文件中的 Python 程式碼範例會使用 VMware Engine 程式庫與 API 通訊。如要使用這種方法,您必須安裝程式庫,並設定應用程式預設憑證

  1. 下載並安裝 Python 程式庫:

    pip install google-cloud-vmwareengine
    
  2. 在 Shell 中執行下列指令,設定 ADC 資訊:

    gcloud auth application-default login
    

    或者,使用服務帳戶金鑰檔案:

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
    

如要進一步瞭解程式庫,請參閱參考頁面,或查看 GitHub 上的程式碼範例

建立 VMware Engine 網路

使用 Google Cloud 控制台、gcloud CLI 或 VMware Engine API 建立 VMware Engine 網路:

主控台

如要使用 VMware Engine 建立 VMware Engine 網路,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「VMware Engine networks」頁面。

    前往 VMware Engine 網路

  2. 按一下「Select a project」(選取專案),然後選取要建立 VMware Engine 網路的機構、資料夾或專案。

  3. 按一下「建立」,系統會開啟 VMware Engine 網路建立表單。

  4. 輸入 VMware Engine 網路名稱。

  5. 輸入網路說明,例如「我的標準 VEN 1」,然後按一下「建立」

  6. 選用:前往「VMware Engine 網路」選單項目,確認網路建立作業。所有 VMware Engine 網路都會列在此頁面的表格中。

下列清單詳細說明建立網路時的各個欄位:

  • 名稱: VMware Engine 網路的永久專屬 ID。
  • 說明:在 VMware Engine 網路的詳細資料頁面上顯示的其他資訊。
  • 網路類型:用於支援網路用途和標準私有雲部署的網路類型 ID。
  • 區域:這取決於您是使用標準 VMware Engine 還是舊版 VMware Engine 網路。

    • 對於舊版網路,這是網路可連線的區域。
    • 對於標準網路,這個欄位一律設為全域。

gcloud

如要使用 gcloud CLI 建立 VMware Engine 網路,請按照下列步驟操作:

  1. 執行 gcloud vmware networks create 指令

    gcloud vmware networks create NETWORK_ID \
      --type=STANDARD \
      --description="DESCRIPTION"

    更改下列內容:

    • NETWORK_ID:VMware Engine 網路的 ID。
    • DESCRIPTION:這個網路的說明。
  2. 選用:如要列出所有 VMware Engine 網路,以便確認新網路已建立,請使用 gcloud vmware networks list 指令

    gcloud vmware networks list \
      --location=global

API

如要使用 VMware Engine API 建立 VMware Engine 網路,請按照下列步驟操作:

  1. 如要建立 VMware Engine 網路,請提出 POST 要求:

    POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID"
    
    '{
      "type": "standard",
      "description": "DESCRIPTION"
    }'

    更改下列內容:

    • PROJECT_ID:要建立網路的專案 ID。
    • NETWORK_ID:VMware Engine 網路的 ID。
    • DESCRIPTION:這個網路的說明。
  2. 選用步驟:如要列出所有 VMware Engine 網路,以便確認新網路的建立作業,請提出 GET 要求。將 PROJECT_ID 替換為網路所在的專案 ID。

    GET https://vmwareengine.googleapis.com/v1/projects//locations/global/vmwareEngineNetworks

更新 VMware Engine 網路

使用 Google Cloud 控制台、gcloud CLI 或 VMware Engine API 更新 VMware Engine 網路:

主控台

  1. 前往 Google Cloud 控制台的「VMware Engine networks」頁面。

    前往 VMware Engine 網路

  2. 按一下「Select a project」(選取專案),然後選取包含要更新的 VMware Engine 網路的機構、資料夾或專案。

  3. 按一下要更新的聯播網名稱。

  4. 在聯播網詳細資料頁面中編輯說明,然後按一下「儲存」

  5. 選用:如要查看更新的說明,請前往「VMware Engine 網路」選單項目,然後按一下網路即可查看詳細資料。

gcloud

如要使用 gcloud CLI 更新 VMware Engine 網路,請執行下列操作:

  1. 執行 gcloud vmware networks update 指令,更新 VMware Engine 網路的說明:

    gcloud vmware networks update NETWORK_ID \
      --description='DESCRIPTION'

    更改下列內容:

    • NETWORK_ID:VMware Engine 網路的 ID。
    • DESCRIPTION:這個網路的更新說明。
  2. 選用:如要查看更新的屬性,請使用 gcloud vmware networks describe 指令

    gcloud vmware networks describe NETWORK_ID

API

如要使用 VMware Engine API 更新 VMware Engine 網路,請按照下列步驟操作:

  1. 如要更新 VMware Engine 網路的說明,請提出 PATCH 要求:

    PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description"
    
    '{
      "description":"DESCRIPTION"
    }'
    

    更改下列內容:

    • PROJECT_ID:網路所在的專案 ID。
    • LOCATION:網路位置,標準網路為 global,舊版網路為區域。
    • NETWORK_ID:VMware Engine 網路的 ID。
    • DESCRIPTION:這個網路的更新說明。
  2. 選用步驟:如要查看更新的屬性,請發出 GET 要求:

    GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"

後續步驟