一、DataSource功能介绍
DataSource是Terraform官方提供的插件功能,各个Provider可以实现自己的DataSource能力,目的是通过DataSource中的定义过滤需要的数据,一是简化模板编写时数据过滤的复杂性,二是各个资源对Data源的引用保持一致,比如想要知道“华北2”下CPU为1核,内存为1G的ECS实例类型是什么,就可以用DataSource,如果想引用这个数据源,就可以这样使用"${data.alicloud_instance_types.1c1g.instance_types.0.id}"。
二、阿里云DataSource的功能增强
阿里云的DataSource在Terraform原生的功能上做了增强:
- 不仅可以作为资源引用过滤使用,还支持导出过滤结果;
- 并且在"plan"时就可以看到文件(原生的功能只能在实"apply"时才可使用,很不方便);
- 更强大的是在过滤ECS实例类型时如果入参没有可选的资源,会提示支持的类型都有哪些;
DataSource目前支持Region、可用区、镜像、ECS实例类型、VPC、keyPair,如果有用户想知道都有哪些镜像ID,就可以通过DataSource执行后查看导出的文件获取数据,即便是不用于Terraform中也可以做为一个小工具使用。源码详见 https://github.com/alibaba/terraform-provider/tree/master/alicloud 中以data_source开头的文件。
三、例子
下面以ECS实例类型为例,深度讲解如何使用:
需求场景:想要创建一台ECS,条件:Region是华北2,CPU为1核,内存1G,想要知道有哪些实例类型可用。
datasource的代码如下:
data "alicloud_instance_types" "1c1g" {
cpu_core_count = 1
memory_size = 1
"output_file" = "instance_type.json" //重点是这句,指明导出的文件名
}
执行“terraform plan”,即可看到输出的文件 instance_type.json的文件,我们查看文件内容如下:
返回字段说明如下:
- 除了入参"cpu_core_count"和"memory_size"外,我们看到还有两个返回参数,一个是family,一个是id,family即是ECS实例类型家族,id即是具体的实例类型。
在创建ECS时可以如下引用
怎么样,是不是很简单?
如果你曾经被阿里云的ECS复杂约束而困扰,如果你不知道去哪里找实例类型、镜像、可用区,如果你输入的实例类型不符合要求,但又不知道怎么写是正确的,快快用起DataSource功能吧。