Terraform代码重载文件

2024-05-07 00:12
文章标签 代码 重载 terraform

本文主要是介绍Terraform代码重载文件,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一般来说Terraform会加载模块内所有的.tf.tf.json文件,并要求文件内定义了一组无重复的对象。如果两个文件尝试定义同一个对象,那么Terraform会报错。
在某些少见场景中,能够用单独的文件重载已有对象配置的特定部分将会十分有用。比如说,由工程师编写的配置文件能够在运行时被程序生成的JSON文件部分重载。

为支持这些少见场景,Terrform会对后缀名为override.tfoverride.tf.json的代码文件进行特殊处理,对于名为override.tfoverride.tf.json的代码文件也会进行相同的特殊处理。
Terraform一开始加载代码文件时会跳过这些重载文件,然后才会按照字典序一个一个处理重载文件。对重载文件中定义的所有顶级块(resourcedata等),Terraform会尝试找到对应的已有对象并且将重载内容合并进已有对象。

重载文件只应使用于特殊场景,过度使用会使得读者在阅读原始代码文件时被迫还要阅读所有的重载文件才能理解对象配置,从而降低了代码的可读性。使用重载文件时,请在原始文件被重载的部分添加相应注释,提醒未来的读者哪些部分会被重载文件修改。

示例

如果有一个名为example.tf的代码文件:

resource "aws_instance" "web" {instance_type = "t2.micro"ami           = "ami-408c7f28"
}

然后创建一个名为override.tf的文件:]

resource "aws_instance" "web" {ami = "foo"
}

Terraform随后会合并两者,最终的配置会是这样的:

resource "aws_instance" "web" {instance_type = "t2.micro"ami           = "foo"
}

合并行为

不同的块类型有着些微不同的合并行为,某些特定块内的特殊构造会以特殊形式被合并。

  • 重载文件内的顶级块会和普通文件内同类型同名的顶级块合并
  • 重载文件内的顶级块配置参数覆盖普通文件内对应块内的同名参数
  • 重载块内的内嵌块会取代普通文件内对应块内的所有同类型内嵌块,所有重载块内没有定义的内嵌块在普通文件内保持不变
  • 内嵌块的内容不会进行合并
  • 合并后的块仍然需要符合对应块类型的所有验证规则

如果有多个重载文件定义了同一个顶级块,那么重载效果是叠加的,后加载的重载块会在先前加载的重载块生效的基础上合并,重载操作首先按照文件名的字典序其次是在重载文件中的位置决定执行顺序。
有一些针对特定顶级块类型的特殊合并行为规则,将重载文件中定义的块称为重载块,重载块在普通文件中对应的块称为源块

合并resource块以及合并data块

resource块内,所有lifecycle块的内容会按照参数逐条合并。
比如说,一个重载块只定义了create_before_destroy参数而源块定义了ignore_changes,那么create_before_destroy被合并的同时igonore_changes将会被保留。

如果重载的resource块包含了一个或多个provisioner,那么源块内所有的provisioner会被忽略

如果重载的resource块内包含了一个connection块,那么它将会完全覆盖所有源块内定义的connection块。

不允许在重载块内定义depends_on参数,那将会引发一个错误。

合并variable块

variable块内参数的合并遵循上述的标准流程,但对于typedefault参数的处理会有一些特殊的考虑。
如果源块定义了default值而重载块修改了变量的type,Terraform会尝试将default值转换成新类型,如果转换失败则会报错。
如果源块定义了type参数而重载块修改了default值,那么新的default值必须能够被转换成原先的类型。

合并output块

不允许在重载块内定义depends_on参数,这会引发一个错误。

合并locals块

所有的locals块都定义了一个或多个命名值,针对locals的合并是按照命名值的名字逐条执行的,不论命名值是在哪个locals块内被定义的。

合并terraform块

如果重载块定义了required_providers参数,那么它的值会被逐条合并,这就允许重载块在不影响其他Provider的情况下调整单个Provider的版本约束。

重载块内的required_versionrequired_providers里的配置完全覆盖源块内的相应配置,如果源块和重载块都定义了required_version,那么源块的配置会被完全忽略。

