Configuring Bamboo to send SMTP Email
Bamboo can send email notifications about its build results. There are two steps to setting this up:
- Configure Bamboo to send SMTP email (see below).
- Configure a plan to send SMTP email notifications about build results (see Configuring notifications for a plan and its jobs).
このページの内容
関連ページ
Configuring Bamboo to send SMTP email
To configure Bamboo to send SMTP email:
- In the upper-right corner of the screen, selectAdministration> Overview.
- Under Communication, select Mail server.
Edit the mail server settings as necessary:
Name
A display name for the email address e.g. SMTP Server.
From address
The email address from which Bamboo notifications will be sent.
Subject prefix
The text (if any) which will be added to the start of the email subject line. For example [Bamboo] will result in emails with subjects like:- [Bamboo] TEST build 1,001 has FAILED (77 tests failed, no failures were new) : Change made by jsmith
- [Bamboo] TEST build 1,002 was SUCCESSFUL (with 77 tests) : Change made by jsmith
Email settings
Select either SMTP or JNDI. See the Notes about JNDI below.
SMTP server
The address of the email server that Bamboo will use to send notifications e.g. mail.myserver.com.
Username
The login name of the account that Bamboo will use to login to the SMTP server.
JNDI Location
Depends on your application server, and on the location of the mail resource within the JNDI tree you specify. E.g. java:comp/env/mail/BambooMailServer.- Enter a test email address in the Test recipient address box.
- Select Test, and verify that a test email is received.
- 保存 を選択します。
Configuring email notifications for Gmail
Gmail.com uses TLS (SSL). A JNDI connector needs to be configured. Unfortunately Bamboo does not yet support JNDI with TLS.
To enable Gmail as your mail server:
- Install Bamboo.
- Make sure that the following files are copied to and exists only in <Bamboo-Install>
/lib:
javax.mail-X.X.X.jar
javax.mail-api-X.X.X.jar
(only if you're using Bamboo 6.0 or later)- If the
javax.mail-X.X.X.jar
andjavax.mail-api-X.X.X.jar
files don't exist in the <Bamboo-Install>/lib
directory, you must move thejavax
files installed at<Bamboo-Install>/atlassian-bamboo/WEB-INF/lib
to <Bamboo-Install>/lib
. If the
javax.mail-X.X.X.jar
andjavax.mail-api-X.X.X.jar
files already exists in the <Bamboo-Install>/lib
directory, simply delete thejavax
files shipped with Bamboo in<Bamboo-Install>/atlassian-bamboo/WEB-INF/lib
.
In Bamboo 5.9 themail-X.X.jar
andactivation-X.X.jar
files were included in the download archive. Starting with Bamboo 5.10:- the
mail-X.X.jar
file has been renamed tojavax.mail-X.X.X.jar
and must be moved to <Bamboo-Install>/lib
- the
activation.jar
file is not required
- the
- If the
Add the following configuration to your BambooInstall/conf/server.xml file:
<Context path="/bamboo" docBase="${catalina.base}/atlassian-bamboo" reloadable="true"> <Resource name="mail/GmailSmtpServer" auth="Container" type="javax.mail.Session" mail.smtp.host="smtp.gmail.com" mail.smtp.port="465" mail.smtp.auth="true" mail.smtp.user="<your-name>@gmail.com" password="<your-pw>" mail.smtp.starttls.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory" /> </Context>
Configure Bamboo to use a JNDI Location of java:comp/env/mail/GmailSmtpServer
. Note that the JNDI Location is case sensitive and must match the resource name specified in server.xml
.
注意
You can use a mail session as an alternative to specifying mail details directly in Bamboo. You configure the mail session in your application server (e.g. in the server.xml file — see Locating important directories and files), and then use JNDI to look up the preconfigured mail session. JNDI has the following advantages:
- Centralized management - mail details are configured in the same place as database details, and may be configured through your application server administration tools.
- Better security - mail details are not available to Bamboo administrators through the Bamboo interface, and aren't stored in Bamboo backup files.
- More SMTP options - e.g. SSL. If you want to use SMTP over SSL you will need to use JNDI.