使用 Terraform 部署虛擬私有雲
您可以使用 Infrastructure Manager 和Google Cloud 控制台,部署虛擬私有雲 (VPC) 網路。本快速入門導覽課程適用於雲端管理員、平台工程師和開發人員,協助他們以 Google Cloud 基礎架構即程式碼的形式管理基礎架構。虛擬私有雲網路可為虛擬機器 (VM) 執行個體、資料庫和應用程式等資源提供隔離的網路。
有了 Infra Manager,您可以在 Terraform 設定中定義網路,不必手動建立。Infra Manager 會為您執行 Terraform,並儲存 Terraform 狀態。因此,您可以一致地重現、更新及刪除基礎架構。詳情請參閱「 Google Cloud上的 Terraform 總覽」。
在本快速入門導覽課程中,您將預覽並建立公開 GitHub 存放區中 Terraform 設定的部署作業。
事前準備
-
登入 Google 帳戶。
如果還沒有帳戶,請註冊新帳戶。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
必要的角色
如要取得完成本快速入門導覽課程所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
- Cloud Infrastructure Manager 管理員 (
roles/config.admin) - 服務帳戶管理員 (
roles/iam.serviceAccountAdmin) - 服務帳戶使用者 (
roles/iam.serviceAccountUser) - 專案 IAM 管理員 (
roles/resourcemanager.projectIamAdmin) - Compute 網路檢視者 (
roles/compute.networkViewer) - Cloud Build 檢視者 (
roles/cloudbuild.builds.viewer) - Storage 物件檢視者 (
roles/storage.objectViewer)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
預覽及建立部署作業
建立部署作業時,Infra Manager 會佈建 Terraform 設定中定義的資源。建立部署作業前,請先建立預覽畫面,確認 Infra Manager 預計佈建的資源。
如要預覽並建立佈建虛擬私有雲網路的部署作業,請按照下列步驟操作:
前往 Google Cloud 控制台的「Infrastructure Manager」頁面。
按一下「建立新部署作業」。
在「Create new Terraform deployment」(建立新的 Terraform 部署作業) 頁面的「Deployment details」(部署作業詳細資料) 部分,輸入下列值:
- Deployment ID:
quickstart-preview - Region (區域):
us-central1 - Terraform 版本:
1.5.7 服務帳戶:建立名為
im-quickstart-sa的新服務帳戶。如要建立服務帳戶並授予必要角色,請按照下列步驟操作:- 在「Service account」(服務帳戶) 清單中,按一下「New service account」(新增服務帳戶)。「建立服務帳戶」頁面會在新分頁中開啟。
- 在「Service account name」(服務帳戶名稱) 欄位中輸入
im-quickstart-sa,然後按一下「Create and continue」(建立並繼續)。 在「將專案存取權授予這個服務帳戶」部分,使用「選取角色」清單授予下列角色。如要新增第二個角色,請按一下 「Add another role」(新增其他角色)。
- 雲端基礎架構 Infrastructure Manager 代理程式 (
roles/config.agent):可讓 Infra Manager 執行 Terraform,並儲存部署作業的狀態和記錄。 - Compute 網路管理員 (
roles/compute.networkAdmin):允許 Infra Manager 建立及管理虛擬私有雲網路。
如要進一步瞭解 Infra Manager 角色,請參閱「使用 IAM 控管存取權」。
- 雲端基礎架構 Infrastructure Manager 代理程式 (
依序點選「繼續」和「完成」。
關閉分頁,返回「Create new Terraform deployment」(建立新的 Terraform 部署作業) 頁面。
在「Service account」(服務帳戶) 清單中,按一下 「Refresh list」(重新整理清單),然後 選取「
im-quickstart-sa」。
Terraform 設定來源:Git
Git 存放區:
https://github.com/terraform-google-modules/terraform-google-networkGit 目錄:
modules/vpc
- Deployment ID:
按一下「繼續」。
在「Terraform details」(Terraform 詳細資料) 區段的「Input values」(輸入值) 下方,為預先填入的模組變數輸入下列值:
- 在
project_id鍵的資料列中,於「Value」(值) 欄位輸入<var>PROJECT_ID</var>。請勿加入引號。 - 在
network_name鍵的資料列中,於「Value」(值) 欄位輸入quickstart-vpc。請勿加入引號。
將 PROJECT_ID 替換為 Google Cloud 專案 ID。
- 在
按一下「Create preview」。
在
quickstart-preview-<var>UUID</var>預覽的詳細資料頁面中,確認「State」(狀態) 列中的值為「Succeeded」(成功)。如要使用預覽畫面中的值建立部署作業,請按一下「Create deployment」(建立部署作業)。
在「Deployment ID」(部署作業 ID) 欄位中,輸入
quickstart-deployment。點選「建立部署作業」。
Infra Manager 會佈建虛擬私有雲網路。部署作業完成後,您會在 Google Cloud 控制台收到通知。
您已使用 Infra Manager 建立部署作業。在下列各節中,您將驗證部署作業、查看佈建的網路,以及查看執行 Terraform 的 Cloud Build 工作。
查看部署作業狀態
Infra Manager 建立部署作業後,您可以查看相關詳細資料,例如狀態、最新修訂版本,以及 Terraform 設定的來源。
如要查看部署作業的詳細資料,請按照下列步驟操作:
前往 Google Cloud 控制台的「Infrastructure Manager」頁面。
在「ID」欄中,按一下「
quickstart-deployment」。在部署作業詳細資料頁面中,確認「State」(狀態) 列的值為「Active」(運作中)。
查看已佈建的虛擬私有雲網路
如要確認 Infra Manager 已佈建 Terraform 設定定義的網路,請在 Google Cloud 控制台查看網路:
前往 Google Cloud 控制台的「VPC Networks」(虛擬私有雲網路) 頁面。
網路清單包含
quickstart-vpc,這是 Infra Manager 佈建的網路。清單會顯示網路的詳細資料,例如子網路建立模式、最大傳輸單位 (MTU) 和動態轉送模式。如要查看網路的詳細資料,例如子網路、防火牆規則 和路徑,請按一下「
quickstart-vpc」。
在 Cloud Build 查看建構結果
Infra Manager 會使用 Cloud Build,為每個部署版本執行 Terraform。如要檢查建立部署作業的 Terraform 指令,或排解部署作業失敗的問題,請查看 Cloud Build 建構記錄:
在 Google Cloud 控制台中,前往「Build history」(建構記錄) 頁面。
在建構作業表格中,找出區域為
us-central1的最新建構作業。quickstart-preview-<var>UUID</var>預先發布版和quickstart-deployment部署作業的建構作業都會顯示在這個清單中。按一下建構 ID,開啟「Build details」(建構作業詳細資料) 頁面。
「Build details」(建構作業詳細資料) 頁面會顯示各個建構步驟的狀態和建構記錄,包括 Terraform 指令的輸出內容。如果部署失敗,請使用建構記錄找出原因。詳情請參閱「排解部署作業錯誤」。
您也可以在 Infra Manager 的部署作業詳細資料頁面中,按一下「Cloud Build logs」(Cloud Build 記錄) 連結,開啟部署作業的建構作業。
清除所用資源
如要避免系統向您的 Google Cloud 帳戶收取這個快速入門導覽課程所用資源的費用,請在不再需要時刪除部署作業。部署作業預先發布版不會向您的 Google Cloud 帳戶收取費用。如要刪除預覽,請參閱「刪除預覽」。
刪除部署作業
刪除部署作業和佈建的虛擬私有雲網路:
如要刪除部署作業,請按照下列步驟操作:
前往 Google Cloud 控制台的「Infrastructure Manager」頁面。
在「ID」欄中,按一下「
quickstart-deployment」。在部署作業詳細資料頁面中,按一下 「Delete」(刪除)。
在確認對話方塊中輸入
quickstart-deployment,然後按一下「Confirm」(確認)。
刪除服務帳戶
Infra Manager 刪除部署作業後,請刪除 im-quickstart-sa 服務帳戶,以免該帳戶保留專案中的角色:
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。
勾選
im-quickstart-sa的核取方塊,然後按一下 「Delete」(刪除)。在對話方塊中,按一下「刪除」。
(選用) 刪除專案
如果您是在新的 Google Cloud 專案中建立部署作業,且不再需要該專案,請刪除專案。
前往 Google Cloud 控制台的「Manage resources」(管理資源) 頁面。
在專案清單中選取要刪除的專案,然後點選「Delete」(刪除)。
在對話方塊中輸入專案 ID,然後按一下「Shut down」(關閉)。
後續步驟
- 瞭解 Infra Manager 的運作方式。
- 進一步瞭解 Terraform 和 Infra Manager。
- 更新部署作業。
- 自動部署。
- 如需可與 Google Cloud搭配使用的一組設定和模組,請參閱 Google Cloud Terraform 說明文件中的「Terraform blueprints and modules for Google Cloud 」( 的 Terraform 藍圖和模組)。