如何将Jenkins字符串参数转为Terraform Map变量？解决无效数字字面量错误

问题根源 #

你遇到的错误核心有两点：

1. Jenkins命令中传递的变量名vms和Terraform定义的vm_map不匹配，导致Terraform无法正确识别变量。
2. 直接传递单个IP字符串不符合Terraform Map类型的语法要求，Terraform尝试解析时会因格式错误抛出“无效数字字面量”。

解决方案：增量修改Map（推荐） #

这种方式无需覆盖整个默认Map，仅传递需要修改的键值对，更灵活。

步骤1：修改Terraform配置

在variables.tf中新增一个用于接收更新的变量，再通过merge函数合并默认值和传入的修改：

# 原有的默认Map变量
variable "vm_map" {
  type = map(object({
    name = string
    ip   = string
  }))
  default = {
    "first" = {
      name = "ubuntu-jenkins1"
      ip   = "172.30.100.160"
    }
    "second" = {
      name = "ubuntu-jenkins2"
      ip   = "172.30.100.161"
    }
    "third" = {
      name = "ubuntu-jenkins3"
      ip   = "172.30.100.162"
    }
  }
}

# 新增用于接收更新的变量，默认空Map
variable "vm_updates" {
  type = map(object({
    name = string
    ip   = string
  }))
  default = {}
}

# 在main.tf中定义最终使用的Map
locals {
  final_vm_map = merge(var.vm_map, var.vm_updates)
}

之后在Terraform资源中使用local.final_vm_map替代原var.vm_map即可。

步骤2：修改Jenkinsfile传递参数

调整terraform apply的命令，正确传递符合Map语法的参数：

pipeline {
    agent any

    parameters {
        string(name: 'IP1', defaultValue: '', description: 'Enter first IP address')
    }
    
    stages {
        stage('Git Checkout') {
            steps {
                git branch: 'branch1', credentialsId: '', url: 'http://<redacted>.git'
            }
        }
        stage('Deploy Terraform') {
            steps {
                script {
                    dir('Linux') {
                        // 处理空参数情况，避免传递无效值
                        def updateVar = params.IP1 ? "-var 'vm_updates={first={ip=\"${params.IP1}\"}}'" : ""
                        sh """
                            terraform init
                            terraform plan ${updateVar}
                            terraform apply ${updateVar} --auto-approve
                        """
                    }
                } 
            }
        }
    }
}

备选方案：直接传递完整Map #

如果需要完全替换默认Map，可直接传递完整的Map结构（注意语法正确性）：

sh """
terraform apply -var 'vm_map={
    "first" = {name="ubuntu-jenkins1", ip="${params.IP1}"},
    "second" = {name="ubuntu-jenkins2", ip="172.30.100.161"},
    "third" = {name="ubuntu-jenkins3", ip="172.30.100.162"}
}' --auto-approve
"""

这种方式需要完整写出所有键值对，适合需要批量修改的场景，但灵活性较差。

关键注意事项 #

• Terraform的-var参数值必须严格符合HCL语法，Map和嵌套Object的括号、引号不能缺失。
• Jenkins中使用双引号包裹shell命令时，要注意转义内部的双引号（用\"），避免参数被截断。

内容的提问来源于stack exchange，提问作者Mark Matlock