这篇关于Terraform代码重载文件的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/965783

相关文章

Python使用Tenacity一行代码实现自动重试详解

《Python使用Tenacity一行代码实现自动重试详解》tenacity是一个专为Python设计的通用重试库,它的核心理念就是用简单、清晰的方式,为任何可能失败的操作添加重试能力,下面我们就来看... 目录一切始于一个简单的 API 调用Tenacity 入门:一行代码实现优雅重试精细控制:让重试按我

Python实现MQTT通信的示例代码

《Python实现MQTT通信的示例代码》本文主要介绍了Python实现MQTT通信的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一... 目录1. 安装paho-mqtt库‌2. 搭建MQTT代理服务器(Broker)‌‌3. pytho

MySQL进行数据库审计的详细步骤和示例代码

《MySQL进行数据库审计的详细步骤和示例代码》数据库审计通过触发器、内置功能及第三方工具记录和监控数据库活动,确保安全、完整与合规,Java代码实现自动化日志记录,整合分析系统提升监控效率,本文给大... 目录一、数据库审计的基本概念二、使用触发器进行数据库审计1. 创建审计表2. 创建触发器三、Java

Java 方法重载Overload常见误区及注意事项

《Java方法重载Overload常见误区及注意事项》Java方法重载允许同一类中同名方法通过参数类型、数量、顺序差异实现功能扩展,提升代码灵活性,核心条件为参数列表不同,不涉及返回类型、访问修饰符... 目录Java 方法重载(Overload)详解一、方法重载的核心条件二、构成方法重载的具体情况三、不构

Java中调用数据库存储过程的示例代码

《Java中调用数据库存储过程的示例代码》本文介绍Java通过JDBC调用数据库存储过程的方法,涵盖参数类型、执行步骤及数据库差异,需注意异常处理与资源管理,以优化性能并实现复杂业务逻辑,感兴趣的朋友... 目录一、存储过程概述二、Java调用存储过程的基本javascript步骤三、Java调用存储过程示

Visual Studio 2022 编译C++20代码的图文步骤

《VisualStudio2022编译C++20代码的图文步骤》在VisualStudio中启用C++20import功能,需设置语言标准为ISOC++20,开启扫描源查找模块依赖及实验性标... 默认创建Visual Studio桌面控制台项目代码包含C++20的import方法。右键项目的属性:

MySQL数据库的内嵌函数和联合查询实例代码

《MySQL数据库的内嵌函数和联合查询实例代码》联合查询是一种将多个查询结果组合在一起的方法,通常使用UNION、UNIONALL、INTERSECT和EXCEPT关键字,下面:本文主要介绍MyS... 目录一.数据库的内嵌函数1.1聚合函数COUNT([DISTINCT] expr)SUM([DISTIN

Java实现自定义table宽高的示例代码

《Java实现自定义table宽高的示例代码》在桌面应用、管理系统乃至报表工具中,表格(JTable)作为最常用的数据展示组件,不仅承载对数据的增删改查,还需要配合布局与视觉需求,而JavaSwing... 目录一、项目背景详细介绍二、项目需求详细介绍三、相关技术详细介绍四、实现思路详细介绍五、完整实现代码

Go语言代码格式化的技巧分享

《Go语言代码格式化的技巧分享》在Go语言的开发过程中,代码格式化是一个看似细微却至关重要的环节,良好的代码格式化不仅能提升代码的可读性,还能促进团队协作,减少因代码风格差异引发的问题,Go在代码格式... 目录一、Go 语言代码格式化的重要性二、Go 语言代码格式化工具:gofmt 与 go fmt(一)

HTML5实现的移动端购物车自动结算功能示例代码

《HTML5实现的移动端购物车自动结算功能示例代码》本文介绍HTML5实现移动端购物车自动结算,通过WebStorage、事件监听、DOM操作等技术,确保实时更新与数据同步,优化性能及无障碍性,提升用... 目录1. 移动端购物车自动结算概述2. 数据存储与状态保存机制2.1 浏览器端的数据存储方式2.1.