我最新最全的文章都在南瓜慢说 www.pkslow.com，欢迎大家来喝茶！

1 简介

最近工作中用到了Terraform，权当学习记录一下，希望能帮助到其它人。

Terraform系列文章如下：

Terraform入门教程，示例展示管理Docker和Kubernetes资源

Terraform插件Provider管理，搜索、定义、下载

Terraform状态State管理，让变更有记录

Terraform模块Module管理，聚合资源的抽取与复用

Terraform常用命令

模块是为了便为管理与复用，就跟函数是一样的。一个模块大概有以下文件：

main.tf：就像是函数入口；
README.md：如函数的声明；
variables.tf：变量说明，就像函数的入参；
outputs.tf：输出，如函数的返回值；
examples：使用示例；

另外，模块也是可以嵌套的，即模块里有子模块，但不建议嵌套太深。

2 创建及使用自定义模块

2.1 创建模块

我们来通过一个简单示例讲解如何自己创建一个模块。这个模块的功能是在Kubernetes上部署一个nginx，就是创建一个Deployment和一个Service。

这个模块共有两个文件，一个是main.tf，用来定义Resource，即Deployment和Service。另一个文件是variables.tf，用来定义这个模块所需要的输入变量。这两个文件都放在当前目录的nginx-kubernetes文件夹下。目录结果如下：

main.tf文件如下：

resource "kubernetes_deployment" "test" {

  metadata {

    name      = var.applicationName

    namespace = var.namespace

  }

  spec {

    replicas = var.replicas

    selector {

      match_labels = {

        app = var.applicationName

      }

    }

    template {

      metadata {

        labels = {

          app = var.applicationName

        }

      }

      spec {

        container {

          image = var.image

          name  = "nginx-container"

          port {

            container_port = 80

          }

        }

      }

    }

  }

}

resource "kubernetes_service" "test" {

  metadata {

    name      = var.applicationName

    namespace = var.namespace

  }

  spec {

    selector = {

      app = var.applicationName

    }

    type = "NodePort"

    port {

      node_port   = var.nodePort

      port        = 80

      target_port = 80

    }

  }

  depends_on = [kubernetes_deployment.test]

}

它就是资源定义，然后把一些变量用var.xxx的形式替换，这样Terraform解析的时候就会找对应的变量进行赋值。

variables.tf文件如下：

variable "namespace" {

    description = "k8s namespace"

}

variable "applicationName" {

    description = "applicationName"

}

variable "image" {

    description = "image"

}

variable "replicas" {

    description = "deployment replicas"

}

variable "nodePort" {

    description = "nodePort"

}

在main.tf文件使用的变量，都在这里有定义。

2.2 使用模块

现在我们已经创建好了模块，接下来要引用它。我们就在当前目录引用即可。代码如下：

provider "kubernetes" {

  config_path = "~/.kube/config"

}

module "pkslow-nginx" {

    source = "./nginx-kubernetes"

    namespace = "pkslow"

    applicationName = "pkslow-nginx"

    image = "nginx:1.19.5"

    replicas = 3

    nodePort = 30301

}

source：模块来源的地址；
namespace：命令空间，模块定义的入参；
applicationName：应用名，模块定义的入参；
image：镜像，模块定义的入参；
replicas： Pod的数目，模块定义的入参；
nodePort：端口，模块定义的入参；

引用模块还是很简单的，跟调用函数差不多，就是告诉别人名字和入参。

3 使用外部模块

模块的source支持多种类型，如本地路径、Terraform官方仓库、GitHub等。

本地路径：

module "pkslow" {

  source = "./pkslow"

}

Terraform仓库：

module "consul" {

  source = "hashicorp/consul/aws"

  version = "0.1.0"

}

GitHub地址：

module "pkslow" {

  source = "github.com/larrydpk/pkslow"

}

如果是用SSH，如下：

module "pkslow" {

  source = "git@github.com:larrydpk/pkslow.git"

}

压缩包：

module "vpc" {

  source = "https://pkslow.com/vpc-module?archive=zip"

}

4 总结

代码请查看：https://github.com/LarryDpk/pkslow-samples

欢迎关注微信公众号<南瓜慢说>，将持续为你更新...

多读书，多分享；多写作，多整理。

巴特西