BuildBot을 사용하여 지속적 통합을 구현하는 예

(이미지 by 컴퓨터화기 에 픽사베이)

Привет!

내 이름 예브게니 체르킨, 저는 광산회사 개발팀의 프로그래머입니다. 폴리 메탈.

대규모 프로젝트를 시작할 때 "서비스를 제공하는 데 어떤 소프트웨어를 사용하는 것이 가장 좋은가?"라고 생각하기 시작합니다. IT 프로젝트는 다음 버전을 출시하기 전에 여러 단계를 거칩니다. 이러한 단계의 체인이 자동화되면 좋습니다. IT 프로젝트 자체의 새 버전을 출시하는 자동화된 프로세스를 지속적인 통합. 빌드봇 이 프로세스를 구현하는 데 좋은 조력자가 되었습니다.

이 기사에서 나는 가능성에 대한 개요를 제공하기로 결정했습니다. 빌드봇. 이 소프트웨어는 무엇을 할 수 있나요? 그에게 접근하는 방법과 그와 정상적인 효과적인 업무 관계를 구축하는 방법은 무엇입니까? 귀하의 컴퓨터에서 프로젝트를 구축하고 테스트하기 위한 작업 서비스를 생성하여 우리의 경험을 직접 적용할 수 있습니다.

내용

내용

1. 왜 BuildBot인가?
2. BuildMaster가 주도하는 컨셉
3. 설치
4. 첫 번째 단계

5. 구성. 단계별 레시피

5.1 BuildmasterConfig
5.2 노동자
5.3 변경_소스
5.4 스케줄러

5.5 빌드팩토리
5.6명의 건축업자

6. 자신만의 구성 예시

6.1 master.cfg로 가는 중
6.2 svn으로 작업하기
6.3 귀하에게 보내는 편지: 기자는 선언할 권한이 있습니다.

우리는 해냈다! 축하해요

1. 왜 BuildBot인가?

이전에 habr-e에서 구현에 관한 기사를 접했습니다. 지속적인 통합 사용 빌드봇. 예: 이거 가장 유익하다고 느꼈습니다. 또 다른 예가 있습니다 - 더 단순한. 이 기사는 양념이 될 수 있습니다 매뉴얼의 예과 그것 그 이후에는 영어로. 쿠페는 좋은 출발점이 됩니다. 이 기사를 읽은 후에는 아마도 즉시 뭔가를 원하게 될 것입니다. 빌드봇 할

멈추다! 실제로 프로젝트에 사용한 사람이 있나요? 그렇습니다. 많은 그것을 자신의 업무에 적용했습니다. 찾을수있다 예제들 사용 빌드봇 그리고 Google 코드 아카이브에 있습니다.

그렇다면 사람들이 사용하는 논리는 무엇입니까? 빌드 봇? 결국, 다른 도구도 있습니다: 크루즈 컨트롤 и 젠킨스. 나는 이렇게 대답할 것이다. 대부분의 작업에 대해 젠킨스 진실은 충분할 것입니다. 차례로, 빌드봇 - 더 적응력이 뛰어나고 문제는 다음과 같이 간단하게 해결됩니다. 젠킨스. 선택은 당신의 것입니다. 그러나 우리는 개발 대상 프로젝트를 위한 도구를 찾고 있으므로 간단한 단계부터 시작하여 상호 작용성과 고유한 인터페이스를 갖춘 빌드 시스템을 얻을 수 있는 도구를 선택하는 것이 좋습니다.

Python으로 대상 프로젝트를 작성하는 사람들에게는 "프로젝트에서 사용되는 언어 측면에서 명확한 인터페이스를 갖춘 통합 시스템을 선택하는 것이 어떨까요?"라는 질문이 생깁니다. 이제 장점을 소개할 차례입니다 빌드봇.

그래서 우리의 "악기 XNUMX 중주". 나 자신을 위해 네 가지 특징을 확인했습니다. 빌드봇:

1. GPL 라이센스에 따른 오픈 소스 프레임워크입니다.
2. Python을 구성 도구로 사용하고 필요한 작업에 대한 설명입니다.
3. 이는 조립이 이루어지는 기계로부터 응답을 받을 수 있는 기회입니다.
4. 마지막으로 호스트의 최소 요구 사항은 다음과 같습니다. 배포에는 Python 및 Twisted가 필요하며 가상 머신 및 Java 머신은 필요하지 않습니다.

2. BuildMaster가 주도하는 컨셉

작업 분배 아키텍처의 핵심은 다음과 같습니다. 빌드마스터. 이는 다음과 같은 서비스입니다.

