Ubuntu EC2实例中用Ansible跳过Jenkins初始化向导失败求助

问题根源 #

本地主机配置生效但EC2实例无效，核心原因是新版Ubuntu上的Jenkins默认用systemd管理服务，传统的/etc/default/jenkins配置文件已不再生效；另外如果Jenkins曾启动过并生成了初始化状态文件，后续修改JVM参数也不会触发跳过向导。

可行解决方案 #

方案1：修改systemd配置文件（推荐） #

针对systemd管理的Jenkins，直接修改其service配置文件添加跳过向导的JVM参数：

- name: 安装Jenkins包
  apt:
    name: jenkins
    state: present
    update_cache: true
  become: true

- name: 在systemd配置中添加跳过初始化向导的JVM参数
  lineinfile:
    path: /lib/systemd/system/jenkins.service
    regexp: '^Environment="JAVA_OPTS='
    line: 'Environment="JAVA_OPTS=-Djava.awt.headless=true -Djenkins.install.runSetupWizard=false"'
    backrefs: true
  become: true

- name: 重载systemd daemon使配置生效
  systemd:
    daemon_reload: true
  become: true

- name: 启动并开机自启Jenkins
  service:
    name: jenkins
    state: started
    enabled: true
  become: true

- name: 等待Jenkins完全启动
  uri:
    url: http://{{ HostName }}:8080
    status_code: 200
    timeout: 5
  register: jenkins_service_status
  retries: 60
  delay: 5
  until: >
    'status' in jenkins_service_status and
    jenkins_service_status['status'] == 200

方案2：手动创建初始化完成标记文件 #

如果修改JVM参数仍不生效，可以直接创建Jenkins用来标记初始化完成的文件，强制跳过向导：

- name: 先停止Jenkins服务
  service:
    name: jenkins
    state: stopped
  become: true

- name: 创建Jenkins初始化完成标记文件
  file:
    path: /var/lib/jenkins/jenkins.install.InstallUtil.lastExecVersion
    state: touch
    owner: jenkins
    group: jenkins
    mode: '0644'
  become: true

- name: 启动并开机自启Jenkins
  service:
    name: jenkins
    state: started
    enabled: true
  become: true

- name: 等待Jenkins启动完成
  uri:
    url: http://{{ HostName }}:8080
    status_code: 200
    timeout: 5
  register: jenkins_service_status
  retries: 60
  delay: 5
  until: >
    'status' in jenkins_service_status and
    jenkins_service_status['status'] == 200

关键注意事项 #

• 如果EC2实例上Jenkins已经启动过，需要先停止服务，删除/var/lib/jenkins下的初始化状态文件（如jenkins.install.UpgradeWizard.state），再执行上述配置。
• 所有任务必须以root权限执行（确保become: true生效）。
• 验证参数是否生效：登录EC2实例执行ps aux | grep jenkins，查看进程命令行是否包含-Djenkins.install.runSetupWizard=false。

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