Автоматизиране на HotFix в проекти на Maven с помощта на TeamCity

Тази публикация ще опише настройката на HotFix автоматизация в проекти на Maven с помощта на Teamcity.

За да направите HotFix, обикновено се правят много ръчни стъпки:

1. Създайте брънч за изданието, към което искате да внедрите HotFix
2. Коригиране на грешка в изданието
3. Променете версията на корекцията на грешки в клона на изданието
4. Разпространете маркера за версия на корекция на грешки

Точки 1,3,4 могат да бъдат автоматизирани.

Преди да преминем към темата, бих искал да засегна една важна и сложна тема - създаване на версии софтуер. Можете накратко да разберете Semver в тази екранна снимка.

Можете да прочетете повече на линка: 1.

Всички настройки, описани в тази публикация, се основават на Семвър и Trunk-базирано развитие.

В Trunk-Based Development трябва да създадете свой собствен клон за всяко издание. Всички промени (актуални корекции) в тази версия са ангажирани към този клон.

Като част от тази публикация ще автоматизираме следните неща:

• CI изграждане

• Създаване на нова версия

• Създаване на клон за освобождаване

• Промяна на версията на корекция на грешки

Изисквания:

• Git хранилище за съхранение на вашия код. Публикацията ще използва хранилището https://gitlab.com/anton_patsev/automation-maven-hotfix.
• Teamcity сървър и агент. Можете да повдигнете вашия локален сървър и агент на Teamcity, като използвате докер-ново съобщение
• Там, където имате агент на Teamcity, трябва да са инсталирани java, maven, git

Нека създадем проекта „Automation Maven Hotfix“ в Teamcity и да създадем 4 задачи там.

• CI Build

• Създайте клон за освобождаване

• Maven увеличава корекция на грешки (Промяна на версията на корекция на грешки))

• Версия на Maven (Създаване на нова версия)

Екранна снимка на проекта:

Общи настройки

Във всички задачи трябва да поставите отметка в квадратчето "Чиста компилация: Изтрийте всички файлове в директорията за плащане преди компилацията“, защото без това квадратче за отметка получавам грешки.

Създаваме един VCS. Характеристиките на VCS са оградени в червено.

Обикновено VCS използват HTTPS схемата. IN Спецификация на клона: указано за гледане на всички брънчове и всички тагове:

