llvm-premerge-checks/README.md

# Overview

This repository contains the configuration files for the pre-merge checks for the LLVM project. This github project contains the documentation and the server configuration cluster of build machines that are used to check all incoming commits to the LLVM project.

# User documentation
See [docs/user_doc.md](docs/user_doc.md)

# Cluster overview

The cluster consists of these services:
* Jenkins build server: http://jenkins.llvm-merge-guard.org
* a set of Jenkins agents running the builds
* an nginx server with the build results/logs http://results.llvm-merge-guard.org

![deployment diagram](http://www.plantuml.com/plantuml/proxy?src=https://raw.githubusercontent.com/google/llvm-premerge-checks/master/docs/deployment.plantuml)

# Jenkins-Phabricator integration

The Jenkins-Phabricator is based on the instructions provided with the [Phabricator-Jenkins Plugin](https://github.com/uber/phabricator-jenkins-plugin).

On the Phabricator side these things were configured:
* the Harbormaster [build plan](https://reviews.llvm.org/harbormaster/plan/3/)
* the Herald [rule](https://reviews.llvm.org/H511)
* the [merge_guards_bot user](https://reviews.llvm.org/p/merge_guards_bot/) writing the comments

On the Jenkins side:
* in the Jenkins configuration page as explained in the instrucitons
* in the build [job](http://jenkins.llvm-merge-guard.org/job/Phabricator/)
* The Phabricator pluging is *not* used, as it's not flexible enough. Rather Phabricator just triggers the build via an HTTP request. The `arc patch` operations by scripts. The build feedback is also uploaded by scripts via the [harbormaster.sendmessage](https://secure.phabricator.com/conduit/method/harbormaster.sendmessage/) and [differential.revision.edit](https://secure.phabricator.com/conduit/method/differential.revision.edit/) APIs.

There is no backup of the credentials. If you need to change it, generate a new one and update it in Jenkins and Phabricator.

# Additional Information
* [Playbooks](docs/playbooks.md) for installing/upgrading
* [User documentation](docs/user_doc.md)
* [Log of the service operations](https://github.com/google/llvm-premerge-checks/wiki/LLVM-pre-merge-tests-operations-blog)

# License
This project is licensed unter the "Apache 2.0 with LLVM Exception" license. See [LICENSE](LICENSE) for details.
initial import of configuration files 2019-10-04 10:26:20 +02:00			`# Overview`

improved documentation 2019-10-29 13:56:40 +01:00			`This repository contains the configuration files for the pre-merge checks for the LLVM project. This github project contains the documentation and the server configuration cluster of build machines that are used to check all incoming commits to the LLVM project.`
initial import of configuration files 2019-10-04 10:26:20 +02:00
added link to user documentation 2019-11-04 10:33:41 +01:00			`# User documentation`
Fix playbooks link 2019-12-09 10:46:33 +01:00			`See [docs/user_doc.md](docs/user_doc.md)`
added link to user documentation 2019-11-04 10:33:41 +01:00
initial import of configuration files 2019-10-04 10:26:20 +02:00			`# Cluster overview`
empty deployment of nginx 2019-10-05 08:43:30 +02:00
			`The cluster consists of these services:`
Formatting and typos 2019-10-10 09:27:31 +02:00			`* Jenkins build server: http://jenkins.llvm-merge-guard.org`
empty deployment of nginx 2019-10-05 08:43:30 +02:00			`* a set of Jenkins agents running the builds`
link to results server 2019-10-10 11:01:17 +02:00			`* an nginx server with the build results/logs http://results.llvm-merge-guard.org`
empty deployment of nginx 2019-10-05 08:43:30 +02:00
Update README.md added deployment diagram 2019-10-29 09:42:14 +01:00			`![deployment diagram](http://www.plantuml.com/plantuml/proxy?src=https://raw.githubusercontent.com/google/llvm-premerge-checks/master/docs/deployment.plantuml)`
initial import of configuration files 2019-10-04 10:26:20 +02:00
added instruction on configuring Phabricator 2019-10-07 11:47:58 +02:00			`# Jenkins-Phabricator integration`
Formatting and typos 2019-10-10 09:27:31 +02:00
added instruction on configuring Phabricator 2019-10-07 11:47:58 +02:00			`The Jenkins-Phabricator is based on the instructions provided with the [Phabricator-Jenkins Plugin](https://github.com/uber/phabricator-jenkins-plugin).`

			`On the Phabricator side these things were configured:`
			`* the Harbormaster [build plan](https://reviews.llvm.org/harbormaster/plan/3/)`
			`* the Herald [rule](https://reviews.llvm.org/H511)`
improved documentation on Phabricator integration 2019-10-29 11:11:41 +01:00			`* the [merge_guards_bot user](https://reviews.llvm.org/p/merge_guards_bot/) writing the comments`
added instruction on configuring Phabricator 2019-10-07 11:47:58 +02:00
			`On the Jenkins side:`
			`* in the Jenkins configuration page as explained in the instrucitons`
			`* in the build [job](http://jenkins.llvm-merge-guard.org/job/Phabricator/)`
improved documentation on Phabricator integration 2019-10-29 11:11:41 +01:00			* The Phabricator pluging is not used, as it's not flexible enough. Rather Phabricator just triggers the build via an HTTP request. The `arc patch` operations by scripts. The build feedback is also uploaded by scripts via the [harbormaster.sendmessage](https://secure.phabricator.com/conduit/method/harbormaster.sendmessage/) and [differential.revision.edit](https://secure.phabricator.com/conduit/method/differential.revision.edit/) APIs.
added instruction on configuring Phabricator 2019-10-07 11:47:58 +02:00
			`There is no backup of the credentials. If you need to change it, generate a new one and update it in Jenkins and Phabricator.`
initial import of configuration files 2019-10-04 10:26:20 +02:00
improved documentation 2019-10-29 13:56:40 +01:00			`# Additional Information`
Fix playbooks link 2019-12-09 10:46:33 +01:00			`* [Playbooks](docs/playbooks.md) for installing/upgrading`
improved documentation 2019-10-29 13:56:40 +01:00			`* [User documentation](docs/user_doc.md)`
Update README.md 2020-05-11 09:55:53 +02:00			`* [Log of the service operations](https://github.com/google/llvm-premerge-checks/wiki/LLVM-pre-merge-tests-operations-blog)`
forwarding credentials working on jenkins-staging 2019-10-09 18:29:44 +02:00
added license 2019-10-04 14:31:57 +02:00			`# License`
Formatting and typos 2019-10-10 09:27:31 +02:00			`This project is licensed unter the "Apache 2.0 with LLVM Exception" license. See [LICENSE](LICENSE) for details.`