如何在Jenkins声明式流水线中给AWS Beanstalk的Jar传命令行参数

你目前已经打通S3包传输、EB环境部署Jar的全链路，要实现启动Jar时传入自定义命令行参数，完全不需要修改Jar包本身的逻辑，核心是借助EB的环境配置机制把参数透传给应用启动流程：AWS EB官方的Java内置运行平台，会自动读取aws:elasticbeanstalk:container:java命名空间下的JVM_ARGS配置项，把对应值直接拼到Jar的启动命令行里，和你手动在EC2服务器上执行java -jar your-app.jar <自定义参数>的效果完全一致。Jenkins声明式流水线里只需要在触发EB部署的步骤中，把自定义参数作为EB部署的配置项传递就可以生效。

1. 使用AWS官方Jenkins EB插件的场景 #

如果你是通过插件提供的awsBeanstalk步骤完成部署，直接在步骤参数中增加optionSettings块传递自定义参数即可，示例代码：

pipeline {
  agent any
  stages {
    stage('Deploy to Elastic Beanstalk') {
      steps {
        // 保留你现有的构建Jar、上传S3、生成EB应用版本的逻辑
        awsBeanstalk deploy: [
          applicationName: '你的EB应用名称',
          environmentName: '你的目标EB环境名称',
          versionLabel: '和你上传S3的Jar包版本一一对应',
          // 核心配置：传递自定义启动参数
          optionSettings: [
            [
              namespace: 'aws:elasticbeanstalk:container:java',
              optionName: 'JVM_ARGS',
              value: '-Dspring.profiles.active=prod --server.port=8081 --log.level=info'
            ]
          ]
        ]
      }
    }
  }
}

2. 使用AWS CLI命令完成EB部署的场景 #

如果你是在流水线的shell步骤中直接执行eb deploy命令完成部署，可以通过--payload参数把自定义启动参数传给EB环境，还可以把参数存在流水线环境变量里方便复用，示例代码：

pipeline {
  agent any
  environment {
    // 动态维护自定义启动参数，不需要硬写在部署命令里
    CUSTOM_JVM_ARGS = '-Dfeature.flag.cache=true --max.worker.thread=150'
  }
  stages {
    stage('Deploy to Elastic Beanstalk via CLI') {
      steps {
        sh '''
          # 保留你现有的eb 初始化、关联目标环境的逻辑
          eb deploy \
            --timeout 15 \
            --cfg prod-deploy \
            --payload '{"OptionSettings":[{"Namespace":"aws:elasticbeanstalk:container:java","OptionName":"JVM_ARGS","Value":"'$CUSTOM_JVM_ARGS'"}]}'
        '''
      }
    }
  }
}

• 不要把自定义启动参数硬编码在Jar包的配置文件里，否则每次调整参数都需要重新打包、重新上传S3、生成新版本，失去EB环境配置的灵活性
• 如果你的EB应用是基于Docker容器运行的，不需要使用JVM_ARGS配置项，只需要在aws:elasticbeanstalk:application:environment命名空间下定义自定义的参数变量（比如APP_RUNTIME_ARGS），再在Docker的启动命令里把这个变量拼到java启动行即可
• 自定义参数如果包含空格、特殊符号，在通过CLI传递时一定要做好转义，避免EB解析时出现参数截断，导致应用启动失败

灵活扩展：你完全可以在Jenkins流水线里根据分支、构建标记动态给JVM_ARGS赋值，比如测试分支传开发环境的参数、主分支传生产环境的参数，不需要写死固定配置。

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