Задачу автоматического деплоймента можно решить множеством способов - уже существует большой набор компонентов и готовых решений для этих целей. К примеру можно использовать Octopus Deploy или TeamCity. Такой выбор оправдан для средних и больших проектов, но достаточно монстроидный для мелких проектов.
Если процесс деплоймента - это копирование определенных бинарных файлов в некую папку на диске, то достаточно написать скрипт который будет выполнять это копирование, и если нужно - выполнять дополнительные действия.
Расмотрим пример, когда билд собирается на TeamCity и билд доступен на скачивание в архиве.
Задача, которая стоит перед нами - сделать деплоймент билда на нужную машину автоматически (скриптом). Автоматизировать можно скачивание, распаковку архива и копирование файлов. Разберем эти шаги по-порядку.
1. Формирование URL для доступа к артифактам билда.
TeamCity, предоставляет удобный и обширный REST API, которым мы будем пользоваться. Ниже немного базовой информации о тех возможностях API, которые нам пригодятся для нашей задачи.
TeamCity REST API поддерживает:
- Basic HTTP аутентификацию:
http://<user>:<password>@TeamCityServer:9090/httpAuth/<path>
Где <user> и <password> - имя пользователя и его пароль, зарегестрированный в TeamCity. - Гостевой доступ:
http://TeamCityServer:9090/guestAuth/<path>
Структура URL в REST API:
Формируем URL для скачивания артифактов BuildResults.zip последнего успешного билда с сервера TeamCityServer:9090, идентификатор конфигурации - TestProject_TestConfiguration. Для доступа к серверу используем пользователя с именем TestUser и паролем TestUserPass:
Больше деталей по доступу к артифактам билдов можно найти по этот ссылке.
2. Скачивание архива с сервера TeamCity.
http://TeamCityServer:port/<authType>/app/rest/<entity>
- TeamCityServer - указывает хост сервера, который использует TeamCity
- port - указывает порт
- authType - тип аутентификации (возможные варианты httpAuth и guestAuth)
- entity - указывает сущность, которую необходимо вернуть
- доступ к указанному билду по номеру:
http://TeamCityServer:port/<authType>/repository/download/ <buildConfigurationId>/<BUILD_NUMBER>/<ARTIFACT_PATH>
- доступ к последнему успешному билду:
http://TeamCityServer:port/<authType>/repository/download/ <buildConfigurationId>/.lastSuccessful/<ARTIFACT_PATH>
- получить версию последнего успешного билда:
http://TeamCityServer:port/<authType>/app/rest/buildTypes/id:<buildConfigurationId>/builds/status:SUCCESS/number
Формируем URL для скачивания артифактов BuildResults.zip последнего успешного билда с сервера TeamCityServer:9090, идентификатор конфигурации - TestProject_TestConfiguration. Для доступа к серверу используем пользователя с именем TestUser и паролем TestUserPass:
http://TestUser:TestUserPass@TeamCityServer:9090/httpAuth/repository/ download/TestProject_TestConfiguration/.lastSuccessful/BuildResults.zip
Больше деталей по доступу к артифактам билдов можно найти по этот ссылке.
2. Скачивание архива с сервера TeamCity.
Для скачивания файлов, и в целом для работы с протоколами, использующими URL, существует свободная, кросплатформенная, консольная утилита cURL. Утилита позволяет автоматизировать передачу данных и автоматизировать работу пользователя с Web-браузером.
В контексте нашей задачи, cURL можно использовать как утилиту для скачивания файла по сформированному ранее URL.
curl -o Artifacts.zip http://<server>/<filePath>
3. Распаковка архива
Для распаковки скачанного архива можно использовать консольный архиватор 7zip, который распространяется по лицензии GNU LGPL и поддерживает большинство современных форматов архивов. Отличная утилита для наших целей.
Команда:
Команда:
7za e BuildArtifacts.zip -o "Output Directory" -yраспаковывает архив в указанную директорию, и заменяет все файлы в ней на новые
4. Готовый batch-скрипт
Собрав все шаги воедино, получим готовый скрипт:
cls @echo off set buildNumber=%1 rem define credentials set user=testUser set password=testUserPass set host=TeamCityServer set port=9090 rem define url prefix set urlPrefix=http://%user%:%testUserPass%@%host%:%port%/httpAuth if NOT [%buildNumber%]==[] set fullBuildNum=1.2.100.%buildNumber% if NOT [%buildNumber%]==[] GOTO RUN echo Getting the latest successful version .\tools\curl -s %urlPrefix%/app/rest/buildTypes/id:TestProject_TestConfiguration/builds/ status:SUCCESS/number > latestVer.txt set /p fullBuildNum=<latestVer.txt echo The latest successfull version is %fullBuildNum% :RUN echo ---- echo Downloading build %fullBuildNum%.zip echo ---- .\tools\curl -o %fullBuildNum%.zip %urlPrefix%/repository/download/TestProject_TestConfiguration/ %fullBuildNum%/%fullBuildNum%.zip xcopy %fullBuildNum%.zip ".\.artifacts\*" /Y del %fullBuildNum%.zip /F echo ---- echo Extracting build %fullBuildNum%.zip echo ---- .\tools\7za e .\.artifacts\%fullBuildNum%.zip -o"c:\DeploymentDir" -y echo ---- echo Build %fullBuildNum%.zip installed echo ----
Комментариев нет:
Отправить комментарий