Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-03-10

1 Теги: сервер, проект, проектная работа, программирование на javascript, ci/cd сервер, node.js

2 Важнейшая часть образовательного процесса в OTUS - практическое применение знаний, полученных на занятиях. Именно поэтому последний модуль большинства курсов посвящён выполнению проектной работы. Предлагаем вашему вниманию работу одного из выпускников курса "<a>Разработчик JavaScript</a>" -Дмитрия Переверзы.

3 Дмитрий создал сервис, предназначенныйдля автоматизации сборки и развёртывания проектовна рабочих площадках. При неудачных сборках проекта происходит автоматический сброс изменений до последнего коммита удачной сборки.

4 <h2>Настройка и регистрация</h2>

5 Сервер необходимо расположить на сервере с https, иначе не удастся настроить github webhook. Для запуска работы сервиса используем следующую команду:

6 После запуска сервиса можно регистрировать проекты, используя API сервиса.

7 Метод Роут Описание GET project Получение конфигурационного файла POST project/register Регистрация нового проекта POST project/update Обновление полей проектаПример запроса на регистрацию проекта:

8 { "project": "testProject", "git": "https://github.com/username/project.git", "notificationEmails": [ "test@gmail.com" ], "privateParam": { "prodPass": "bxw5s222rGEU", "userName": "root" } }<ol><li>project - код вашего проекта.</li>

9 <li>git - ссылка на git-репозиторий вашего проекта.</li>

10 <li>notificationEmails - массив email-адресов для оповещения о процессе сборки ваших проектов.</li>

11 <li>privateParam - приватные параметры для подстановки в локальный конфиг вашего проекта.</li>

12 </ol><h3>Пример запроса на обновление полей проекта</h3>

13 Попробуем поменять приватный параметр prodPass и userName:

14 { "project": "testProject", "updatedParams": { "privateParam": { "prodPass": "bxwsr5544433GEU", "userName": "www-data" } } }Обратите внимание, что каждое поле, переданное в updatedParams, полностью заменяет собой существующее значение.

15 Пример запроса на получение актуального конфига проекта:

16 https://someurl.com/project?project=testProject<h2>Настройка проекта для работы с CI/CD сервисом</h2>

17 В корне подключаемого проекта необходимо создать файлproject.conf.jsonв следующем формате:

18 { "name": "Тестовый проект", "code": "testProject", "targets": [ { "branch": "master", "deploy": { "ssh": { "host": "194.87.91.254", "pass": "#prodPass#", "port": 22, "username": "#userName#", "cwd": "/var/www/html" }, "command": "npm run production" }, "testCommand": "npm run test" } ] }Обо всех полях по порядку: 1. name - название вашего проекта. 2. code - код проекта (его указываем для получение конфига в /project). 3. targets - здесь указываем массив целевых веток для сборки (за ними и будет следить сервис).

19 Поля для targets: 1. branch - ветка проекта, изменения которой нужно отслеживать. 2. deploy - данные для подключения к удалённому серверу, на котором будет происходить деплой. Вdeploy.sshпомимо обычных данных подключения можно указать приватные параметры. Указывая параметр в формате #paramName#, мы скрываем данные подключение из публичного доступа. Для установки значений этих параметров воспользуйтесть полемprivateParamпри регистрации проекта в системе. 3. deploy.command - команда для запуска cборки и деплоя проекта. 4. testCommand - команда для запуска тестов на проекте (опционально).

20 Данный конфиг нужно занести под git.

21 <h2>Настройка webhook на github.com</h2>

22 На странице настроек репозитория указываем url адрес CI/CD сервера на роут /webhook:

23 При выполнении всех условий настроек проекта при обновлении нужной ветки вашего репозиториявы получите инструмент автоматической сборки ваших проектов.

24 Ознакомиться с подробностями проекта и его исходным кодом вы можете<a>по ссылке на репозиторий</a>Дмитрия Переверзы. Чтобы попасть в следующую группу курса "<a>Разработчик JavaScript</a>", пройдите<a>вступительное тестирование</a>.