• 추적하다 프로젝트 소스 트리의 변경 사항
• 보냄 프로젝트를 빌드하고 테스트하기 위해 작업자 서비스에서 실행해야 하는 명령
• 통지 취해진 조치의 결과에 대한 사용자

빌드마스터 파일을 통해 구성됨 master.cfg. 이 파일은 루트에 있습니다 빌드마스터. 나중에 이 루트가 어떻게 생성되는지 보여 드리겠습니다. 파일 자체 master.cfg 호출을 사용하는 Python 스크립트가 포함되어 있습니다. 빌드봇.

다음으로 중요한 객체 빌드봇 그것은 이름이 노동자. 이 서비스는 다른 OS를 사용하는 다른 호스트에서 시작될 수 있습니다. 빌드마스터. 자체 패키지와 변수를 사용하여 특별히 준비된 가상 환경에 존재할 수도 있습니다. 이러한 가상 환경은 다음과 같은 Python 유틸리티를 사용하여 준비할 수 있습니다. 가상 환경, 가상 환경.

빌드마스터 모든 사람에게 명령을 방송합니다. 노동자-y, 그리고 그는 차례로 그것들을 이행합니다. 즉, 프로젝트를 구축하고 테스트하는 과정이 계속될 수 있다는 것이 밝혀졌습니다. 노동자-e Windows를 실행하고 Linux를 실행하는 다른 작업자에서.

점검 프로젝트 소스 코드는 각각에서 발생합니다. 노동자-이자형.

3. 설치

자, 가자. 저는 Ubuntu 18.04를 호스트로 사용하겠습니다. 그 위에 하나 올려 놓을게 빌드마스터-a와 하나 노동자-ㅏ. 하지만 먼저 python3.7을 설치해야 합니다.

sudo apt-get update
sudo apt-get install python3.7

3.7.2 대신 python3.7.1가 필요한 경우 다음을 수행할 수 있습니다.

sudo apt-get update
sudo apt-get software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get install python3.7
sudo ln -fs /usr/bin/python3.7 /usr/bin/python3
pip3 install --upgrade pip

다음 단계는 설치입니다. 트윗됨 и 빌드봇, 추가 기능을 사용할 수 있는 패키지 빌드봇-NS.

/*Все что под sudo будет установленно для всех пользователей в директорию /usr/local/lib/python3.7/dist-packages*/

#На хосте который производит мониторинг Worker-ов 
sudo pip install twisted #Библиотека twisted
sudo pip install buildbot #BuildMaster
#Дополнительный функционал
pip install pysqlite3 #Устанавливаем базу sqllite в учебных целях
pip install jinja2 #framework наподобие django, для web и для почтовых рассыллок
pip install autobahn #Web cокеты для связи BuildMaster->Worker
pip install sqlalchemy sqlalchemy-migrate #Для отображения схемы базы данных
#Для Web отображения BuildBot-a
pip install buildbot-www buildbot-grid-view buildbot-console-view buildbot-waterfall-view
pip install python-dateutil #Отображение дат в web
#На стороне хоста который непосредственно осуществляет сборку и тестирование 
pip install buildbot-worker #Worker
#Дополнительный функционал
sudo pip install virtualenv #Виртуальная среда 

4. 첫 번째 단계

창조할 시간 빌드마스터. 우리 폴더에 있을 거예요 /집/habr/마스터.

mkdir master
buildbot create-master master # Собственно сдесь и создаем

다음 단계. 만들어 보자 노동자. 우리 폴더에 있을 거예요 /집/habr/작업자.

mkdir worker
buildbot-worker create-worker --umask=0o22 --keepalive=60 worker localhost:4000 yourWorkerName password

당신이 달릴 때 노동자, 기본적으로 다음 위치에 생성됩니다. /집/habr/작업자 프로젝트 이름이 지정된 폴더 master.cfg. 그리고 프로젝트 이름의 폴더에 디렉토리가 생성됩니다. 빌드, 그리고 앞으로도 그럴 것이다 점검. 작업 디렉토리 노동자-그리고 그것은 디렉토리가 될 것입니다 /home/habr/yourProject/빌드.

"황금열쇠
이제 제가 이전 단락을 쓴 이유는 다음과 같습니다. 마스터 ~에게 요구할 것이다 노동자- 스크립트에 실행 권한이 없기 때문에 이 디렉터리에서 원격으로 수행되면 실행되지 않습니다. 상황을 해결하려면 열쇠가 필요합니다 --umask=0o22, 이 디렉토리에 쓰기를 금지하지만 실행 권한은 유지됩니다. 그리고 그것이 우리에게 필요한 전부입니다.

