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

            mramonleon Ramon Leon created issue -
            mramonleon Ramon Leon made changes -
            Field Original Value New Value
            Link This issue is caused by JENKINS-54018 [ JENKINS-54018 ]
            oleg_nenashev Oleg Nenashev made changes -
            Link This issue is related to JENKINS-57528 [ JENKINS-57528 ]
            markewaite Mark Waite made changes -
            Component/s content [ 20860 ]
            Component/s jenkins.io [ 23954 ]
            Key INFRA-2063 WEBSITE-724
            Workflow classic default workflow [ 235835 ] WEBSITE: Software Development Workflow [ 241895 ]
            Project Infrastructure [ 10301 ] Jenkins Website [ 10401 ]
            Status Open [ 1 ] To Do [ 10003 ]

              People

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

                Dates

                Created:
                Updated: