Uploaded image for project: 'Jenkins Website'
  1. Jenkins Website
  2. WEBSITE-724

Improve the documentation about the detached plugins mechanism and its implications

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: To Do (View Workflow)
    • Priority: Major
    • Resolution: Unresolved
    • Component/s: content
    • Labels:
      None
    • Similar Issues:

      Description

      There is some confusion about how the detached plugins reinstallation works.

      For example in JENKINS-54018 and others.

      It would be great to improve the documentation to avoid people having to dip into Jiras, PRs and so on.

      The document (blog page, document page) should clarify:

      • What the detached plugin means
      • Under what circumstances these plugins are reinstalled or not (UI, cli, scripts (docker/install-plugins.sh, ...)
      • What kind of failures you can see if you have a plugin depending on a non-installed detached plugin.

      It would also be great to identify all possible ways of installing a plugin (within the Oficial Jenkins repos: clis, scripts, makefiles, docker images, ...) and document or write in their console output how the script handles the detached plugins to avoid confusions.

      The documentation adding a link to the list of detached plugins would be great as well:

      https://github.com/jenkinsci/jenkins/blob/a78312ea0f4ba28f8bc81220c6d7c0dfa72a6df/core/src/main/resources/jenkins/split-plugins.txt

       

        Attachments

          Issue Links

            Activity

            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            AFAICT https://github.com/jenkinsci/jenkins/pull/4000 fixes the behavior for Detached plugins. I will try to find relevant tickets and maybe to group them into the EPIC

            CC Jesse Glick

            Show
            oleg_nenashev Oleg Nenashev added a comment - AFAICT  https://github.com/jenkinsci/jenkins/pull/4000  fixes the behavior for Detached plugins. I will try to find relevant tickets and maybe to group them into the EPIC CC Jesse Glick

              People

              Assignee:
              Unassigned Unassigned
              Reporter:
              mramonleon Ramon Leon
              Votes:
              1 Vote for this issue
              Watchers:
              6 Start watching this issue

                Dates

                Created:
                Updated: