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)
|
@ -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"—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 > Manage Plugins > 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>
|
||||
|
|
Before Width: | Height: | Size: 73 KiB After Width: | Height: | Size: 60 KiB |
Before Width: | Height: | Size: 65 KiB After Width: | Height: | Size: 44 KiB |
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 38 KiB |
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 45 KiB |
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 18 KiB |
Before Width: | Height: | Size: 38 KiB After Width: | Height: | Size: 32 KiB |
Before Width: | Height: | Size: 45 KiB After Width: | Height: | Size: 23 KiB |
Before Width: | Height: | Size: 18 KiB |
Before Width: | Height: | Size: 30 KiB |
Before Width: | Height: | Size: 21 KiB |