기본 콘텐츠로 건너뛰기

[Jenkins] Pipeline Job 구축

Pipeline 프로젝트를 생성하기 위해서는 Groovy 스크립트를 알아야 합니다.
하지만 Freestyle 프로젝트보다는 스크립트를 사용하기 때문에 한 군데서 빌드 흐름을 제어가 가능합니다.
Freestyle의 경우는 설정하는 부분이 여기저기 흩어져 있어 설정하기에 산만한 것 같습니다.
Jenkins Pipeline에 대해서는 여기를 참조하면 좋을것 같습니다.
아래 2가지 종류의 프로젝트에 대해서 Jenkins 파이프 라인을 구축하였습니다. 둘다 흐름은 동일합니다.
.NET 프로젝트 파이프라인

파이썬 프로젝트 파이프라인


우선 Jenkins의 "시스템 설정 에서 프로젝트 빌드에 필요한 환경 변수들을 설정합니다.
  1. - 버전별 Python 실행 파일 경로 : Python 프로젝트 컴파일에 필요합니다.
  2. - MsBuild.exe 파일 경로 : .NET 솔류션 컴파일에 필요합니다.
  3. - WixToolSet 파일 경로들 : 설치 파일 생성에 필요합니다.
  4. - CURL, DOXYGEN .... : 필요한 파일들을 추가합니다.


1. git에서 소스 얻어오기
git에 접속하여 소스를 얻어올 사용자의 Credential을 추가합니다. ID/PASSWORD를 입력하면 됩니다.

stage('Checkout') {
    steps {
        git branch: 'master', credentialsId: 'Your credentials id', url: '{Repository Path}'
    }
2. Python 가상 환경 구축
    이전 글을 참조하시면 됩니다.

3. 버전 수정
    Jenkins로 빌드할 때마다 Jenkins BUILD_NUMBER로 실행 파일 및 설치 파일의 빌드 넘버를 설정하도록 합니다.
    MSDN을 찾아보면 빌드 넘버는 Major.Minor.Build.Revision으로 구성되어 있습니다. Python 프로젝트의 경우 세번째 Build를 PowerShell을 사용하여 Jenkins의 BUILD_NUMBER로 설정해줍니다.

    .NET의 AssemblyInfo.cs의 버전 정보는 powershell로는 변경이 어려워 C#으로 초간단한 프로그램을 작성하였습니다. 인자로 AssemblyInfo.cs 파일 경로와 BUILD_NUMBER를 받습니다.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.IO;
using System.Text.RegularExpressions;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            if(args.Length == 2 && File.Exists(args[0]))
            {
                List<string> oNewList = new List<string>();

                string[] lines = System.IO.File.ReadAllLines(args[0]);
                foreach (string line in lines)
                {
                    if(line.StartsWith("[assembly: AssemblyVersion(\""))
                    {
                        int length = "[assembly: AssemblyVersion(\"".Length;
                        string version = line.Substring(length, line.Length - length - 3);
                        string[] tokens = version.Split('.');
                        oNewList.Add($"[assembly: AssemblyVersion(\"{tokens[0]}.{tokens[1]}.{args[1]}.{tokens[3]}\")]");
                    }
                    else if(line.StartsWith("[assembly: AssemblyFileVersion(\""))
                    {
                        int length = "[assembly: AssemblyFileVersion(\"".Length;
                        string version = line.Substring(length, line.Length - length - 3);
                        string[] tokens = version.Split('.');
                        oNewList.Add($"[assembly: AssemblyFileVersion(\"{tokens[0]}.{tokens[1]}.{args[1]}.{tokens[3]}\")]");
                    }
                    else
                    {
                        oNewList.Add(line);
                    }
                }

                File.WriteAllLines(args[0], oNewList);
            }
        }
    }
}
bat "${ChangeAssembly} ${WORKSPACE}/DTI_PID/PDF_TO_IMAGE/Properties/AssemblyInfo.cs ${env:BUILD_NUMBER}"
위 코드에서 만들어 시스템 설정에 추가한 ChangeAssembly는 ${ChangeAssembly} 형식으로 호출합니다.
//  PYTHON
// version.rc 파일을 열어 {BUILD_NUMBER} 텍스트를 Jenkins의 BUILD_NUMBER 값으로 바꾸어 저장합니다.
powershell """(get-content ${WORKSPACE}/version.rc) | % {\$_ -replace '{BUILD_NUMBER}',${env:BUILD_NUMBER}} | Out-File ${WORKSPACE}/version.rc -Encoding ASCII"""
4. 패키지 업데이트
    4.1 Python 패키지 업데이트
      이전 글을 참조하시면 패키지 목록을 추출하여 텍스트 파일을 만드는 방법과 반대로 목록 파일을 이용하여 패키지를 설치하는 방법을 확인할 수 있습니다.
      pip install -r requirements.txt
    3.2 Nuget 패키지 업데이트
      nuget.exe와 packages.config 파일을 이용하여 Nuget 패키지를 업데이트합니다.
      nuget.exe에 대한 자세한 내용은 여기서 확인할 수 있습니다.
      nuget restore a.sln -PackageDirectory ..\packages
