Jenkins Pipeline是否可复用CloudFormation模板在AWS部署EC2实例？

阿华AIGC实验室

2026-5-11

回答：Jenkins Pipeline 完全可以复用 CloudFormation 模板完成 AWS EC2 实例部署

当然可以！这其实是云端基础设施即代码（IaC）结合CI/CD流水线的典型实践，刚好能把你之前提到的Jenkins、Ansible甚至Docker整合起来，形成一套完整的从基础设施部署到应用上线的链路。

核心实现思路

Jenkins和CloudFormation的整合主要有两种常用方式，都能轻松复用你现有的CloudFormation模板：

1. 使用 Jenkins AWS 官方插件

Jenkins有官方维护的AWS CloudFormation Plugin，可以直接在Pipeline中调用插件封装好的步骤，执行CloudFormation栈的创建、更新、查询等操作，不用手写复杂的CLI命令，上手更快捷。

示例Pipeline片段：

pipeline {
    agent any
    environment {
        AWS_REGION = 'us-east-1'
        CFN_TEMPLATE_PATH = './templates/ec2-instance-template.yml' // 你的模板路径
        STACK_NAME = 'Production-EC2-Stack'
    }
    stages {
        stage('部署EC2实例（CloudFormation）') {
            steps {
                cloudFormationCreateOrUpdate(
                    stackName: STACK_NAME,
                    region: AWS_REGION,
                    templatePath: CFN_TEMPLATE_PATH,
                    parameters: [
                        InstanceType: 't3.small',
                        KeyName: 'my-aws-key-pair',
                        SubnetId: 'subnet-xxxxxx'
                    ],
                    awsCredentials: 'aws-production-credentials' // Jenkins中预先配置的AWS凭证ID
                )
            }
        }
        // 可选：用Ansible配置刚创建的EC2实例
        stage('配置EC2实例（Ansible）') {
            steps {
                script {
                    // 从CloudFormation栈输出中获取EC2公网IP
                    def stackOutputs = cloudFormationDescribeStacks(stackName: STACK_NAME, region: AWS_REGION)
                    def ec2PublicIp = stackOutputs.find { it.outputKey == 'InstancePublicIp' }.outputValue
                    // 执行Ansible playbook完成初始化配置
                    sh "ansible-playbook -i ${ec2PublicIp}, playbooks/ec2-setup.yml --private-key ~/.ssh/my-aws-key.pem"
                }
            }
        }
        // 可选：部署Docker容器到EC2
        stage('部署Docker应用') {
            steps {
                sh "ssh -i ~/.ssh/my-aws-key.pem ec2-user@${ec2PublicIp} 'docker run -d -p 80:80 my-app-image:latest'"
            }
        }
    }
}

2. 直接调用 AWS CLI（更灵活）

如果不想依赖插件，也可以在Jenkins代理节点上安装AWS CLI，通过sh步骤直接执行CloudFormation命令，这种方式适合需要自定义复杂逻辑的场景：

示例Pipeline片段：

pipeline {
    agent any
    environment {
        AWS_REGION = 'us-east-1'
        CFN_TEMPLATE = 'file://./templates/ec2-instance-template.yml'
        STACK_NAME = 'Staging-EC2-Stack'
    }
    stages {
        stage('AWS身份验证') {
            steps {
                // 用Jenkins中配置的AWS凭证设置环境变量
                withAWS(credentials: 'aws-staging-credentials', region: AWS_REGION) {
                    sh 'aws sts get-caller-identity' // 验证身份有效性
                }
            }
        }
        stage('部署EC2栈') {
            steps {
                withAWS(credentials: 'aws-staging-credentials', region: AWS_REGION) {
                    sh """
                        aws cloudformation deploy \
                            --stack-name ${STACK_NAME} \
                            --template-file ${CFN_TEMPLATE} \
                            --parameter-overrides \
                                InstanceType=t2.micro \
                                KeyName=my-aws-key-pair \
                                SubnetId=subnet-xxxxxx \
                            --capabilities CAPABILITY_IAM
                    """
                }
            }
        }
        // 后续的Ansible配置、Docker部署步骤和上面逻辑一致
    }
}

复用CloudFormation模板的关键技巧

参数化模板：把实例类型、密钥对、子网ID这些可变项做成模板参数，这样Pipeline可以根据测试/生产等不同环境传入不同参数，完全不用修改模板本身。
利用栈输出传递数据：在CloudFormation模板中定义输出项（比如EC2的公网IP、私有IP），这样Pipeline可以直接获取这些值，无缝衔接后续的配置、部署步骤。
版本控制模板：把CloudFormation模板和Jenkins Pipeline脚本一起放到Git仓库管理，方便追溯变更、多环境复用。