HotFix-ის ავტომატიზაცია Maven პროექტებში TeamCity-ის გამოყენებით

ეს პოსტი აღწერს HotFix ავტომატიზაციის დაყენებას Maven პროექტებში Teamcity-ის გამოყენებით.

HotFix-ის გასაკეთებლად, ჩვეულებრივ კეთდება მრავალი ხელით ნაბიჯი:

1. შექმენით ბრანჩი იმ გამოშვებისთვის, რომლითაც გსურთ HotFix-ის გაშვება
2. შეასწორეთ გამოშვების ხარვეზი
3. შეცვალეთ bugfix ვერსია გამოშვების ფილიალში
4. გააფართოვეთ bugfix ვერსიის ტეგი

1,3,4 ქულები შეიძლება ავტომატიზირებული იყოს.

სანამ თემას გადავიდოდეთ, მინდა შევეხო მნიშვნელოვან და რთულ თემას - ვერსიირება პროგრამული უზრუნველყოფა. თქვენ შეგიძლიათ მოკლედ გაიგოთ Semver ამ სკრინშოტში.

მეტი შეგიძლიათ წაიკითხოთ ბმულზე: 1.

ამ პოსტში აღწერილი ყველა პარამეტრი ეფუძნება სემვერი и მაგისტრალური დაფუძნებული განვითარება.

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 increment bugfix (bugfix-ის ვერსიის შეცვლა))

• Maven-ის გამოშვება (ახალი გამოშვების შექმნა)

პროექტის სკრინშოტი:

ზოგადი პარამეტრები

ყველა ამოცანაში თქვენ უნდა მონიშნოთ ყუთი "Clean build: წაშალეთ ყველა ფაილი შეკვეთის დირექტორიაში აშენებამდე“, რადგან ამ ჩამრთველის გარეშე მე მივიღე შეცდომები.

ჩვენ ვქმნით ერთ 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 გამოშვება: მომზადება ვარიანტით -- პარტიული რეჟიმი

შექმენით ფილიალი გასათავისუფლებლად

გამოშვებისთვის ცხელი შესწორების შესაქმნელად, თქვენ უნდა შექმნათ ფილიალი. ეს არის ის, რასაც ამოცანა აკეთებს შექმენით ფილიალი გასათავისუფლებლად. მას აქვს 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 increment bugfix

დავალება შედგება 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 ფაილში.

მიზნები: მავენს ყველაფერი ერთ ხაზზე აქვს

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 ვერსია და დააინსტალირებს მასში გუნდური ქალაქი ცვლადი 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