5. 컴파일
    5.1 PyInstaller를 이용하여 Python 프로젝트 컴파일
      App.spec 파일은 컴파일하기 위한 설정 파일입니다.
      PyInstaller App.spec --onedir -p PyQt5 -w --log-level=DEBUG --hidden-import=tkinter,pyqtgraph,getmac -y
    5.2 MsBuild.exe를 이용하여 .NET 프로젝트 컴파일
      솔류션 혹은 프로젝트 파일을 빌드 모드, 출력 경로를 설정하여 컴파일합니다.
      ${MSBUILD_VS2017} a.sln -p:Configuration=Release;OutputDirectory=..\Setup
      MSBUILD_VS2017로 시스템 설정에 MSBUILD.exe 경로를 등록했습니다.
6. 설치 파일 생성
    WixToolSet을 이용하여 설치 파일을 생성합니다. 흐름은 아래와 같습니다.

    $version=(get-item ./dist/App/XXXX.exe).VersionInfo.FileVersion
    (get-content ./XXXX.wxs) | % {$_ -replace '{VERSION}',$version} | Out-File ./XXXX.wxs -Encoding ASCII
    ${CANDLE} ".\A.wxs" -out .\Setup\
    ${LIGHT} -out ".\Setup\A-%1.msi" ".\Setup\A.wixobj" -ext WixUIExtension -ext WixUtilExtension
    
7. 아티팩토리에 배포
    CURL 실행 파일을 이용하여 생성한 설치 파일을 Artifactory에 등록합니다. 저희는 JFrog의 Artifactory-OSS를 사용하고 있습니다.
    ${CURL} -uID:Password -X PUT "http://host/artifactory/AViewer/A-%1.msi" -T "./Setup/A-%1.msi"
8. 빌드 결과 메일 발송
    빌드 결과 메일을 프로젝트 관련자들에게 발송합니다.
    html template 파일을 사용하면 훌륭한 빌드 결과물을 받아 볼 수 있습니다.
    html template 파일을 작성하여 Jenkins의 email-templates 폴더에 저장해 둬야 합니다.

    html template 까지 등록했는데 html이 표시되지 않고 에러가 발생할 때가 있습니다.

    이런 경우에는 Jenkins 관리에 가서 스크립트가 실행 가능하도록 승인해줘야 합니다.

    이제 제대로 된 결과 메일을 받을 수 있습니다. 빌드 실패 메일이네요....

댓글

이 블로그의 인기 게시물

80040154 오류로 인해 CLSID가 {xxxx-...}인 구성 요소의 COM 클래스 팩터리를 검색하지 못했습니다.