빌드마스터 и 노동자 서로 연결을 설정합니다. 깨지는 일이 발생하고 노동자 잠시 동안의 응답을 기다리고 있습니다. 빌드마스터-ㅏ. 응답이 없으면 연결이 다시 시작됩니다. 열쇠 --keepalive=60 그 이후의 시간을 표시하기만 하면 됩니다. 잇다 재부팅합니다.

5. 구성. 단계별 레시피

구성 빌드마스터 명령을 실행한 머신 측에서 수행됩니다. 생성-마스터. 우리의 경우 이것은 디렉토리입니다. /집/habr/마스터. 구성 파일 master.cfg 아직 존재하지 않지만 명령 자체가 이미 파일을 생성했습니다. master.cmg.샘플. 이름을 다음으로 바꿔야합니다. master.cfg.샘플 в master.cfg

mv master.cfg.sample master.cfg

이거 열어보자 master.cfg. 그리고 그것이 무엇으로 구성되어 있는지 살펴 보겠습니다. 그런 다음 우리만의 구성 파일을 만들어 보겠습니다.

master.cfg

c['change_source'] = []
c['change_source'].append(changes.GitPoller(
    'git://github.com/buildbot/hello-world.git',
         workdir='gitpoller-workdir', branch='master',
         pollInterval=300))
                        
c['schedulers'] = []
c['schedulers'].append(schedulers.SingleBranchScheduler(
        name="all",
        change_filter=util.ChangeFilter(branch='master'),
        treeStableTimer=None,
        builderNames=["runtests"]))
c['schedulers'].append(schedulers.ForceScheduler(
        name="force",
        builderNames=["runtests"]))
                        
factory = util.BuildFactory()
                        
factory.addStep(steps.Git(repourl='git://github.com/buildbot/hello-world.git', mode='incremental'))
factory.addStep(steps.ShellCommand(command=["trial", "hello"],
                                   env={"PYTHONPATH": "."}))
                        
c['builders'] = []
c['builders'].append(
    util.BuilderConfig(name="runtests",
    workernames=["example-worker"],
    factory=factory))
                         
c['services'] = []
                        
c['title'] = "Hello World CI"
c['titleURL'] = "https://buildbot.github.io/hello-world/"
                        
                        
c['buildbotURL'] = "http://localhost:8010/"
                        
c['www'] = dict(port=8010,
                plugins=dict(waterfall_view={}, console_view={}, grid_view={}))
                        
c['db'] = {
    'db_url' : "sqlite:///state.sqlite",
}

5.1 BuildmasterConfig

c = BuildmasterConfig = {} 

BuildmasterConfig — 구성 파일의 기본 사전입니다. 구성 파일에 포함되어야 합니다. 사용 편의성을 위해 구성 코드에 별칭이 도입되었습니다. "씨". 제목 열쇠 в c["keyFromDist"] 상호작용을 위한 고정 요소입니다. 빌드마스터. 각 키에 대해 해당 객체가 값으로 대체됩니다.

5.2 노동자

c['workers'] = [worker.Worker("example-worker", "pass")]

이번에는 표시합니다. 빌드마스터-y 목록 노동자-에스. 내 자신 노동자 우리가 만들었어요 이상, 나타내는 귀하-직장-이름 и 암호. 이제 대신 지정해야 합니다. 모범 노동자 и 패스 .

5.3 변경_소스

c['change_source'] = []
c['change_source'].append(changes.GitPoller(
                            'git://github.com/buildbot/hello-world.git',
                             workdir='gitpoller-workdir', branch='master',
                             pollInterval=300))                

키별 변경_소스 Dictionary C에서는 프로젝트의 소스 코드로 저장소를 폴링하는 객체를 넣을 목록에 액세스할 수 있습니다. 이 예에서는 특정 간격으로 폴링되는 Git 저장소를 사용합니다.

첫 번째 인수는 저장소의 경로입니다.

작업 디렉토리 측면에 있는 폴더의 경로를 나타냅니다. 노동자- 경로에 대한 상대 /home/habr/worker/yourProject/build git은 저장소의 로컬 버전을 저장합니다.

지사 따라야 할 저장소의 특정 분기가 포함되어 있습니다.

폴링 간격 그 이후의 초 수를 포함합니다. 빌드마스터 변경 사항에 대해 저장소를 폴링합니다.

프로젝트 저장소의 변경 사항을 추적하는 방법에는 여러 가지가 있습니다.

