Commit 7f5f56d4 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Move builds emails service to its own document

[ci skip]
parent 31e0dee3
...@@ -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.
...@@ -186,19 +186,12 @@ GitLab, such as **Commits** and **Merge Requests**. ...@@ -186,19 +186,12 @@ GitLab, such as **Commits** and **Merge Requests**.
## Enabling build emails ## Enabling build emails
If you want to recieve notifications about builds (when build fails, for If you want to receive e-mail notifications about the result status of the
example), you should enable **Build Emails Service**. builds, you should explicitly enable the **Builds Emails** service under your
project's settings.
**Build Emails** service is available on a **Service** page in a project's For more information read the [Builds emails service documentation]
settings. You should activate it by checking an *Active* checkbox, and clicking (../../project_services/builds_emails.md).
"Save changes".
Note that you can also provide a list of recipients that will always recieve
notifications or indicate that you want a pusher to also recieve notification
about each build's status.
If you decide to check *Notify only broken builds* checkbox, notifications will
be sent only for failed builds.
## Builds badge ## Builds badge
......
## 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