Jenkins执行Terraform plan无响应，EC2实例运行缓慢求助

核心问题原因 #

• 实例资源不足：t2.micro仅1GB内存，Jenkins运行本身就会占用不少资源，加上Terraform执行plan时需要与AWS API交互、处理状态数据，很容易耗尽内存触发系统内存交换（swap），导致实例性能急剧下降，进程陷入无响应。
• 环境变量配置错误：Jenkinsfile里的PATH = "{$path}:${getTerraformPath()}"存在语法问题，{$path}应该是$PATH（大写且无花括号），异常的PATH配置可能导致Terraform执行时依赖加载异常，间接引发卡顿。
• 权限配置隐患：虽然terraform init成功，但如果AWS权限不全（比如缺少EC2资源的描述权限），Terraform可能会反复重试API请求，持续占用资源拖慢实例。

具体解决方案 #

1. 升级EC2实例规格或添加Swap分区

• 优先把Jenkins实例从t2.micro升级到t2.small/t3.small（2GB内存），足够支撑Jenkins+Terraform的基础运行需求。
• 临时缓解方案：给t2.micro添加2GB Swap分区，缓解内存不足问题：

  # 在Jenkins实例上执行以下命令
  sudo fallocate -l 2G /swapfile
  sudo chmod 600 /swapfile
  sudo mkswap /swapfile
  sudo swapon /swapfile
  # 设置开机自动挂载Swap
  echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  

2. 修正Jenkinsfile的环境变量错误

把PATH配置改为正确的写法：

pipeline {
  agent any
  environment {
    PATH = "$PATH:${getTerraformPath()}"
  }
  stages{
    // ... 后续阶段代码保留
  }
}

3. 完善AWS权限配置

• 给Jenkins所在EC2实例附加IAM角色，确保拥有Terraform执行所需权限，至少包含：
  • ec2:DescribeInstances、ec2:DescribeImages（plan阶段需要）
  • ec2:RunInstances、ec2:CreateTags（apply阶段需要）
• 避免在Jenkins里硬编码Access Key，使用实例角色更安全且无需手动维护密钥。

4. 优化Terraform流水线流程

把init、plan、apply拆分为独立阶段，同时给plan添加输出文件，减少重复计算：

pipeline {
  agent any
  environment {
    PATH = "$PATH:${getTerraformPath()}"
  }
  stages{
    stage('Terraform Init') {
      steps {
        sh 'terraform init'
      }
    }
    stage('Terraform Plan') {
      steps {
        sh 'terraform plan -out=tfplan'
      }
    }
    stage('Terraform Apply') {
      steps {
        sh 'terraform apply -auto-approve tfplan'
      }
    }
  }
}

5. 监控实例资源状态

• 在AWS CloudWatch中开启实例的CPU、内存、磁盘IO监控，确认是否是资源耗尽导致的卡顿。
• 在实例上安装htop工具，实时查看进程资源占用情况：

  # Debian/Ubuntu系统
  sudo apt update && sudo apt install htop
  # RHEL/CentOS系统
  sudo yum install htop
  

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