使用 Terraform 部署 VPC
您可以使用 Infrastructure Manager 和Google Cloud 控制台部署虚拟私有云 (VPC) 网络。本快速入门适用于希望将 Google Cloud 基础设施作为代码进行管理的云管理员、平台工程师和开发者。VPC 网络为虚拟机 (VM) 实例、数据库和应用等资源提供隔离的网络。
借助 Infra Manager,您可以在 Terraform 配置中定义网络,而无需手动创建。Infra Manager 会为您运行 Terraform 并存储 Terraform 状态。因此,您可以一致地重现、更新和删除基础架构。如需了解详情,请参阅 Terraform on Google Cloud概览。
在本快速入门中,您将预览并根据公共 GitHub 代码库中的 Terraform 配置创建部署。
准备工作
-
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 Admin (
roles/config.admin) - Service Account Admin (
roles/iam.serviceAccountAdmin) - Service Account User (
roles/iam.serviceAccountUser) - Project IAM Admin (
roles/resourcemanager.projectIamAdmin) - Compute Network Viewer (
roles/compute.networkViewer) - Cloud Build Viewer (
roles/cloudbuild.builds.viewer) - Storage Object Viewer (
roles/storage.objectViewer)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
预览并创建部署
创建部署时,Infra Manager 会预配 Terraform 配置中定义的资源。在创建部署之前,您需要先创建一个预览,以验证 Infra Manager 计划预配哪些资源。
如需预览和创建预配 VPC 网络的部署,请执行以下操作:
在 Google Cloud 控制台中,前往 Infrastructure Manager 页面。
点击创建新部署。
在创建新的 Terraform 部署页面的部署详情部分中,输入以下值:
- 部署 ID:
quickstart-preview - 区域:
us-central1 - Terraform 版本:
1.5.7 服务账号:创建一个名为
im-quickstart-sa的新服务账号。如需创建服务账号并为其授予所需角色,请执行以下操作:- 在服务账号列表中,点击创建服务账号。系统会在新标签页中打开创建服务账号页面。
- 在服务账号名称字段中,输入
im-quickstart-sa,然后点击创建并继续。 在向此服务账号授予对项目的访问权限部分,使用选择角色列表授予以下角色。如需添加第二个角色,请点击 添加其他角色。
- Cloud Infrastructure Manager Agent (
roles/config.agent):让 Infra Manager 能够运行 Terraform 并存储部署的状态和日志。 - Compute Network Admin (
roles/compute.networkAdmin):允许 Infra Manager 创建和管理 VPC 网络。
如需详细了解 Infra Manager 角色,请参阅使用 IAM 进行访问权限控制。
- Cloud Infrastructure Manager Agent (
点击继续,然后点击完成。
关闭该标签页,然后返回到创建新的 Terraform 部署页面。
在服务账号列表中,点击 刷新列表,然后选择
im-quickstart-sa。
Terraform 配置的来源:Git
Git 代码库:
https://github.com/terraform-google-modules/terraform-google-networkGit 目录:
modules/vpc
- 部署 ID:
点击继续。
在 Terraform 详细信息部分的输入值下,为预先填充的模块变量输入以下值:
- 在
project_id键对应的行中,在值字段中输入<var>PROJECT_ID</var>。请勿添加引号。 - 在
network_name键对应的行中,在值字段中输入quickstart-vpc。请勿包含引号。
请将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。
- 在
点击创建预览。
在
quickstart-preview-<var>UUID</var>预览版的详情页面上,验证状态行中的值是否为成功。如需使用预览中的值创建部署,请点击创建部署。
在部署 ID 字段中,输入
quickstart-deployment。点击创建部署。
Infra Manager 预配 VPC 网络。部署完成后,您会在 Google Cloud 控制台中收到通知。
您已使用 Infra Manager 创建了部署。在以下部分中,您将验证部署、查看预配的网络,并查看运行 Terraform 的 Cloud Build 作业。
查看部署状态
Infra Manager 创建部署后,您可以查看其详细信息,例如其状态、最新修订版本以及其 Terraform 配置的来源。
如需查看部署的详细信息,请执行以下操作:
在 Google Cloud 控制台中,前往 Infrastructure Manager 页面。
在 ID 列中,点击
quickstart-deployment。在部署详情页面上,验证状态行中的值是否为活跃。
查看预配的 VPC 网络
如需确认 Infra Manager 已预配 Terraform 配置定义的网络,请在 Google Cloud 控制台中查看该网络:
在 Google Cloud 控制台中,前往 VPC 网络页面。
网络列表包括
quickstart-vpc,这是 Infra Manager 预配的网络。该列表会显示有关网络的详细信息,例如其子网创建模式、最大传输单元 (MTU) 及其动态路由模式。如需查看有关网络的更多详细信息(例如其子网、防火墙规则和路由),请点击
quickstart-vpc。
在 Cloud Build 中查看构建结果
Infra Manager 使用 Cloud Build 为每个部署修订版本运行 Terraform。如需检查创建部署的 Terraform 命令,或排查失败的部署,请查看 Cloud Build 构建日志:
在 Google Cloud 控制台中,前往构建历史记录页面。
在 build 表中,找到区域为
us-central1的最新 build。quickstart-preview-<var>UUID</var>预览和quickstart-deployment部署的 build 都会显示在此列表中。点击构建 ID 以打开构建详情页面。
构建详情页面会显示每个构建步骤的状态和构建日志,其中包括 Terraform 命令的输出。如果部署失败,请使用构建日志来确定原因。如需了解详情,请参阅排查部署错误。
您还可以通过点击 Cloud Build 日志链接,从 Infra Manager 中的部署详情页面打开部署的 build。
清理
为避免因本快速入门中使用的资源导致您的 Google Cloud 账号产生费用,请在不再需要部署时将其删除。 部署预览不会向您的 Google Cloud 账号收取费用。如果您想删除预览,请参阅删除预览。
删除部署
删除部署和预配的 VPC 网络:
如需删除部署,请执行以下操作:
在 Google Cloud 控制台中,前往 Infrastructure Manager 页面。
在 ID 列中,点击
quickstart-deployment。在部署详情页面上,点击 删除。
在确认对话框中,输入
quickstart-deployment,然后点击确认。
删除服务账号
Infra Manager 删除部署后,请删除 im-quickstart-sa 服务账号,使其不会在项目中保留其角色:
在 Google Cloud 控制台中,打开服务账号页面。
选中
im-quickstart-sa对应的复选框,然后点击 删除。在该对话框中,点击删除。
可选:删除项目
如果您在新 Google Cloud 项目中创建了部署,但不再需要该项目,请将其删除。
在 Google Cloud 控制台中,前往管理资源页面。
在项目列表中,选择要删除的项目,然后点击删除。
在对话框中,输入项目 ID,然后点击关停。
后续步骤
- 了解 Infra Manager 的运作方式。
- 详细了解 Terraform 和 Infra Manager。
- 更新部署。
- 实现部署自动化。
- 如需查看可与Google Cloud搭配使用的一组配置和模块,请参阅 Google Cloud 上的 Terraform 文档中的适用于 Google Cloud的 Terraform 蓝图和模块。