원문보기 .NET 으로 만든 응용프로그램에서 com 객체를 호출한 경우 Windows7 64bit 에서 제목과 같은 에러가 발생했다. Win32 COM 과 .NET 프로그램간의 호환성 때문에 생긴 문제였다. 원인은 .NET 실행시 JIT 컴파일러에 의해 최적화된 기계어로 변환되기 때문.. Win32 COM은 컴파일시.. Win32 COM에 맞춰 빌드 속성에서 하위버전으로 맞춰 컴파일을 다시하는 방법도 있지만 메인 프로젝트가 .NET이라면 참조되는 모든 프로젝트를 다 바꿔야할 노릇.. 또 다른 방법은 COM+를 이용하여 독립적으로 만드는 것이다. 분리시키는 방법은 아래 주소해서 확인할 수 있다. http://support.microsoft.com/kb/281335 나의 경우는 Win32 COM DLL을 64비트 .NET 프로그램에서 참조하니 COM 객체를 제대로 호출하지 못하였습니다. 그래서 .NET 프로그램의 Target Machine을 x86으로 설정하니 제대로 COM 객체를 호출하였습니다.

[Pyinstaller] 실행 파일 관리자 권한 획득하기

고객사에서 일부 사용자에게서 프로그램 오류가 발생한다며 아래와 같이 에러 캡처를 보내왔습니다. 프로그램에서 로그를 남기기 위해 로그 파일을 생성하는데 권한의 문제로 로그 파일을 생성하지 못해 프로그램 오류가 발생한 것 같습니다. 처음에는 Python 코드에서 관리자 권한을 요청하는 코드를 넣으려고 했는데, 실제로 Stackoverflow를 찾아보면 이런 내용이 나옵니다. 프로그램이 관리자 권한으로 실행되지 않았다면 관리자 권한으로 다시 프로그램을 실행시키는 코드입니다. import os import sys import win32com.shell.shell as shell ASADMIN = 'asadmin' if sys.argv[-1] != ASADMIN: script = os.path.abspath(sys.argv[0]) params = ' '.join([script] + sys.argv[1:] + [ASADMIN]) shell.ShellExecuteEx(lpVerb='runas', lpFile=sys.executable, lpParameters=params) sys.exit(0) 하지만 개인적으로 이런 방식은 마음에 들지 않았고 조금 더 찾아보니 Pyinstaller로 exe 파일을 만들 때 옵션을 설정하여 관리자 권한을 요청하도록 할 수 있다고 합니다. --uac-admin을 옵션에 추가하면 프로그램 실행 시 관리자 권한을 요청할 수 있습니다. pyinstaller.exe --uac-admin sample.py 하지만 안타깝게도 이 방식은 원하는 대로 동작하지 않았습니다. 마지막으로 manifest 파일을 이용하여 시도해보았습니다. spec 파일을 이용하여 pyinstaller로 빌드하면 <실행 파일 이름>.manifest 라는 파일이 생성됩니다. 파일에서 아랫부분을 찾아볼 수 있습니다. <security> <re

초간단 프로그램 락 걸기

프로그램에 락을 걸 일이 생겨났다. 하드웨어 락을 걸면 쉬울텐데 그 정도는 아니고 프로그램의 실행 날짜를 제한 해 달라고 한다. 그래서 파일(license.lic)을 가지고 락을 걸리고 결정을 했다. 요구 사항은 아래와 같다. 1. license.lic 파일이 없으면 프로그램을 실행 할수 없게 한다. 2. 지정한 날짜를 넘어서는 프로그램을 실행 할수 없게 한다. 3. 사용자가 시스템 날짜를 되돌렸을때 인식하여 프로그램을 실행 할수 없게 한다. 음.... 1.번 문제는 사용자가 프로그램을 실행하기 위해서 license.lic 파일을 받아야만 한다. license.lic 파일에는 최근 실행 날짜/종료날짜 이런식으로 적도록 한다.(물론 내용은 암호화 한다.) 최근 실행날짜는 프로그램이 실행때마다 업데이트 하도록 하고 시스템 날짜와 비교하여 시스템 날짜가 최근 실행 날짜보다 이전의 날짜면 시스템 날짜를 되돌렸다고 인식하도록 한다.(3.번 문제 해결) 시스템 날짜와 종료 날짜를 비교하여 시스템 날짜가 종료 날짜를 넘으면 프로그램을 실행 할수 없도록 한다.(2.번 문제 해결)