+:refs/heads/*
+:refs/tags/*

Необходимо е да създадете 4 конфигурационни параметъра.

• BRANCH_FOR_INCREMENT
• TAG_FROM_VERSION
• TEAM_USER
• TEAM_USER_EMAIL

Полето за стойност в BRANCH_FOR_INCREMENT и TAG_FROM_VERSION трябва да остане празно.

Трябва да качите/добавите частен ключ. Всички задачи с изключение на CI Build изискват частен ключ.

Във всяка задача, с изключение на CI Build, в секцията Build Features трябва да свържете частен ключ.

Пример за Издаване на Maven

CI Build**.

В задача CI Build само една крачка mvn чист тест

Издаване на Maven

В задача Издаване на Maven 2 стъпки. Първата стъпка е да проверите дали брънчът е такъв майстор. Ако брънчът не е майстор, тогава задачата пада.

BRANCH=$(git branch | grep * | cut -d ' ' -f2)
echo "$BRANCH"
if [[ "$BRANCH" != "master" ]]; then
  echo 'Branch is not master';
  echo 'Aborting';
  exit 1;
fi

Втората стъпка е стандартна mvn освобождаване: подготовка с опция --партиден режим

Създайте клон за освобождаване

За да създадете актуална корекция за издание, трябва да създадете клон. Това прави taska Създайте клон за освобождаване. Тя има 2 стъпки.

Първата стъпка проверява дали брънчът не е такъв майстор, а вторият проверява дали версията е във файла pom.xml не съдържа думата МОМЕНТАЛНА СНИМКА

BRANCH=$(git branch | grep * | cut -d ' ' -f2)
echo "$BRANCH"
if [[ "$BRANCH" == "master" ]]; then
  echo 'Branch is master';
  echo 'Aborting';
  exit 1;
fi

echo "Get version package from pom.xml"
version=`python -c "import xml.etree.ElementTree as ET; print(ET.parse(open('pom.xml')).getroot().find('{http://maven.apache.org/POM/4.0.0}version').text)"`

echo "Check SNAPSHOT"
if [[ $version == "*SNAPSHOT*" ]]; then
    echo "******************* W A R N I N G *************************"
    echo "************ You are create branch for SNAPSHOTS ******************"
    echo "***********************************************************"
    exit 1
fi

Втората стъпка променя схемата на свързване в developerConnection от HTTPS на GIT.

# Здесь получаем developerConnection из файла pom.xml
developerConnection=$(xmllint -xpath "/*[local-name() = 'project' ]//*[local-name() = 'developerConnection']/text()" pom.xml | sed  's|scm:git:ssh://||')
echo developerConnection
echo $developerConnection
# Здесь меняем / на : в URL для git_remote_url
git_remote_url=$(echo $developerConnection| sed 's/gitlab.com//gitlab.com:/g')
echo git_remote_url
echo $git_remote_url

git remote set-url origin $git_remote_url

# Если вы не используете ввстроенную возможность Teamcity получения user и email из ~/.gitconfig, то можно указать их здесь
echo 'git config user.name %TEAM_USER%'
git config user.name %TEAM_USER%
echo 'git config user.email %TEAM_USER_EMAIL%'
git config user.email %TEAM_USER_EMAIL%

# Здесь получаем версию из файла pom.xml
echo "Get version package from pom.xml"
version=`python -c "import xml.etree.ElementTree as ET; print(ET.parse(open('pom.xml')).getroot().find('{http://maven.apache.org/POM/4.0.0}version').text)"`
echo $version

# Почему-то без fetch выдавало ошибку.
git fetch

if [ `git branch -a | egrep "${version}$"` ]
then
    echo "Branch exists"
    exit 1
fi

# Создаем бранч той версии, который был в файле pom.xml
echo "Create branch"
git checkout -b $version

# Чистый git всегда предлагает настроить политику отправки.
git config --global push.default simple

# Пушим в ветку совпадающую с версией в pom.xml
echo "Push release branch"
git push --set-upstream origin $version

Поправка на грешка при увеличаване на Maven

Задачата се състои от 6 части. Можеше да бъде преработено, но все още работи.

Първата стъпка е да проверите дали брънчът не е такъв майстор. Ако брънч майстор задачата пада.

BRANCH=$(git branch | grep * | cut -d ' ' -f2)
echo "$BRANCH"
if [[ "$BRANCH" == "master" ]]; then
  echo 'Branch is master';
  echo 'Aborting';
  exit 1;
fi

# Здесь получаем версию из файла pom.xml
echo "Get version package from pom.xml"
BRANCH=`python -c "import xml.etree.ElementTree as ET; print(ET.parse(open('pom.xml')).getroot().find('{http://maven.apache.org/POM/4.0.0}version').text)"`
# Приходится делать checkout на нужный бранч.
# Иначе git status показывает detached к нужному бранчу.
# Нужно чтобы git status показывал просто бранч
git checkout $BRANCH
# Экспортируем переменную bash в переменную Teamcity для дальнейшего использования.
echo "##teamcity[setParameter name='BRANCH_FOR_INCREMENT' value='$BRANCH']"

Втората стъпка на Maven е промяна на версията на корекция на грешки във файла pom.xml.

Цели: Maven има всичко на един ред

build-helper:parse-version versions:set -DnewVersion=${parsedVersion.majorVersion}.${parsedVersion.minorVersion}.${parsedVersion.nextIncrementalVersion} versions:commit

Третата стъпка е да се покаже информация за състоянието на Git и други:

echo 'cat pom.xml'
cat pom.xml
echo 'git status'
git status
echo 'git remote -v'
git remote -v
echo 'git branch'
git branch

Четвъртата стъпка променя схемата на свързване в developerConnection от HTTPS на GIT.

И натиска промени в клона, посочен в Teamcity от променливата %BRANCH_FOR_INCREMENT%

# Здесь получаем developerConnection из файла pom.xml
developerConnection=$(xmllint -xpath "/*[local-name() = 'project' ]//*[local-name() = 'developerConnection']/text()" pom.xml | sed  's|scm:git:ssh://||')
echo developerConnection
# Здесь меняем / на : в URL для git_remote_url
git_remote_url=$(echo $developerConnection| sed 's/gitlab.com//gitlab.com:/g')
echo git_remote_url
echo $git_remote_url

git remote set-url origin $git_remote_url

# Если вы не используете ввстроенную возможность Teamcity получения user и email из ~/.gitconfig, то можно указать их здесь
echo 'git config user.name %TEAM_USER%'
git config user.name %TEAM_USER%
echo 'git config user.email %TEAM_USER_EMAIL%'
git config user.email %TEAM_USER_EMAIL%
echo 'git add .'
git add .
echo 'git commit -m "Increment bugfix"'
git commit -m "Increment bugfix"

git push --set-upstream origin %BRANCH_FOR_INCREMENT%

Петата стъпка е получаване от файла pom.xml версия и я инсталира в Teamcity променлива TAG_FROM_VERSION. Имайте предвид, че версията от файла pom.xml без буквата v отпред. И етикетът, базиран на тази версия, вече има буквата v в началото.

echo "Get version package from pom.xml"
VERSION_AFTER_CHANGE=`python -c "import xml.etree.ElementTree as ET; print(ET.parse(open('pom.xml')).getroot().find('{http://maven.apache.org/POM/4.0.0}version').text)"`
echo $VERSION_AFTER_CHANGE
echo "##teamcity[setParameter name='TAG_FROM_VERSION' value='v$VERSION_AFTER_CHANGE']"

Шеста стъпка - маркиране поправка на бъг версии. Това се прави с помощта на Maven с необходимата опция в Цел.

Вариант Целите на:

-Dtag=%TAG_FROM_VERSION% scm:tag

Източник: www.habr.com