micro-build-server/README.md

micro-build-server
==================


Разработка
==========

Установить Node.js v6.

Запустить `npm install` из папки `BuildServer`.

Создать `app.ts` на основе `app.ts.example`.

Для проверки code style / типов использовать `npm test`.

Установка на сервере
====================

Установить Node.js v6.

Скопировать на сервер собранный проект (содержимое папки `bin\Release`) `DotNetBuilder`.

Установить в GAC сборки `Newtonsoft.Json, Version=6.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed` (можно взять из релиза 6.0.4 с NuGet), `Microsoft.VisualStudio.Setup.Configuration.Interop, PublicKeyToken=b03f5f7f11d50a3a`.

Склонировать репозиторий (`git clone`).

Запустить `npm install` из папки `BuildServer`.

Создать `app.ts` на основе `app.ts.example` (для использования в IIS надо указать `port: process.env["PORT"]`).
Пути `gitpath`, `releasepath`, `tmpcodepath` должны быть максимально короткими.

Проверить, что `app.ts` правильный с помощью `npm test`.

Собрать с помощью `npm build` или `npm run build`.

Запускать с помощью `npm start` или `node app`.
Для использования в IIS - установить iisnode, создать в iis сайт, указывающий на корневую папку `BuildServer` (в которой лежит `Web.config`).

Возможно, в зависимости от сценариев использования, также понадобится установить на сервер Microsoft .NET Targeting Pack и Windows SDK нужной версии.

Обновление сервера
==================

```
git pull origin master
npm test
npm run build
```

Использование
=============

В настройках нужного репозитория (и его форков) указать адрес хука: `https://micro-build-server/github/postreceive`.

Добавить в корневую папку репозитория файл `mbs.pos` с содержимым следующего вида:

```
{
	"type": "sequential",
	"params": {
		"tasks": [
			{
				"type": "dotnetbuild",
				"params": {
					"solution": "Legacy.Processing.Common.sln",
					"forceCodeAnalysis": "true"
				}
			},
			{
				"type": "dotnetnugetprocess",
				"params": {
					"masterRepoOwner": "Legacy",
					"nuspecName": "Legacy.Processing.Common",
					"major": "4"
				}
			}
		]
	}
}
```

Со списком возможных типов задач и их параметров можно ознакомиться в папке `BuildServer\lib\tasks`.

Для добавления новой задачи достаточно добавить новый файл `yourtaskname.ts` в эту папку.

Для получения информации о статусе сборки достаточно добавить в README.md нужного репозитория строчку

```
![Status](https://micro.build.server/status.svg)
```

Или вручную перейти на страницу с отчётом о сборке - для этого надо поменять в адресной строке адрес `https://github.enterprise/what/ever` на `https://micro.build.server/github.enterprise/what/ever`.

В обоих случаях будет отображена информация о сборке нужной ветки / нужного коммита.