가장 간단한 방법은 투표, 이는 다음을 의미합니다. 빌드마스터 정기적으로 저장소를 사용하여 서버를 폴링합니다. 만약에 범하다 저장소의 변경 사항을 반영한 다음 빌드마스터 약간의 지연으로 내부 개체를 생성합니다. 변화 그리고 이벤트 핸들러로 보내주세요 스케줄러, 프로젝트를 빌드하고 테스트하는 단계를 시작합니다. 노동자-이자형. 이 단계 중 표시됩니다 최신 정보 저장소. 정확히 켜짐 노동자그러면 저장소의 로컬 복사본이 생성됩니다. 이 프로세스에 대한 자세한 내용은 다음 두 섹션에서 설명합니다. (5.4 и 5.5).

저장소에 대한 변경 사항을 추적하는 훨씬 더 우아한 방법은 저장소를 호스팅하는 서버에서 직접 메시지를 보내는 것입니다. 빌드마스터- 프로젝트 소스 코드 변경에 대해. 이 경우 개발자가 만드는 즉시 범하다, 프로젝트 저장소가 있는 서버가 메시지를 보냅니다. 빌드마스터-와이. 그리고 그는 차례로 객체를 생성하여 이를 가로챌 것입니다. PBChangeSource. 다음으로 이 개체는 다음으로 전송됩니다. 스케줄러, 프로젝트를 빌드하고 테스트하는 단계를 활성화합니다. 이 방법의 중요한 부분은 다음과 같습니다. 훅- 저장소의 서버 스크립트. 스크립트에서 훅-a, 다음과 같은 경우 작업 처리를 담당합니다. 범하다-e, 유틸리티를 호출해야 합니다 센드체인지 네트워크 주소를 지정하고 빌드마스터-ㅏ. 또한 수신 대기할 네트워크 포트를 지정해야 합니다. PBChangeSource. PBChangeSource, 그건 그렇고, 일부입니다 빌드마스터-ㅏ. 이 방법을 사용하려면 권한이 필요합니다. 관리자-a 프로젝트 저장소가 있는 서버에 있습니다. 먼저 저장소를 백업해야 합니다.

5.4 스케줄러

c['schedulers'] = []
c['schedulers'].append(schedulers.SingleBranchScheduler(
        name="all",
        change_filter=util.ChangeFilter(branch='master'),
        treeStableTimer=None,
        builderNames=["runtests"]))
c['schedulers'].append(schedulers.ForceScheduler(
        name="force",
        builderNames=["runtests"]))

스케줄러 – 이는 프로젝트의 전체 조립 및 테스트 체인을 시작하는 트리거 역할을 하는 요소입니다.


기록된 변경사항 변경_소스, 작업 과정에서 변형됨 빌드봇-a 이의를 제기하다 변화 그리고 지금은 매 셰듈러 이를 기반으로 프로젝트 빌드 프로세스를 시작하라는 요청을 작성합니다. 그러나 이러한 요청이 대기열로 추가로 전송되는 시기도 결정합니다. 객체 건축업자 요청 대기열을 저장하고 현재 어셈블리의 상태를 별도의 위치에 추적합니다. 노동자-이자형. 건축업자 에 존재합니다 빌드마스터-e 이상 노동자-이자형. 그는 함께 보낸다 빌드마스터-에 노동자-그리고 이미 구체적이다 빌드 - 반드시 따라야 할 일련의 단계.
우리는 현재 예에서 다음과 같은 것을 볼 수 있습니다 스케줄러 2개의 조각이 생성됩니다. 또한 각각 고유한 유형이 있습니다.

단일 지점 스케줄러 – 일정 중 가장 인기 있는 수업 중 하나입니다. 하나의 분기를 감시하고 기록된 변경 사항에 의해 트리거됩니다. 변경 사항을 확인하면 빌드 요청 전송을 지연할 수 있습니다(특수 매개변수에 지정된 기간 동안 연기). treeStableTimer) 안으로 name 표시될 일정의 이름을 설정합니다. 빌드봇-웹 인터페이스. 안에 필터 변경 필터가 설정되면 분기의 변경 사항이 구성 요청을 보내도록 일정을 안내합니다. 안에 빌더 이름 이름이 표시되어 있어요 건축업자-a, 이는 나중에 설정하겠습니다. 우리의 경우 이름은 프로젝트 이름과 동일합니다. 너의 프로젝트.

강제 스케줄러 아주 간단한 일이다. 이러한 유형의 일정은 마우스 클릭을 통해 실행됩니다. 빌드봇-웹 인터페이스. 매개변수는 다음과 같은 본질을 가집니다. 단일 지점 스케줄러.

PS 번호 3. 어쩌면 도움이 될 것입니다
간헐적 인 특정 시간에 고정된 빈도로 실행되는 일정입니다. 통화 내용은 다음과 같습니다.

from buildbot.plugins import schedulers
nightly = schedulers.Periodic(name="daily",
                              builderNames=["full-solaris"],
                              periodicBuildTimer=24*60*60)
c['schedulers'] = [nightly]                    

5.5 빌드팩토리

factory = util.BuildFactory()
                        
factory.addStep(steps.Git(repourl='git://github.com/buildbot/hello-world.git', mode='incremental'))
factory.addStep(steps.ShellCommand(command=["trial", "hello"],
                                   env={"PYTHONPATH": "."}))

주기적빌드타이머 이 주기의 시간을 초 단위로 지정합니다.

빌드팩토리 특정을 생성합니다 빌드, 그러면 건축업자 ~에게 보낸다 노동자. 에 빌드팩토리 따라야 할 단계를 나타냅니다. 노동자-와이. 메소드를 호출하면 단계가 추가됩니다. 추가단계

이 예에서 첫 번째로 추가된 단계는 다음과 같습니다. git clean -d -f -f –x, 그 다음에 자식 체크 아웃. 이러한 작업은 매개변수에 포함됩니다. 방법, 이는 명확하게 명시되어 있지 않지만 기본값을 의미합니다. 신선한. 모수 모드='증분' 파일이 다음 디렉터리에 있음을 나타냅니다. Chechout, 저장소에서 누락된 동안에는 그대로 유지됩니다.

두 번째로 추가된 단계는 스크립트를 호출하는 것입니다. 시도 매개변수 포함 안녕하세요 측면에 노동자-a 디렉토리에서 /home/habr/worker/yourProject/build 환경 변수 PATHONPATH=...를 사용하면 자체 스크립트를 작성하고 측면에서 실행할 수 있습니다. 노동자- 모든 단계 util.ShellCommand. 이러한 스크립트는 저장소에 직접 배치할 수 있습니다. 그런 다음 Chechout-e 그들은 빠질 것이다 /home/habr/worker/yourProject/build. 그러나 두 가지 "그러나"가 있습니다.

1. 노동자 키를 사용하여 생성해야 합니다. --umask 이후 실행 권한을 차단하지 않도록 점검-NS.
2. 에 git push-e 이 스크립트 중 속성을 지정해야 합니다. 실행 가능한그래서 나중에 Chechout-e는 Git 스크립트 실행 권한을 잃지 않았습니다.

5.6명의 건축업자

c['builders'] = []
c['builders'].append(util.BuilderConfig(name="runtests",
                                        workernames=["example-worker"],
                                        factory=factory))

그것이 무엇인지에 대해 건축업자 들었다 여기에. 이제 만드는 방법에 대해 자세히 알려 드리겠습니다. 빌더 구성 생성자입니다 건축업자. 그런 디자이너들 c['빌더'] 개체 시트이므로 여러 개를 지정할 수 있습니다. 건축업자 유형. 이제 예제를 다시 작성해 보겠습니다. 빌드봇, 우리의 임무에 더 가까워졌습니다.

c['builders'] = []
c['builders'].append(util.BuilderConfig(name="yourProject",
                                            workernames=["yourWorkerName"],
                                            factory=factory))

이제 매개 변수에 대해 설명하겠습니다. 빌더 구성.

name 이름을 지정합니다 건축업자-ㅏ. 여기에 이름을 붙였습니다. 너의 프로젝트. 이는 다음을 의미합니다. 노동자- 바로 이 길이 만들어질 것이다 /home/habr/worker/yourProject/build. 셰듈러 찾고있는 건축업자 바로 이 이름으로.

작업자 이름 시트 포함 노동자-에스. 각각 추가해야 할 항목은 다음과 같습니다. c['노동자'].

공장 - 특정한 빌드, 이는 연관되어 있습니다. 건축업자. 그는 물건을 보낼 것이다 빌드 에 노동자 여기에 포함된 모든 단계를 완료하려면 빌드-NS.

6. 자신만의 구성 예시

다음은 제가 구현을 제안하는 프로젝트 아키텍처의 예입니다. 빌드봇
.

버전 관리 시스템으로 사용하겠습니다. svn. 저장소 자체는 일종의 클라우드에 위치합니다. 이 클라우드의 주소는 다음과 같습니다 svn.host/svn/yourProject/trunk. 구름 아래에는 svn 계정 사용자 이름이 있습니다: 사용자, 비밀번호: 암호. 단계를 나타내는 스크립트 빌드-a도 지점에 있을 것입니다. svn, 별도의 폴더에 빌드봇/worker_linux. 이러한 스크립트는 저장된 속성이 있는 저장소에 있습니다. 실행 파일.

빌드마스터 и 노동자 동일한 호스트에서 실행 프로젝트.호스트 .빌드마스터 파일을 폴더에 저장 /집/habr/마스터. 노동자 다음 경로에 저장됩니다 /집/habr/작업자. 프로세스 커뮤니케이션 빌드마스터-a 그리고 노동자-a는 프로토콜에 따라 포트 4000을 통해 수행됩니다. 빌드봇-아, 그렇죠 'pb' 규약.

대상 프로젝트는 완전히 Python으로 작성되었습니다. 임무는 변경 사항을 추적하고, 실행 파일을 생성하고, 문서를 생성하고, 테스트를 수행하는 것입니다. 실패할 경우 모든 개발자는 실패한 작업이 있음을 알리는 메시지를 이메일로 보내야 합니다.

웹 디스플레이 빌드봇 포트 80에 연결하겠습니다. 프로젝트.호스트. Apache를 설치할 필요는 없습니다. 도서관의 일부로 꼬인 이미 웹 서버가 있고, 빌드봇 그것을 사용합니다.

내부 정보를 저장하려면 빌드봇 우리는 사용할 것입니다 sqlite.

메일을 보내려면 호스트가 필요합니다. smtp.your.domain - 우편에서 편지를 보낼 수 있습니다. [이메일 보호] 인증 없이. 호스트에서도 'SMTP ' 회의록은 1025번 포스트에서 청취되고 있습니다.

이 과정에는 두 사람이 참여합니다. 관리자 и 사용자. 관리자가 관리합니다 빌드봇. 사용자는 커밋하는 사람입니다. 범하다-에스.

실행 가능한 파일은 다음을 통해 생성됩니다. 파이 인스톨러. 문서는 다음을 통해 생성됩니다. 독소.

이 아키텍처를 위해 나는 다음과 같이 썼습니다. master.cfg:

master.cfg

import os, re
from buildbot.plugins import steps, util, schedulers, worker, changes, reporters

c= BuildmasterConfig ={}

c['workers'] = [ worker.Worker('yourWorkerName', 'password') ]
c['protocols'] = {'pb': {'port': 4000}} 


svn_poller = changes.SVNPoller(repourl="https://svn.host/svn/yourProject/trunk",
                                svnuser="user",
                                svnpasswd="password",
                                pollinterval=60,
				split_file=util.svn.split_file_alwaystrunk
                                )

c['change_source'] =  svn_poller

hourlyscheduler = schedulers.SingleBranchScheduler(
                                name="your-project-schedulers",
				change_filter=util.ChangeFilter(branch=None),
                                builderNames=["yourProject"],
				properties = {'owner': 'admin'}
                                )

c['schedulers'] = [hourlyscheduler]

checkout = steps.SVN(repourl='https://svn.host/svn/yourProject/trunk',
                        mode='full',
                        method='fresh',
                        username="user",
                        password="password",
                        haltOnFailure=True)

	
projectHost_build = util.BuildFactory()  


cleanProject = steps.ShellCommand(name="Clean",
                 command=["buildbot/worker_linux/pyinstaller_project", "clean"]
                                )
buildProject = steps.ShellCommand(name="Build",
                 command=["buildbot/worker_linux/pyinstaller_project", "build"]
                                )
doxyProject = steps.ShellCommand(name="Update Docs",
                                command=["buildbot/worker_linux/gendoc", []]
                                )
testProject = steps.ShellCommand(name="Tests",
                                command=["python","tests/utest.py"],
                                env={'PYTHONPATH': '.'}
                                )

projectHost_build.addStep(checkout)
projectHost_build.addStep(cleanProject)
projectHost_build.addStep(buildProject)
projectHost_build.addStep(doxyProject)
projectHost_build.addStep(testProject)


c['builders'] = [
        util.BuilderConfig(name="yourProject", workername='yourWorkerName', factory=projectHost_build)
]


template_html=u'''
<h4>Статус построенного релиза: {{ summary }}</h4>
<p>Используемый сервис для постраения: {{ workername }}</p>
<p>Проект: {{ projects }}</p>
<p>Для того что бы посмотреть интерфейс управления пройдите по ссылке: {{ buildbot_url }}</p>
<p>Для того что бы посмотреть результат сборки пройдите по ссылке: {{ build_url }}</p>
<p>Используя WinSCP можно подключиться к серверу c ip:xxx.xx.xxx.xx. Войдя под habr/password, забрать собранный executable файл с директории ~/worker/yourProject/build/dist.</p>
<p><b>Построение было произведено через Buildbot</b></p>
'''

sendMessageToAll = reporters.MailNotifier(fromaddr="[email protected]",
					sendToInterestedUsers=True,
					lookup="your.domain",
					relayhost="smtp.your.domain",
					smtpPort=1025,
					mode="warnings",
					extraRecipients=['[email protected]'],
              messageFormatter=reporters.MessageFormatter(
						template=template_html,
						template_type='html',
						wantProperties=True, 
                                                wantSteps=True)
					)
c['services'] = [sendMessageToAll]

c['title'] = "The process of bulding"
c['titleURL'] = "http://project.host:80/"

c['buildbotURL'] = "http://project.host"

c['www'] = dict(port=80,
                plugins=dict(waterfall_view={}, console_view={}, grid_view={}))


c['db'] = {
    'db_url' : "sqlite:///state.sqlite"
}

먼저 필요한 창조하다 빌드마스터-a 그리고 노동자-ㅏ. 그런 다음 이 파일을 붙여넣으세요. master.cfg в /집/habr/마스터.

다음 단계는 서비스를 시작하는 것입니다 빌드마스터아아

sudo buildbot start /home/habr/master

그럼 서비스 시작 노동자-a

buildbot-worker start /home/habr/worker

준비가 된! 지금 빌드 봇 변경 사항을 추적하고 트리거합니다. 범하다-y in svn, 위 아키텍처를 사용하여 프로젝트를 빌드하고 테스트하는 단계를 수행합니다.

아래에서는 위의 몇 가지 기능에 대해 설명하겠습니다. master.cfg.

6.1 master.cfg로 가는 중

내 글을 쓰는 동안 master.cfg 오류가 많이 발생하므로 로그 파일을 읽어야 합니다. 다음과 같이 저장됩니다. 빌드마스터-ec 절대 경로 /home/habr/master/twistd.log, 그리고 그 옆에는 노동자-a 절대 경로 포함 /home/habr/worker/twistd.log. 오류를 읽고 수정한 후에는 서비스를 다시 시작해야 합니다. 빌드마스터-ㅏ. 수행 방법은 다음과 같습니다.

sudo buildbot stop /home/habr/master
sudo buildbot upgrade-master /home/habr/master
sudo buildbot start /home/habr/master

6.2 svn으로 작업하기

svn_poller = changes.SVNPoller(repourl="https://svn.host/svn/yourProject/trunk",
                               svnuser="user",
                               svnpasswd="password",
                               pollinterval=60,
                               split_file=util.svn.split_file_alwaystrunk
                        )

c['change_source'] =  svn_poller

hourlyscheduler = schedulers.SingleBranchScheduler(
                            name="your-project-schedulers",
                            change_filter=util.ChangeFilter(branch=None),
                            builderNames=["yourProject"],
                            properties = {'owner': 'admin'}
                        )

c['schedulers'] = [hourlyscheduler]

checkout = steps.SVN(repourl='https://svn.host/svn/yourProject/trunk',
                     mode='full',
                     method='fresh',
                     username="user",
                     password="password",
                     haltOnFailure=True)

먼저, 살펴 보겠습니다. svn_poller. 이는 여전히 동일한 인터페이스로, XNUMX분에 한 번씩 저장소를 정기적으로 폴링합니다. 이 경우 svn_poller 지점에만 액세스 트렁크. 신비한 매개변수 Split_file=util.svn.split_file_alwaysstrunk 규칙 설정: 폴더 구조를 분할하는 방법 svn 가지에. 그는 또한 그들에게 상대 경로를 제공합니다. 차례대로 분할_파일_alwaystrunk 저장소에는 다음 항목만 포함되어 있음을 말하여 프로세스를 단순화합니다. 트렁크.

В 스케줄러 표시됨 필터 변경누가 보는가 없음 지점을 연결합니다. 트렁크 특정 협회를 통해 분할_파일_alwaystrunk. 변화에 대한 대응 트렁크, 출시 건축업자 이름이 있는 너의 프로젝트.

속성 여기서는 관리자가 프로세스 소유자로서 빌드 및 테스트 결과에 대한 메일링 목록을 수신하기 위해 필요합니다.

단계 빌드-a 점검 저장소의 로컬 버전에 있는 모든 파일을 완전히 삭제할 수 있습니다. 노동자-ㅏ. 그런 다음 전체 작업을 수행하십시오. svn 업데이트. 모드는 매개변수를 통해 구성됩니다. 모드=전체, 방법=신선. 모수 quitOnTailure 만약에 그렇게 말한다 svn 업데이트 오류가 발생하여 실행되면 추가 조치가 의미가 없으므로 빌드 및 테스트의 전체 프로세스가 일시 중지되어야 합니다.

6.3 귀하에게 보내는 편지: 기자는 선언할 권한이 있습니다.

기자 이메일로 알림을 보내는 서비스입니다.

template_html=u'''
<h4>Статус построенного релиза: {{ summary }}</h4>
<p>Используемый сервис для постраения: {{ workername }}</p>
<p>Проект: {{ projects }}</p>
<p>Для того что бы посмотреть интерфейс управления пройдите по ссылке: {{ buildbot_url }}</p>
<p>Для того что бы посмотреть результат сборки пройдите по ссылке: {{ build_url }}</p>
<p>Используя WinSCP можно подключиться к серверу c ip:xxx.xx.xxx.xx. Войдя под habr/password, забрать собранный executable файл с директории ~/worker/yourProject/build/dist.</p>
<p><b>Построение было произведено через Buildbot</b></p>
'''
                        
sendMessageToAll = reporters.MailNotifier(fromaddr="[email protected]",
                                          sendToInterestedUsers=True,
                                          lookup="your.domain",
                                          relayhost="smtp.your.domain",
                                          smtpPort=1025,
                                          mode="warnings",
                                          extraRecipients=['[email protected]'],
                                    messageFormatter=reporters.MessageFormatter(
                                                    template=template_html,
                                                    template_type='html',
                                                    wantProperties=True, 
                                                    wantSteps=True)
                                        )
c['services'] = [sendMessageToAll]

그는 메시지를 보낼 수 있다 다른 방법들.

메일알림기 이메일을 사용하여 알림을 보냅니다.

template_html 뉴스레터의 텍스트 템플릿을 설정합니다. HTML은 마크업을 만드는 데 사용됩니다. 엔진에 의해 수정됩니다. 진자 2 (비교될 수 ​​있다 장고). 빌드봇 메시지 텍스트를 생성하는 과정에서 값이 템플릿으로 대체되는 변수 세트가 있습니다. 이러한 변수는 {{ 이중 중괄호 }}로 묶입니다. 예를 들어, 개요 완료된 작업의 상태, 즉 성공 또는 실패를 표시합니다. ㅏ 프로젝트 출력됩니다 너의 프로젝트. 따라서 제어 명령을 사용하여 진자 2, 변수 빌드봇-a 및 Python 문자열 형식 지정 도구를 사용하면 매우 유익한 메시지를 만들 수 있습니다.

메일알림기 다음 인수가 포함되어 있습니다.

fromaddr – 모든 사람이 뉴스레터를 받을 주소.

관심 있는 사용자에게 보내기=True는 만든 소유자와 사용자에게 메시지를 보냅니다. 범하다.

조회 — 뉴스레터를 받는 사용자 이름에 추가해야 하는 접미사입니다. 그래서 관리자 사용자가 해당 주소에서 뉴스레터를 받는 방법 [이메일 보호].

릴레이호스트 서버가 열리는 호스트 이름을 지정합니다. SMTP은 smpt포트 수신하는 포트 번호를 지정합니다. SMTP 서버.

모드="경고" 적어도 하나의 단계가 있는 경우에만 메일링을 수행해야 한다고 말합니다. 빌드-a, 상태 실패 또는 경고로 종료되었습니다. 성공할 경우 뉴스레터를 보낼 필요가 없습니다.

추가수신자 소유자와 해당 작업을 수행한 사람 외에 우편물을 보내야 하는 사람의 목록이 포함되어 있습니다. 범하다.

메시지포맷 메시지 형식, 해당 템플릿, 사용 가능한 변수 집합을 지정하는 개체입니다. 진자 2. 다음과 같은 옵션 원하는속성=참 и 원하는 단계=참 이 사용 가능한 변수 세트를 정의하십시오.

with['services']=[sendMessageToAll] 서비스 목록을 제공하며 그 중 우리 서비스는 다음과 같습니다. 신고자.

우리는 해냈다! 축하해요

우리는 자체 구성을 만들고 그것이 가능한 기능을 확인했습니다. 빌드봇. 제 생각에는 이 도구가 프로젝트를 만드는 데 필요한지 이해하는 데 충분하다고 생각합니다. 그 사람에게 관심이 있나요? 당신에게 유용할까요? 그 사람은 함께 일하기 편한가요? 그렇다면 나는 이 글을 헛되이 쓰고 있는 것이 아니다.

그리고 더. 전문 커뮤니티에서 사용하고 싶습니다. 빌드봇, 더 넓어졌고, 매뉴얼도 번역되었으며, 예제도 더 많아졌습니다.

관심을 가져주셔서 감사합니다. 행운을 빌어요.

출처 : habr.com