Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-27177

There should be a command line mechanism to disable plugins

    • Icon: New Feature New Feature
    • Resolution: Fixed
    • Icon: Major Major
    • core
    • None
    • (towards) 2.151

      The typical system administrator, to urgently recover from a problem, will need to use local system commands to disable plugins indicated a problem in the Jenkins logs.

      The first step is to include a "README" in the install and/or plugin directories. This readme file may be as simple as to link to the Jenkins online documentation describing the file structure and configurations.

      Secondly, there should be clear documentation on the "manual" backup/restore/disabling plugins and their configurations.

      Lastly, if it is not currently possible to disable a plugin via the command line and/or config update a process should be added to Jenkins to do so.

      See thread https://groups.google.com/d/msgid/jenkinsci-users/CAO49JtFuG9t_F4zL%3D7ncg53XdZG9dZD-GdWQ1dtTN53DrKjm8g%40mail.gmail.com

          [JENKINS-27177] There should be a command line mechanism to disable plugins

          Jason Pyeron added a comment -

          Jason Pyeron added a comment - related: https://wiki.jenkins-ci.org/display/JENKINS/Removing+and+disabling+plugins

          Daniel Beck added a comment - - edited

          There is no explanation or justification for any of the requests in this issue.

          The typical system administrator, to urgently recover from a problem, will need to use local system commands to disable plugins indicated a problem in the Jenkins logs.

          touch $JENKINS_HOME/plugins/$PLUGIN_NAME.jpi.disabled

          The first step is to include a "README" in the install and/or plugin directories. This readme file may be as simple as to link to the Jenkins online documentation describing the file structure and configurations.

          Not sure what's needed here, but please note that the Jenkins folder structure is mostly considered to be opaque to users and messing with it without knowing really well what you're doing will generally not work (such as the issues users who bypass the plugin manager and use chef to manage plugin while ignoring dependencies experience). Adding this README would elevate messing with Jenkins home to a "supported" use, which it is not.

          Secondly, there should be clear documentation on the "manual" backup/restore/disabling plugins and their configurations.

          There is, linked in your comment.

          Lastly, if it is not currently possible to disable a plugin via the command line and/or config update a process should be added to Jenkins to do so.

          (Correction: The UI broke as it's the auth plugin – JENKINS-27175 – but it's documented on the wiki, and easy enough to understand how $JENKINS_HOME/plugins works.)

          Daniel Beck added a comment - - edited There is no explanation or justification for any of the requests in this issue. The typical system administrator, to urgently recover from a problem, will need to use local system commands to disable plugins indicated a problem in the Jenkins logs. touch $JENKINS_HOME/plugins/$PLUGIN_NAME.jpi.disabled The first step is to include a "README" in the install and/or plugin directories. This readme file may be as simple as to link to the Jenkins online documentation describing the file structure and configurations. Not sure what's needed here, but please note that the Jenkins folder structure is mostly considered to be opaque to users and messing with it without knowing really well what you're doing will generally not work (such as the issues users who bypass the plugin manager and use chef to manage plugin while ignoring dependencies experience). Adding this README would elevate messing with Jenkins home to a "supported" use, which it is not. Secondly, there should be clear documentation on the "manual" backup/restore/disabling plugins and their configurations. There is, linked in your comment. Lastly, if it is not currently possible to disable a plugin via the command line and/or config update a process should be added to Jenkins to do so. (Correction: The UI broke as it's the auth plugin – JENKINS-27175 – but it's documented on the wiki, and easy enough to understand how $JENKINS_HOME/plugins works.)

          Jason Pyeron added a comment -

          Justification:

          It is a best practice to have documentation for a server on the server. Take for example systems and networks without internet access. Even if there was internet access, the sysadmin would expect the docs to be with the program, for THAT version.

          What is needed:

          docs installed with Jenkins.

          What is not needed:

          "support" for mucking with jenkins file system.

          Jason Pyeron added a comment - Justification: It is a best practice to have documentation for a server on the server. Take for example systems and networks without internet access. Even if there was internet access, the sysadmin would expect the docs to be with the program, for THAT version. What is needed: docs installed with Jenkins. What is not needed: "support" for mucking with jenkins file system.

          Ramon Leon added a comment -

          Ramon Leon added a comment - PR:  https://github.com/jenkinsci/jenkins/pull/3648

            mramonleon Ramon Leon
            jpyeron Jason Pyeron
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: