本页内容
- 先决条件
- 克隆主代码
- 使用 Terraform 命令行界面 (CLI) 构建你的第一个基础设施
- 结论
Terraform 是一个用于以代码方式构建和配置基础设施的框架,它带有命令行界面和 DSL 语言。Terraform 能够管理现有及流行的服务提供商,也能管理自定义的内部解决方案,从而构建和配置完整的分布式数据中心。
Terraform 命令行界面 (CLI) 让你无需编写任何代码或配置文件即可使用 Terraform。在编写代码、在你的机器上本地部署配置或将其推送到生产环境之前,它是与团队一起对基础设施变更进行原型设计的理想方式。该 CLI 基于 terraformspec 文件格式构建,该格式是为此目的由 HashiCorp Nomad CLI Toolkit 等第三方创建的。
该 CLI 工具包实现了一个 JavaScript DSL 来定义基础设施,并在 Terraform 和 CLI 中使用相同的配置格式。该 CLI 工具包还提供命令,用于生成基础设施模板、将基础设施组件组合成完整的解决方案,以及管理变更。整个 Terraform 工作流由无状态函数驱动,这些函数在代码中定义,并在你每次做出变更时由 Terraform 执行。这使你可以将基础设施视为一个单一的设计,可以在运行时轻松修改,而无需重新加载配置或修改代码库。
许多 IT 专业人士和公司使用 Terraform 命令行界面来管理和甚至创建新的基础设施或新的云基础设施。terraform 命令行界面可以提供一种更稳健的方法来自动化那些手动执行会耗时过长的变更。它是管理基础设施的强大工具。
很容易理解为什么 Terraform 是世界上最受欢迎的开源云配置解决方案之一。它是像你这样的 Linux 用户所使用的工具!
在文中,你将找到最常用 Terraform CLI 命令的完整解释和示例,这些命令经过特别挑选,旨在让你亲身体验 Terraform 最强大的功能。
先决条件
- 为了跟随本文操作,你应该具备:
- 对 Terraform 的特性和功能有一定的基础知识。
- 一台 Linux 机器。本演示使用 Ubuntu 20.04 LTS,但任何 Linux 发行版都可以使用。
- 机器上已安装 Terraform 和 docker。
克隆主代码
现在你已经准备好了先决条件,可以开始克隆主代码,以便在其上使用 Terraform CLI。
1. 运行下面的 apt install 命令在你的系统上安装 git。Git 是一个开源分布式版本控制系统,旨在快速高效地处理从小型到超大型的各种项目。你将使用 git 从 github.com 克隆 terraform 命令行界面项目模板。然后你将检出适用于本演示的 terraform command line 的正确版本。
sudo apt install git -y

2. 运行下面的 git clone 命令,将 terraform command line 项目模板克隆到你的当前目录。
git clone https://github.com/example-com/terraform-cli.git

3. 进入新克隆的 terraform-cli 目录,用你喜欢的文本编辑器(vim、emacs、nano 等)打开 main.tf 文件。main.tf 文件是你的项目进入 terraform 命令行界面 (Cli) 的入口点。当你运行 terraform 命令时,它会使用 main.tf 文件作为输入,以获取有关如何构建基础设施的指令。
cd terraform-cli && sudo nano main.tf
你将得到以下输出。

- main.tf 文件中的 terraform { } 部分只不过是将 docker provider 设置为 required_provider。为了让 Terraform 管理你的 Docker 基础设施,你必须配置好 docker provider。

