Commit 2cc9a42c authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Merge branch 'doc/add-build-email-service' into 'master'

Add documentation about build emails service

Closes #12497

See merge request !2871
parents de84fa36 7f5f56d4
...@@ -36,13 +36,13 @@ file and start builds on _Runners_ according to the contents of the file, ...@@ -36,13 +36,13 @@ file and start builds on _Runners_ according to the contents of the file,
for that commit. for that commit.
Because `.gitlab-ci.yml` is in the repository, it is version controlled, Because `.gitlab-ci.yml` is in the repository, it is version controlled,
old versions still build succesfully, forks can easily make use of CI, old versions still build successfully, forks can easily make use of CI,
branches can have separate builds and you have a single source of truth for CI. branches can have separate builds and you have a single source of truth for CI.
You can read more about the reasons why we are using `.gitlab-ci.yml` You can read more about the reasons why we are using `.gitlab-ci.yml`
[in our blog about it][blog-ci]. [in our blog about it][blog-ci].
**Note:** `.gitlab-ci.yml` is a [YAML](https://en.wikipedia.org/wiki/YAML) file **Note:** `.gitlab-ci.yml` is a [YAML](https://en.wikipedia.org/wiki/YAML) file
so you have to pay extra attention to the identation. Always use spaces, not so you have to pay extra attention to the indentation. Always use spaces, not
tabs. tabs.
### Creating a simple `.gitlab-ci.yml` file ### Creating a simple `.gitlab-ci.yml` file
...@@ -168,7 +168,7 @@ To enable **Shared Runners** you have to go to your project's ...@@ -168,7 +168,7 @@ To enable **Shared Runners** you have to go to your project's
## Seeing the status of your build ## Seeing the status of your build
After configuring the Runner succesfully, you should see the status of your After configuring the Runner successfully, you should see the status of your
last commit change from _pending_ to either _running_, _success_ or _failed_. last commit change from _pending_ to either _running_, _success_ or _failed_.
You can view all builds, by going to the **Builds** page in your project. You can view all builds, by going to the **Builds** page in your project.
...@@ -184,6 +184,15 @@ you expected. ...@@ -184,6 +184,15 @@ you expected.
You are also able to view the status of any commit in the various pages in You are also able to view the status of any commit in the various pages in
GitLab, such as **Commits** and **Merge Requests**. GitLab, such as **Commits** and **Merge Requests**.
## Enabling build emails
If you want to receive e-mail notifications about the result status of the
builds, you should explicitly enable the **Builds Emails** service under your
project's settings.
For more information read the [Builds emails service documentation]
(../../project_services/builds_emails.md).
## Builds badge ## Builds badge
You can access a builds badge image using following link: You can access a builds badge image using following link:
......
## Enabling build emails
To receive e-mail notifications about the result status of your builds, visit
your project's **Settings > Services > Builds emails** and activate the service.
In the _Recipients_ area, provide a list of e-mails separated by comma.
Check the _Add pusher_ checkbox if you want the committer to also receive
e-mail notifications about each build's status.
If you enable the _Notify only broken builds_ option, e-mail notifications will
be sent only for failed builds.
---
![Builds emails service settings](img/builds_emails_service.png)
...@@ -12,7 +12,7 @@ further configuration instructions and details. Contributions are welcome. ...@@ -12,7 +12,7 @@ further configuration instructions and details. Contributions are welcome.
| Assembla | Project Management Software (Source Commits Endpoint) | | Assembla | Project Management Software (Source Commits Endpoint) |
| [Atlassian Bamboo CI](bamboo.md) | A continuous integration and build server | | [Atlassian Bamboo CI](bamboo.md) | A continuous integration and build server |
| Buildkite | Continuous integration and deployments | | Buildkite | Continuous integration and deployments |
| Builds emails | Email the builds status to a list of recipients | | [Builds emails](builds_emails.md) | Email the builds status to a list of recipients |
| Campfire | Simple web-based real-time group chat | | Campfire | Simple web-based real-time group chat |
| Custom Issue Tracker | Custom issue tracker | | Custom Issue Tracker | Custom issue tracker |
| Drone CI | Continuous Integration platform built on Docker, written in Go | | Drone CI | Continuous Integration platform built on Docker, written in Go |
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment