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

Developer can see a description for a pipeline run

    XMLWordPrintable

Details

    • Blue Ocean 1.1-beta4

    Description

      Example 1

      node {
         sh 'ping -c 5 localhost'
         currentBuild.description = "go to http://www.apple.com/";
      }
      

      Attachments

        Issue Links

          Activity

            jamesdumay James Dumay added a comment -

            nok would it be fine to only display it on the run screen? That would be the screen that looks like the one below

            jamesdumay James Dumay added a comment - nok would it be fine to only display it on the run screen? That would be the screen that looks like the one below
            nok Martin Noack added a comment -

            jamesdumay yes that will help!

            I thinking about to add a column in the activity tab on the job overview screen. But the problem should be that there is already a lot of informations and in addition there is not enough space to display more informations. I understand that is to much on one screen.
            But on the other hand the commit informations like id, author and message are displayed on the job overview screen and in the run screen under the register "changes". That is a duplication. Therefore maybe the column "message" on the job overview screen could be replaced with a description column and the commit message will be displayed as a tooltip when we hover with the mouse over the commit id. Is that an idea ?

            If this not acceptable, i am happy with the description in the run screen

            nok Martin Noack added a comment - jamesdumay yes that will help! I thinking about to add a column in the activity tab on the job overview screen. But the problem should be that there is already a lot of informations and in addition there is not enough space to display more informations. I understand that is to much on one screen. But on the other hand the commit informations like id, author and message are displayed on the job overview screen and in the run screen under the register "changes". That is a duplication. Therefore maybe the column "message" on the job overview screen could be replaced with a description column and the commit message will be displayed as a tooltip when we hover with the mouse over the commit id. Is that an idea ? If this not acceptable, i am happy with the description in the run screen
            jamesdumay James Dumay added a comment -

            nok yes, we could use the message column - we are planning to override it when there are no commits to display the trigger reason/build cause. I like that a lot

            jamesdumay James Dumay added a comment - nok yes, we could use the message column - we are planning to override it when there are no commits to display the trigger reason/build cause. I like that a lot
            nok Martin Noack added a comment -

            jamesdumay oka i see that on you live server (https://ci.blueocean.io/blue/organizations/jenkins/blueocean/activity) and i understand that. So in job run will be okay ...

            nok Martin Noack added a comment - jamesdumay oka i see that on you live server ( https://ci.blueocean.io/blue/organizations/jenkins/blueocean/activity ) and i understand that. So in job run will be okay ...
            nok Martin Noack added a comment -

            ah as i gorgot please support as html <a href='www/${variable}/fixedstuff'>[binaries]</a>" or in markdown syntax. Important is that we can set alternative display text and groovy variables are resolved and placed into the link

            nok Martin Noack added a comment - ah as i gorgot please support as html <a href='www/${variable}/fixedstuff'> [binaries] </a>" or in markdown syntax. Important is that we can set alternative display text and groovy variables are resolved and placed into the link
            jamesdumay James Dumay added a comment -

            OK I think we can do that.

            jamesdumay James Dumay added a comment - OK I think we can do that.

            jamesdumay We are using using a single job to pipeline our infrastructure/code deploys across all of our applications, so we will be looking at the activity page much more often than the run screen. If that information is only accessible on the run screen, we would need to maintain another mapping somewhere else to tie a particular application/environment to a run #.

            jakauppila Jared Kauppila added a comment - jamesdumay We are using using a single job to pipeline our infrastructure/code deploys across all of our applications, so we will be looking at the activity page much more often than the run screen. If that information is only accessible on the run screen, we would need to maintain another mapping somewhere else to tie a particular application/environment to a run #.
            jamesdumay James Dumay added a comment -

            jakauppila thats great context - thank you Would you be disadvantaged if you lost the commit information in the Message column and got your currentBuild.description instead?

            jamesdumay James Dumay added a comment - jakauppila thats great context - thank you Would you be disadvantaged if you lost the commit information in the Message column and got your currentBuild.description instead?

            jamesdumay Nope, that would be perfectly fine. Once we're up and running at scale I don't expect many commits to be coming in, so if we have to click into the run screen to view that information under "changes" is acceptable.

            Will the user be able to define what appears in the Message column? In an above comment, you mention displaying the 'trigger reason/build cause' if there are no commits, but in our case, we would always want to display currentBuild.description regardless.

             

            jakauppila Jared Kauppila added a comment - jamesdumay Nope, that would be perfectly fine. Once we're up and running at scale I don't expect many commits to be coming in, so if we have to click into the run screen to view that information under "changes" is acceptable. Will the user be able to define what appears in the Message column? In an above comment, you mention displaying the 'trigger reason/build cause' if there are no commits, but in our case, we would always want to display currentBuild.description regardless.  
            jamesdumay James Dumay added a comment -

            jakauppila I don't intend on creating any UI for the user to set the message at this time.

            jamesdumay James Dumay added a comment - jakauppila I don't intend on creating any UI for the user to set the message at this time.
            jamesdumay James Dumay added a comment -

            Heres a preview

            jamesdumay James Dumay added a comment - Heres a preview

            Code changed in jenkins
            User: James Dumay
            Path:
            src/test/js/multibranch/commitMessages.js
            http://jenkins-ci.org/commit/blueocean-acceptance-test/391c3ddccd6f79a673472815bd2382f8ac404d03
            Log:
            JENKINS-41769 update xpath for branch commit message

            scm_issue_link SCM/JIRA link daemon added a comment - Code changed in jenkins User: James Dumay Path: src/test/js/multibranch/commitMessages.js http://jenkins-ci.org/commit/blueocean-acceptance-test/391c3ddccd6f79a673472815bd2382f8ac404d03 Log: JENKINS-41769 update xpath for branch commit message

            Code changed in jenkins
            User: James William Dumay
            Path:
            src/test/js/multibranch/commitMessages.js
            http://jenkins-ci.org/commit/blueocean-acceptance-test/c38dbbab50a4ede852a1f07278aeeada7196ceee
            Log:
            JENKINS-41769 update xpath for branch commit message (#140)

            scm_issue_link SCM/JIRA link daemon added a comment - Code changed in jenkins User: James William Dumay Path: src/test/js/multibranch/commitMessages.js http://jenkins-ci.org/commit/blueocean-acceptance-test/c38dbbab50a4ede852a1f07278aeeada7196ceee Log: JENKINS-41769 update xpath for branch commit message (#140)
            jamesdumay James Dumay added a comment -

            Will be released in Blue Ocean 1.1

            jamesdumay James Dumay added a comment - Will be released in Blue Ocean 1.1

            jamesdumay is there a nightly build available somewhere that I could test this out?

            jakauppila Jared Kauppila added a comment - jamesdumay is there a nightly build available somewhere that I could test this out?
            jamesdumay James Dumay added a comment -

            jakauppila you can activate the experimental update center to install the beta releases of Blue Ocean. This change isn't in a released beta but I will follow up today and have someone release.

            jamesdumay James Dumay added a comment - jakauppila you can activate the experimental update center to install the beta releases of Blue Ocean. This change isn't in a released beta but I will follow up today and have someone release.
            jamesdumay James Dumay added a comment -

            jakauppila Blue Ocean 1.1-beta4 has been released to the experimental update center and contains this change if you want to try it out.

            jamesdumay James Dumay added a comment - jakauppila Blue Ocean 1.1-beta4 has been released to the experimental update center and contains this change if you want to try it out.

            jamesdumay Looks good! The only thing I would say is that now that the "Run" content updates from currentBuild.displayName, it's a bit limited as it only displays ~7 characters.

            jakauppila Jared Kauppila added a comment - jamesdumay Looks good! The only thing I would say is that now that the "Run" content updates from currentBuild.displayName, it's a bit limited as it only displays ~7 characters.

            How do I use a Linebreak in the description? I have the Safe HTML Formatter, but neither "\n" not "<br>" trigger a line break.

            kevcodez Kevin Grüneberg added a comment - How do I use a Linebreak in the description? I have the Safe HTML Formatter, but neither "\n" not "<br>" trigger a line break.

            With Safe HTML Formatter I can add links to currentBuild.description and links will be rendered correctly everywhere except Blue Ocean plugin:

            vs

            Are there any plans to support HTML tags in Blue Ocean build description?

            vgaidarji Veaceslav Gaidarji added a comment - With Safe HTML Formatter I can add links to currentBuild.description and links will be rendered correctly everywhere except Blue Ocean plugin: vs Are there any plans to support HTML tags in Blue Ocean build description?

            vgaidarji I opened JENKINS-45181 because I expected the description to support <br> (Safe HTML).

            Quoting jamesdumay 

             

             the design we have only caters for a single line on both the messages column and the pipeline result details header. Allowing arbitrary amounts of formatting and information there would significantly impact the design. Ill be honest, we are unlikely to change that in the next year. However sometime next year we are planning a redesign of those screens so we could consider it then.

             

            I would like to see HTML being supported in the description aswell.

            kevcodez Kevin Grüneberg added a comment - vgaidarji I opened JENKINS-45181 because I expected the description to support <br> (Safe HTML). Quoting jamesdumay      the design we have only caters for a single line on both the messages column and the pipeline result details header. Allowing arbitrary amounts of formatting and information there would significantly impact the design. Ill be honest, we are unlikely to change that in the next year. However sometime next year we are planning a redesign of those screens so we could consider it then.   I would like to see HTML being supported in the description aswell.

            Is there a way to turn this feature off?

             

            quas Jakub Pawlinski added a comment - Is there a way to turn this feature off?  
            jamesdumay James Dumay added a comment -

            Yes by not setting the description for your pipeline

            jamesdumay James Dumay added a comment - Yes by not setting the description for your pipeline

            My pipelines were already using description property before this fix, generating a fancy html table with loads of useful links and such. It works well outside of blue ocean where now I'm getting half of page of html gibberish. 

            quas Jakub Pawlinski added a comment - My pipelines were already using description property before this fix, generating a fancy html table with loads of useful links and such. It works well outside of blue ocean where now I'm getting half of page of html gibberish. 
            jamesdumay James Dumay added a comment -

            quas I understand. Could you open a new ticket with your use case and we can evaluate it from there?

            jamesdumay James Dumay added a comment - quas I understand. Could you open a new ticket with your use case and we can evaluate it from there?
            quas Jakub Pawlinski added a comment - Created  https://issues.jenkins-ci.org/browse/JENKINS-45719

            People

              jamesdumay James Dumay
              nok Martin Noack
              Votes:
              3 Vote for this issue
              Watchers:
              11 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: