Update Jenkins integration instructions.

Now that our plugin is in the Jenkins marketplace thing,
we don't need to have the user laboriously download it
from us and upload it themselves.

(imported from commit 25e9926f7f2314db8f3ea6c00c40514b6fd546c3)
This commit is contained in:
Waseem Daher 2013-04-04 18:15:31 -04:00
parent 807b6396e0
commit 062e106400
11 changed files with 28 additions and 45 deletions

View File

@ -178,76 +178,59 @@ following, to the stream <code>commits</code> with a subject that matches the re
<div id="jenkins" class="integration">
<h4>Jenkins (or Hudson)</h4>
<p>Download
the <a href="https://humbughq.com/dist/integrations/jenkins/humbug-jenkins-0.1.1.hpi">Humbug
Jenkins plugin</a>. To install the plugin, select "Manage
Jenkins", "Manage Plugins", and then "Advanced". Under the
section labeled "Upload Plugin",
select <code>humbug-jenkins-0.1.1.hpi</code> from your computer,
and upload it:</p>
<p>Install the "Humbug" plugin by going to <code>Manage Jenkins
> Manage Plugins > Available</code>, typing in "Humbug", and
clicking "Install without restart".</p>
<img src="/static/images/integrations/jenkins/001.png">
<hr />
<p>Once the plugin is installed, configure it by going
to <code>Manage Jenkins > Configure System</code>.</p>
<img src="/static/images/integrations/jenkins/002.png">
<hr />
<img src="/static/images/integrations/jenkins/003.png">
<hr />
<img src="/static/images/integrations/jenkins/004.png">
<p>After uploading the plugin, restart Jenkins for the
installation to take effect. Some versions of Jenkins have a
link to restart on the "Install" tab of the "Manage Plugins"
page. If your version does not, and you have access to a shell
on the computer running Jenkins, <code>service jenkins
restart</code> will restart it on a Linux system.</p>
<p>Once Jenkins has restarted, it's time to configure our
plugin. Go to "Manage Jenkins" and then to "Configure
System".</p>
<img src="/static/images/integrations/jenkins/005.png">
<p>Scroll to the section labeled "Humbug Notification
Settings", and specify your bot's email address, API key, and
where you'd like your notification messages to go (we recommend,
e.g. stream <code>jenkins</code>).</p>
<p>Scroll to the section labeled "Humbug Notification Settings",
and specify your bot's email address, API key, and where you'd
like your notification messages to go (we recommend the
stream <code>jenkins</code>).</p>
<p>The other two options you might want to adjust are "Smart
Notification" (do you want a message after every single build,
or only after a status change?), and "Jenkins URL" -- the URL to
or only after a status change?), and "Jenkins URL"&mdash;the URL to
your instance of Jenkins, so that we can link you to specific
build reports.</p>
<img src="/static/images/integrations/jenkins/006.png">
<p>(If you don't see the Humbug option in the list, confirm that
the plugin was successfully installed by going to "Manage
Jenkins", "Manage Plugins", "Installed", and confirming that
"Jenkins Humbug Plugin" appears in the list. If it does not, the
plugin was not successfully installed. Make sure that you have
the <a href="https://wiki.jenkins-ci.org/display/JENKINS/Maven+2+Project+Plugin">Maven
plugin</a> installed and try again, or
email <a href="mailto:support@humbughq.com">support@humbughq.com</a>
for help.)</p>
<img src="/static/images/integrations/jenkins/003.png">
<p>Once you've done that, it's time to configure one of your
projects to use the Humbug notification plugin. From your
project page, click "Configure" on the left sidebar:</p>
<img src="/static/images/integrations/jenkins/007.png">
<img src="/static/images/integrations/jenkins/004.png">
<p>Then, scroll to the bottom until you find the section labeled
"Post-build Actions". Click the dropdown and select "Humbug
Notification". It should look as below. Then click "Save".</p>
<img src="/static/images/integrations/jenkins/008.png">
<img src="/static/images/integrations/jenkins/005.png">
<p><b>Congratulations! You're done!</b><br /> When your builds
fail or succeed, you'll see a commit message like the following
with a subject that matches the project name (in this case
"Humbug Test"):</p>
<img class="screenshot" src="/static/images/integrations/jenkins/009.png">
<img class="screenshot" src="/static/images/integrations/jenkins/010.png">
<img class="screenshot" src="/static/images/integrations/jenkins/006.png">
<img class="screenshot" src="/static/images/integrations/jenkins/007.png">
<p><b>Troubleshooting</b></p>
<p>If you don't see the Humbug option in the list, confirm that
the plugin was successfully installed by going to <code>Manage
Jenkins &gt; Manage Plugins &gt; Installed</code> and confirming that
"Humbug Plugin" appears in the list. If it does not, the
plugin was not successfully installed. Make sure that you have
the <a href="https://wiki.jenkins-ci.org/display/JENKINS/Maven+2+Project+Plugin">Maven
plugin</a> installed and try again, or
email <a href="mailto:support@humbughq.com">support@humbughq.com</a>
for help.</p>
<p>
<a href="#services">^ Back to top</a>

Binary file not shown.

Before

Width:  |  Height:  |  Size: 73 KiB

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 65 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB