创建可复用模块
学习编写自己的 Terraform 模块,定义输入、输出和资源,以构建模块化且灵活的配置。
创建可复用模块 是 CoddyKit 上的免费 DevOps Bootcamp 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 DevOps Bootcamp 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。
构建您自己的 Terraform 模块
在上一课中,我们学习了如何使用现有的 Terraform 模块。现在,让我们深入了解如何创建您自己的可复用模块!
编写模块有助于封装常见的基础设施模式,使配置更加整洁、一致且易于维护。
组织模块文件
Terraform 模块本质上是存放在专用目录中的一组 .tf 文件。
最简单的模块目录将包含:
variables.tf:定义模块的输入变量。main.tf:包含实际的资源声明。outputs.tf:定义模块的输出值。
您还可以加入 versions.tf 以声明提供商要求,并加入 README.md 作为文档。
模块输入:变量
为了使模块更加灵活,您需要定义输入变量。模块用户可以通过这些变量定制模块行为,而无需修改模块的核心代码。
变量通过 variable 块定义,其中需要指定 description、type,还可以选择指定 default 值。
示例:定义模块变量
以下示例展示了如何在模块的 variables.tf 文件中定义实例类型变量:
# variables.tf
variable "instance_type" {
description = "The EC2 instance type to use."
type = string
default = "t2.micro"
}模块资源:核心逻辑
模块的核心在于其资源声明。这些声明对应模块将要创建的实际云资源。
您需要将这些资源块(例如 AWS EC2 实例或 S3 存储桶)放入模块的 main.tf 文件中。
需要特别注意的是,模块中的资源通常会使用您定义的输入变量。
使用输入声明资源
让我们在 main.tf 中使用 instance_type 变量声明一个 EC2 实例:
# main.tf
resource "aws_instance" "web_server" {
ami = "ami-0abcdef1234567890" # Example AMI ID
instance_type = var.instance_type
tags = {
Name = "MyWebServer"
}
}模块输出:共享信息
模块可以接收输入,也可以提供输出值。输出值适合用于导出模块所创建资源的信息。
例如,您可能希望输出 EC2 实例的公共 IP 地址或 S3 存储桶的 ARN。
输出值使用 output 块在 outputs.tf 中定义。
定义模块输出值
下面介绍如何在 outputs.tf 中为 EC2 实例的公共 IP 定义输出值:
# outputs.tf
output "instance_public_ip" {
description = "The public IP address of the EC2 instance."
value = aws_instance.web_server.public_ip
}调用新模块
定义模块后,您可以像使用其他模块一样,在根配置(或另一个模块)中使用它。
您需要指定 source(模块目录的路径),并向其输入变量传入值。
# root_config/main.tf
module "my_web_server_module" {
source = "../my-ec2-module" # Path to your module
instance_type = "t3.small" # Override default
}
output "web_server_ip" {
value = module.my_web_server_module.instance_public_ip
}模块组件检查
您已经了解了 Terraform 模块中的关键文件。哪个文件主要用于定义可以传入模块的值?
回顾:构建可复用模块
做得很好!现在您已经知道如何编写自己的 Terraform 模块了。
- 模块是包含
.tf文件的目录。 - 使用
variables.tf定义输入。 - 将资源定义放在
main.tf中。 - 在
outputs.tf中定义输出,以公开数据。
这项技能对于构建可扩展、易维护且一致的基础设施即代码至关重要。
常见问题解答
「创建可复用模块」课时是免费的吗?
是的 — 「创建可复用模块」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 DevOps Bootcamp 课程的其余内容,请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。
「创建可复用模块」这节课中我会学到什么?
学习编写自己的 Terraform 模块,定义输入、输出和资源,以构建模块化且灵活的配置。 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 DevOps Bootcamp 需要有经验吗?
无需任何先前经验。CoddyKit 上的 DevOps Bootcamp 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。
「创建可复用模块」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 DevOps Bootcamp 课中编写并运行代码吗?
能。每节 DevOps Bootcamp 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。