- resource "docker_image" "nginx" { 代码块通过创建一个名为 docker_image 的新资源来演示 terraform CLI 的用法。下一行使用 docker-image 创建一个名为 nginx 的资源。你可以推断这将用于管理你的 Docker 容器。下一行将你的 docker 镜像名称设置为 nginx:latest。keep_locally = false 可防止镜像被缓存在你机器的本地,这是防止重复下载的好做法。

- resource "docker_container" "nginx" { 通过创建一个名为 docker_container 的新资源来演示 terraform CLI 的用法。下一行使用 docker_container 创建一个名为 nginx 的资源。这将用于管理你的 Docker 容器的端口映射。下一行将你的 docker 容器名称设置为 tutorial,最后演示如何使用 ports 块将主机上的端口 8000 和端口 80 映射到你的 docker 容器上。

使用 Terraform 命令行界面 (CLI) 构建你的第一个基础设施
现在你已经克隆了 terraform 项目模板,可以构建你的第一个基础设施了。你将使用 Terraform CLI,借助项目的 main.tf 文件来构建基础设施。你将创建一个 docker 容器,并将主机上的一个端口映射到该 docker 容器。
1. 首先,运行 terraform init 命令来初始化你的工作目录。terraform init 命令会初始化你的工作目录,并下载 Terraform 管理基础设施所需的任何必需插件。工作目录是你将使用 terraform 命令来管理基础设施的目录。初始化完成后,该目录包含一个 main.tf 文件,并且可以包含多个辅助文件。
terraform init
成功运行 terraform init 命令后,你将收到以下输出。

2. 接下来,运行 terraform fmt 命令自动格式化你的 main.tf 文件,以提高可读性和一致性。terraform fmt 命令会重新格式化你的 main.tf 文件,以提高可读性和一致性。这是一个值得遵循的良好实践,因为它会让你和其他人更容易阅读你的文件。
terraform fmt
如果 terraform fmt 命令修改了你的 main.tf 文件,它将打印出被重新格式化的文件的名称。在本演示中,输出为空,因为 main.tf 文件已经按照 Terraform 喜欢的格式进行了格式化,如下所示。

3. 运行 terraform validate 命令,以确保你的基础设施将按预期构建。terraform validate 命令是一项安全检查,用于验证你的基础设施能否按预期构建。
terraform validate
如果没有错误,你将收到与下面类似的输出,表明一切就绪,可以构建你的第一个基础设施。

4. 运行 terraform plan 命令,查看 Terraform 将如何构建基础设施。terraform plan 命令是对 Terraform 计划构建内容的预览,与 terraform apply 不同。
terraform plan
terraform plan 命令输出以下结构,表明它将创建一个名为 nginx 的 docker_container 资源实例和一个名为 tutorial 的 docker_image 资源。

5. 运行 terraform apply 命令,以应用你通过 terraform plan 预览过的变更。terraform apply 命令将构建你的基础设施。terraform apply 命令将创建你的 Terraform main.tf 配置文件中描述的所有资源。
此命令将复用 terraform plan 命令中对变量、约束和映射的求值,以生成尽可能高效的计划。在命令行中随 terraform apply 指定的任何附加选项都将在运行 apply 命令时使用。当提示 Enter a Value 时,输入 yes 并按 Enter。
terraform apply

一旦 terraform apply 命令成功,你将看到一条消息,表明你的基础设施已成功构建,如下所示。发生这种情况时,意味着你的基础设施已按预期构建,并且与你的配置文件保持同步。

6. 运行 ls 命令列出工作目录中的所有文件。你将看到一个名为 terraform.tfstate 的新文件,如下所示。创建此名称的文件是为了跟踪对你的基础设施的变更。terraform plan 命令将运行 terraform apply 时要应用的变更存储在一个名为 .tfstate 的中间文件中。状态文件包含 Terraform 所看到的基础设施的完整状态。应用任何配置都需要此文件,并且在进行变更时必须传递它,即使目标位于同一 provider 内也是如此。
ls

7. 构建过程到此结束。运行 terraform destroy 命令销毁你刚刚构建的基础设施。当提示 Enter a Value 时,输入 yes 并按 Enter。terraform destroy 命令将删除本演示创建的所有资源。terraform destroy 命令将删除你的 Terraform main.tf 配置文件中描述的所有资源。资源一旦被销毁,就无法恢复。
你应该移除未使用的资源,以控制某个环境的配置。这并不是为了掩盖故障,而是通过防止废弃资源的堆积来预防故障。
terraform destroy

结论
在本教程中,你学习了如何使用示例中最常见的 Terraform 概念来构建你的第一个基础设施。你学习了如何使用 Terraform CLI 借助项目的 main.tf 文件构建基础设施。该 CLI 可用于 plan、apply 和 destroy 你的基础设施。
你现在已经具备了构建自己基础设施的工具。得益于 Terraform 全面且富有表现力的配置语言,你可以轻松管理种类繁多的资源。
你可以利用新学到的基础设施管理知识——这些知识已应用于 Docker 容器、Kubernetes 和 OpenStack——为你的基础设施即代码实践带来更高的效率和一致性。