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

"Installing Jenkins in Docker" section refers to Blue Ocean image instead of the official jenkins/jenkins one

    Details

    • Similar Issues:

      Description

      It is a follow-up to the discussion in IRC. Apparently Jenkins Docker installation guidelines recommend the BlueOcean container instead of the official Jenkins one. See https://jenkins.io/doc/book/installing/#downloading-and-running-jenkins-in-docker

      See the screenshot

      CC Michael Neale

        Attachments

          Issue Links

            Activity

            oleg_nenashev Oleg Nenashev created issue -
            Hide
            rtyler R. Tyler Croy added a comment -

            This is intentional because the Blue Ocean container has Docker CLI commands added which makes the rest of the tutorial work properly.

            Basically, this was an intentional decision

            Show
            rtyler R. Tyler Croy added a comment - This is intentional because the Blue Ocean container has Docker CLI commands added which makes the rest of the tutorial work properly. Basically, this was an intentional decision
            rtyler R. Tyler Croy made changes -
            Field Original Value New Value
            Status To Do [ 10003 ] Done [ 10004 ]
            Resolution Not A Defect [ 7 ]
            gboue Guillaume Boué made changes -
            Assignee Guillaume Boué [ gboue ]
            gboue Guillaume Boué made changes -
            Assignee Guillaume Boué [ gboue ]
            oleg_nenashev Oleg Nenashev made changes -
            Resolution Not A Defect [ 7 ]
            Status Done [ 10004 ] To Do [ 10003 ]
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            R. Tyler Croy In such case the page should have a notice about the official jenkins/jenkins image at least.
            Otherwise it confuses Jenkins users.

            Will modify the page

            Show
            oleg_nenashev Oleg Nenashev added a comment - R. Tyler Croy In such case the page should have a notice about the official jenkins/jenkins image at least. Otherwise it confuses Jenkins users. Will modify the page
            oleg_nenashev Oleg Nenashev made changes -
            Assignee Oleg Nenashev [ oleg_nenashev ]
            education_ever education ever made changes -
            Link This issue is blocked by WEBSITE-507 [ WEBSITE-507 ]
            oleg_nenashev Oleg Nenashev made changes -
            Labels platform-sig
            oleg_nenashev Oleg Nenashev made changes -
            Assignee Oleg Nenashev [ oleg_nenashev ]
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            CC Baptiste Mathus who was also concerned about this issue. And also Mark Waite

            With the discussion about the BO future in https://groups.google.com/forum/#!topic/jenkinsci-dev/zNukeuLK4Og , this issue becomes even a bigger concern IMO

            Show
            oleg_nenashev Oleg Nenashev added a comment - CC Baptiste Mathus who was also concerned about this issue. And also Mark Waite With the discussion about the BO future in https://groups.google.com/forum/#!topic/jenkinsci-dev/zNukeuLK4Og , this issue becomes even a bigger concern IMO
            Hide
            markewaite Mark Waite added a comment - - edited

            I've read the installation tutorial page at https://jenkins.io/doc/book/installing/#downloading-and-running-jenkins-in-docker. I don't find anything in that tutorial which persuades me that it needs to use the blue ocean image instead of the standard image.

            However, the other tutorials (like the maven, node, and python tutorials) all require a docker step in Pipeline. I think that's what R. Tyler Croy meant when he said:

            the Blue Ocean container has Docker CLI commands added which makes the rest of the tutorial work properly.

            Show
            markewaite Mark Waite added a comment - - edited I've read the installation tutorial page at https://jenkins.io/doc/book/installing/#downloading-and-running-jenkins-in-docker . I don't find anything in that tutorial which persuades me that it needs to use the blue ocean image instead of the standard image. However, the other tutorials (like the maven , node , and python tutorials) all require a docker step in Pipeline. I think that's what R. Tyler Croy meant when he said: the Blue Ocean container has Docker CLI commands added which makes the rest of the tutorial work properly.
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            Mark Waite second sentence in the tutorial is "The recommended Docker image to use is the jenkinsci/blueocean image (from the Docker Hub repository).". Looks like persuasion imho

            Show
            oleg_nenashev Oleg Nenashev added a comment - Mark Waite second sentence in the tutorial is "The recommended Docker image to use is the  jenkinsci/blueocean  image  (from the  Docker Hub repository ).". Looks like persuasion imho
            Hide
            markewaite Mark Waite added a comment -

            I agree it is persuasion. I'm fine if we want to change the "Installing" page to recommend the jenkins/jenkins docker image. The three tutorials already give instructions to use the blueocean image for the tutorials.

            We likely also need to provide additional instructions for other types of installations (helm chart, etc.). I assume that's a future task while changing the recommended default is a more immediate task.

            Show
            markewaite Mark Waite added a comment - I agree it is persuasion. I'm fine if we want to change the "Installing" page to recommend the jenkins/jenkins docker image. The three tutorials already give instructions to use the blueocean image for the tutorials. We likely also need to provide additional instructions for other types of installations (helm chart, etc.). I assume that's a future task while changing the recommended default is a more immediate task.
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            It is fine to have both images in guidelines, but then we should start from jenkins/jenkins and then provide some pros/cons comparison

            Show
            oleg_nenashev Oleg Nenashev added a comment - It is fine to have both images in guidelines, but then we should start from jenkins/jenkins and then provide some pros/cons comparison
            batmat Baptiste Mathus made changes -
            Labels platform-sig java11 platform-sig
            batmat Baptiste Mathus made changes -
            Epic Link JENKINS-51805 [ 191255 ]
            batmat Baptiste Mathus made changes -
            Labels java11 platform-sig java11 platform-sig triaged
            Hide
            jglick Jesse Glick added a comment -

            Having a dedicated image for Blue Ocean does not make sense for users. Might be useful for demos, but that is it. We should guide users to either

            • Run jenkins/jenkins as is and use the Setup Wizard to install recommend plugins.
            • Produce a derivative image with declarative plugin configuration somehow aligned with S.W. recommendations.
            • Run Evergreen.
            Show
            jglick Jesse Glick added a comment - Having a dedicated image for Blue Ocean does not make sense for users. Might be useful for demos, but that is it. We should guide users to either Run jenkins/jenkins as is and use the Setup Wizard to install recommend plugins. Produce a derivative image with declarative plugin configuration somehow aligned with S.W. recommendations. Run Evergreen.
            jglick Jesse Glick made changes -
            Link This issue relates to JENKINS-55101 [ JENKINS-55101 ]
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            I would be in favor of a good BlueOcean image as a helpful bundle, but there is a serious UX issue in the current image: JENKINS-52069. jenkinci/blueocean is that plugins.txt is NOT compatible with the installation wizard. So it causes a really messy UX for thos who does not use Configuration-as-code. And there is no much sense to use the image with Configuration-as-code, because it can be easily defined in plugins.txt: https://github.com/oleg-nenashev/jenkins-blueocean-experimental/blob/java11/plugins.txt

            So I am in favor of deprecating the image if there is no plan to invest into improving it. And there is a dev list thread which suggests that there is no immediate plans for that: https://groups.google.com/forum/#!msg/jenkinsci-dev/zNukeuLK4Og/KP3mfQ2ZFAAJ

             

             

            Show
            oleg_nenashev Oleg Nenashev added a comment - I would be in favor of a good BlueOcean image as a helpful bundle, but there is a serious UX issue in the current image: JENKINS-52069 . jenkinci/blueocean is that plugins.txt is NOT compatible with the installation wizard. So it causes a really messy UX for thos who does not use Configuration-as-code. And there is no much sense to use the image with Configuration-as-code, because it can be easily defined in plugins.txt: https://github.com/oleg-nenashev/jenkins-blueocean-experimental/blob/java11/plugins.txt So I am in favor of deprecating the image if there is no plan to invest into improving it. And there is a dev list thread which suggests that there is no immediate plans for that:  https://groups.google.com/forum/#!msg/jenkinsci-dev/zNukeuLK4Og/KP3mfQ2ZFAAJ    
            oleg_nenashev Oleg Nenashev made changes -
            Link This issue relates to JENKINS-52069 [ JENKINS-52069 ]
            batmat Baptiste Mathus made changes -
            Summary "Installing Jenkins in Docker" section refers BlueOcean image instead of the official jenkins/jenkins one "Installing Jenkins in Docker" section refers to Blue Ocean image instead of the official jenkins/jenkins one
            alecharp Adrien Lecharpentier made changes -
            Assignee Adrien Lecharpentier [ alecharp ]
            alecharp Adrien Lecharpentier made changes -
            Status To Do [ 10003 ] In Progress [ 3 ]
            alecharp Adrien Lecharpentier made changes -
            Status In Progress [ 3 ] In Review [ 10005 ]
            Hide
            alecharp Adrien Lecharpentier added a comment -
            Show
            alecharp Adrien Lecharpentier added a comment - I filled https://github.com/jenkins-infra/jenkins.io/pull/2148  to track this.
            alecharp Adrien Lecharpentier made changes -
            Remote Link Cette demande est liée à "jenkins.io#PR-2148 (Lien Web)" [ 22445 ]
            zbynek Zbynek Konecny made changes -
            Status In Review [ 10005 ] In Progress [ 3 ]
            Hide
            zbynek Zbynek Konecny added a comment -

            Adrien Lecharpentier given the comments in the PR I assume this needs changes before it can be reviewed again (hence the status change in review->in progress).

            Show
            zbynek Zbynek Konecny added a comment - Adrien Lecharpentier given the comments in the PR I assume this needs changes before it can be reviewed again (hence the status change in review->in progress).
            markewaite Mark Waite made changes -
            Status In Progress [ 3 ] To Do [ 10003 ]
            oleg_nenashev Oleg Nenashev made changes -
            Epic Link JENKINS-51805 [ 191255 ] JENKINS-40689 [ 177392 ]
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            Would be great to get it over the line

            Show
            oleg_nenashev Oleg Nenashev added a comment - Would be great to get it over the line
            Hide
            oleg_nenashev Oleg Nenashev added a comment -
            Show
            oleg_nenashev Oleg Nenashev added a comment - New issue in GitHub:  https://github.com/jenkins-infra/jenkins.io/issues/3315
            oleg_nenashev Oleg Nenashev made changes -
            Remote Link This issue links to "https://github.com/jenkins-infra/jenkins.io/issues/3315 (Web Link)" [ 24931 ]
            oleg_nenashev Oleg Nenashev made changes -
            Assignee Adrien Lecharpentier [ alecharp ]
            oleg_nenashev Oleg Nenashev made changes -
            Labels java11 platform-sig triaged blueocean java11 platform-sig triaged ux
            oleg_nenashev Oleg Nenashev made changes -
            Labels blueocean java11 platform-sig triaged ux blueocean help-wanted java11 platform-sig triaged ux
            vsilverman Vlad Silverman made changes -
            Assignee Vlad Silverman [ vsilverman ]

              People

              • Assignee:
                vsilverman Vlad Silverman
                Reporter:
                oleg_nenashev Oleg Nenashev
              • Votes:
                1 Vote for this issue
                Watchers:
                6 Start watching this issue

                Dates

                • Created:
                  Updated: