젠킨스(Jenkins)

  Jenkins는 가장 널리 사용되는 CI(Continuous Integration) 시스템입니다.

저의 경우에는 프로젝트 초기에 Jenkins를 이용하여 빌드 환경을 구축하여 프로젝트 수행 기간 내내 빌드가 깨지지 않도록 하고 있습니다.

Jenkins에서는 여러가지 타입의 항목(Item)들을 생성할 수 있는데 이번에는 Pipeline 항목을 생성하고 설정하는 부분에 대해서 알아보도록 하겠습니다.

새로운 Item 버튼을 눌러 Item 이름 및 타입을 선택합니다.

이제부터는 Pipeline script를 이용하여 빌드 절차를 작성하면 됩니다.
빌드를 위한 Pipeline script에 익숙해져야 합니다.
여기서 Pipeline script 문법에 대한 좋은 정보를 얻을 수 있습니다.

빌드 절차는 아래와 같습니다.

1. 소스 저장소에서 소스를 받아옵니다.

1. // git에서 소스 얻어오기
2. stage('Checkout') {
3. steps {
4. git branch: 'master', credentialsId: 'UID', url: 'http://REPOSITORY/TS.git'
5. }
6. }

2. 빌드 환경을 구축합니다.
빌드할 프로젝트가 Angular 프로젝트이기 때문에 프로젝트에 관련된 패키지들을 쉘 명령어를 통하여 설치한 후에 마찬가지로 쉘 명령어로 프로젝트를 빌드합니다.

1. stage('Install') {
2. steps {
3. sh 'npm install' }
4. }
5.  
6. stage('Build') {
7. steps{
8. sh 'npm run build --prod=true'
9. }
10. }

3. 빌드 결과물을 패키징합니다.
빌드 결과물들을 압축하여 파일로 생성합니다.
BUILD_NUMBER는 Jenkins의 환경 변수입니다.

1. stage('Zip'){
2. steps{
3. powershell """
4. Compress-Archive -Path ./rest-api/app/* -DestinationPath ./rest-api/restapi-${BUILD_NUMBER}.zip
5. Compress-Archive -Path ./dist/board/* -DestinationPath ./dist/board-${BUILD_NUMBER}.zip
6. """
7. }
8. }

4. 패키징 파일을 배포합니다.
패키징 파일을 Artifactory에 배포합니다.

1. stage('Depoly') {
2. steps {
3. powershell """
4. cmd.exe /c ${CURL} -uID:PASSWORD -X PUT "http://URL/artifactory/FlaskApp/rest-api-${BUILD_NUMBER}.zip" -T "./rest-api/rest-api-${BUILD_NUMBER}.zip"
5. cmd.exe /c ${CURL} -uID:PASSWORD -X PUT "http://URL/artifactory/FlaskApp/board-${BUILD_NUMBER}.zip" -T "./dist/board-${BUILD_NUMBER}.zip"
6. """
7. }
8. }

5. Artifactory에서 배포 파일을 확인할 수 있습니다.

아래는 Python 프로젝트에 관한 script 예제입니다.

1. def BUILD_NUMBER = "$BUILD_NUMBER"
2.  
3. pipeline {
4. agent any
5.  
6. environment {
7. BUILD_NAME = "1.0.0.0"
8. }
9.  
10. stages {
11. // git에서 소스 얻어오기
12. stage('Checkout') {
13. steps {
14. git branch: 'master', credentialsId: 'UID', url: 'http://URL/AViewer.git'
15. }
16. }
17.  
18. // PyInstaller으로 빌드 실행하기
19. stage('Build') {
20. steps {
21. powershell """(get-content ${WORKSPACE}/version.rc) | % {\$_ -replace 'BUILD_NUMBER',\${env:BUILD_NUMBER}} | Out-File \${WORKSPACE}/version.rc -Encoding ASCII"""
22. powershell """virtualenv ${WORKSPACE}/.venv"""
23.  
24. bat "./build.bat"
25. }
26. }
27.  
28. // Create a package file by using WIX
29. stage('Package') {
30. steps {
31. powershell """
32. \$version=(get-item ./dist/App/AViewer.exe).VersionInfo.FileVersion
33. Out-File -FilePath ./propfile -InputObject "BUILD_NAME=\$version" -Encoding ASCII
34. (get-content ./AViewer.wxs) | % {\$_ -replace '{VERSION}',\$version} | Out-File ./AViewer.wxs -Encoding ASCII
35. cmd.exe /c package.bat \$version
36. """
37.  
38. script{
39. env.BUILD_NAME = "1.0.0.0"
40. }
41. }
42. }
43.  
44. stage('Depoly') {
45. steps {
46. powershell """
47. \$version=(get-item ./dist/App/AViewer.exe).VersionInfo.FileVersion
48. cmd.exe /c deploy.bat \$version
49. """
50. }
51. }
52.  
53. stage('Notification') {
54. steps {
55. script {
56. // send to email
57. def mailRecipients = "Email"
58. def jobName = currentBuild.fullDisplayName
59. env.BUILD_NAME='1.0.0.0'
60.  
61. emailext body: '''${SCRIPT, template="AViewer_html.template"}''',
62. mimeType: 'text/html',
63. subject: "[Jenkins] ${jobName}",
64. to: "${mailRecipients}",
65. replyTo: "${mailRecipients}",
66. recipientProviders: [[$class: 'CulpritsRecipientProvider']]
67. }
68. }
69. }
70. }
71. post {
72. always {
73. echo 'This will always run'
74.  
75. emailext body: "${currentBuild.currentResult}: Job ${env.JOB_NAME} build ${env.BUILD_NUMBER}\n More info at: ${env.BUILD_URL}",
76. recipientProviders: [[$class: 'DevelopersRecipientProvider'], [$class: 'RequesterRecipientProvider']],
77. subject: "Jenkins Build ${currentBuild.currentResult}: Job ${env.JOB_NAME}",
78. to: "Email"
79. }
80. success {
81. echo 'This will run only if successful'
82. }
83. failure {
84. emailext body: '''${SCRIPT, template="AViewer_html.template"}''',
85. subject: "[Jenkins] REPORT",
86. to: "Email"
87. }
88. unstable {
89. echo 'This will run only if the run was marked as unstable'
90. }
91. changed {
92. echo 'This will run only if the state of the Pipeline has changed'
93. echo 'For example, if the Pipeline was previously failing but is now successful'
94. }
95. }
96. }