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

There should be a command line mechanism to disable plugins

    XMLWordPrintable

    Details

    • Type: New Feature
    • Status: Closed (View Workflow)
    • Priority: Major
    • Resolution: Fixed
    • Component/s: core
    • Labels:
      None
    • Similar Issues:
    • Released As:
      (towards) 2.151

      Description

      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

        Attachments

          Issue Links

            Activity

            Show
            jpyeron Jason Pyeron added a comment - related: https://wiki.jenkins-ci.org/display/JENKINS/Removing+and+disabling+plugins
            Hide
            danielbeck 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.)

            Show
            danielbeck 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.)
            Hide
            jpyeron 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.

            Show
            jpyeron 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.
            Show
            mramonleon Ramon Leon added a comment - PR:  https://github.com/jenkinsci/jenkins/pull/3648

              People

              • Assignee:
                mramonleon Ramon Leon
                Reporter:
                jpyeron Jason Pyeron
              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: