깍돌이의 _WebQA(SQA)

안녕하세요 Jenkins 를 재설치 하게 되서 다른 방법으로 소개 하려고합니다.

// 젠킨스 공식 홈페이지

https://jenkins.io/

1. 메인 홈페이지 이동 후 Download 클릭 

2.  하단으로 스크롤

최신 버전 선택 

3. 다운로드 

(보이는 메뉴얼 대로 wget 으로 받아도 되고 저는 jenkins-2.117-1.1noarch.rpm 을 받아서 FTP로 옮겼습니다.)

4. root 계정으로 접속

명령어 입력

 rpm -Uvh jenkins-2.117-1.1.noarch.rpm

5. Jenkins Port 설정(루트 계정)

Default 8080 을 쓰지만 예약 포트라 겹칠 일이 있어 변경해줍니다.

vi /etc/sysconfig/jenkins

6. /etc/init.d/jenkins start or /etc/init.d/jenkins restart

Starting jenkins (via systemctl):  Job for jenkins.service failed because the control process exited w                                                                ith error code. See "systemctl status jenkins.service" and "journalctl -xe" for details.

에러가 났습니다.

 jenkins.service - LSB: Jenkins Automation Server

   Loaded: loaded (/etc/rc.d/init.d/jenkins; bad; vendor preset: disabled)

   Active: failed (Result: exit-code) since 월 2018-04-16 19:19:38 KST; 2min 32s ago

     Docs: man:systemd-sysv-generator(8)

  Process: 24668 ExecStart=/etc/rc.d/init.d/jenkins start (code=exited, status=1/FAILURE)

 4월 16 19:19:38 localhost.localdomain systemd[1]: Starting LSB: Jenkins Automation Server...

 4월 16 19:19:38 localhost.localdomain runuser[24673]: pam_unix(runuser:session): session opened for user jenkins by (uid=0)

 4월 16 19:19:38 localhost.localdomain jenkins[24668]: Starting Jenkins bash: /usr/bin/java: 그런 파일이나 디렉터리가 없습니다

 4월 16 19:19:38 localhost.localdomain jenkins[24668]: [실패]

 4월 16 19:19:38 localhost.localdomain systemd[1]: jenkins.service: control process exited, code=exited status=1

 4월 16 19:19:38 localhost.localdomain systemd[1]: Failed to start LSB: Jenkins Automation Server.

 4월 16 19:19:38 localhost.localdomain systemd[1]: Unit jenkins.service entered failed state.

 4월 16 19:19:38 localhost.localdomain systemd[1]: jenkins.service failed.

에러메시지 대로 systemctl status jenkins.service는 확인해봅니다.

확인해보니 

 jenkins.service - LSB: Jenkins Automation Server

   Loaded: loaded (/etc/rc.d/init.d/jenkins; bad; vendor preset: disabled)

   Active: failed (Result: exit-code) since 월 2018-04-16 19:19:38 KST; 2min 32s ago

     Docs: man:systemd-sysv-generator(8)

  Process: 24668 ExecStart=/etc/rc.d/init.d/jenkins start (code=exited, status=1/FAILURE)

 4월 16 19:19:38 localhost.localdomain systemd[1]: Starting LSB: Jenkins Automation Server...

 4월 16 19:19:38 localhost.localdomain runuser[24673]: pam_unix(runuser:session): session opened for user jenkins by (uid=0)

 4월 16 19:19:38 localhost.localdomain jenkins[24668]: Starting Jenkins bash: /usr/bin/java: 그런 파일이나 디렉터리가 없습니다

 4월 16 19:19:38 localhost.localdomain jenkins[24668]: [실패]

 4월 16 19:19:38 localhost.localdomain systemd[1]: jenkins.service: control process exited, code=exited status=1

 4월 16 19:19:38 localhost.localdomain systemd[1]: Failed to start LSB: Jenkins Automation Server.

 4월 16 19:19:38 localhost.localdomain systemd[1]: Unit jenkins.service entered failed state.

 4월 16 19:19:38 localhost.localdomain systemd[1]: jenkins.service failed.

이부분이 눈에 들어옵니다. jenkins 스크립트가 제대로 실행이 되지 않는 것 같아서

jenkins 스크립트를 까봅니다. 

자바 홈이 잡혀 있지 않았습니다.

/usr/bin/java -> 나의 자바 홈으로 변경(/usr/java/jdk1.8.0_152/bin/java

// 자바 바이너리를 타겟으로 하셔야 합니다. 

** 성공 

7. 웹으로 접속 ip:8888

 Unlock Jenkins

같은 동일 PC에서 하신다면 localhost:8888 

// 위에 8888로 설정하였기 때문에 혹시 안된다면 8080으로 해보셔도 되고 재시작을 해보시고 8888로 하시면 됩니다. 위에서 설정만 하고 말았다면 적용이 안되어있을수 있음 

** 접속이 안되는 경우 방화벽 문제일 확률이 높으니 테스트용으로

systemctl stop firewalld  실행 후 접속 시 정상접속 확인 됩니다.

접속 후 해당 부분에 입력 하는 키는

cat /var/lib/jenkins/secrets/initialAdminPassword 에 있는 키를 입력 하면 됩니다.

** JENKINS_HOME ="var/lib/jenkins" // 5단계까지는 접속 해도 아무것도 없습니다.

8. Customize Jenkins

Install suggested plugins 설치 (기본 설치 이므로 원하지 않는다면 선택하지 않아도 됩니다.

[설치 중 화면]

9. Admin 계정 생성(Root)

// 해당 계정으로만 jenkins의 플러그인 설치 및 쉘 스크립트 작성이 가능하기 때문에 유의 바람

접속 화면

3장 이라고 뭔가 거창하게 말하지만 큰 의미는 없습니다. 그냥 카테고리를 나누고 싶었을 뿐

이번장에서는 앞에 설정한 것들을 가지고 간단하게 testlink 연동되는 점 확인 및

testLink 에서 가져올수 있는 파라미터들에 대해서 설명하고자 합니다.

현재 준비된 상태 :

testLink ( Test management Tool ) 

Jenkins ( CI Server)

testlink-plugin

junit-plugin

testLink Installation -> target testLink Install (현재 이 작업은 확인된건지는 파악이 안됩니다. 빌드를 가셔야 지 확인 가능)

우선 Jenkins 의 메인 페이지에서 

새로운 Item 을 선택합니다. 

** 해당 작업은 Jenkins의 admin 계정으로 하셔야 합니다.

그리고 item name을 입력하고 Freestyle Project를 선택후 OK를 누릅니다.

그리고 나타나는 메뉴들이 탭형식으로 되어있지만 결국은 하나의 페이지이며 탭으로 해당 페이지까지 스크롤되는 기능입니다.

순서대로 내려가지만

기본적으로 있는 탭 메뉴들입니다.

General 

소스코드 관리 

빌드 유발

빌드 환경

Build 

빌드 후 조치 

1장 에서는 Jenkins 자체에 testlink plugin 을 설치 하는 작업 까지 하였습니다.

2장에서는 해당 testlink plugin 을 통해서 현재 설치된 Jenkins 에 연동할 Target Testlink 를 설치 하는 작업과 간단한 실행순서 등을 보려고 합니다.

이미지는 생략하구

다시 

localhost:8888 ( 기존의 설정했던 포트번호 )

// ** 포트 번호 설정은 (Root 권한으로 하셔야 합니다.)

vi /etc/sysconfig/jenkins 로 들어가신후에 

JENKINS_PORT =" 요 부분   "  을 설정해주시면 됩니다.

ex: JENKINS_PORT="8888"

적용이 안될때는 다시 실행 하셔도 됩니다.

// ** 재시작  (Root 권한으로 하셔야 합니다.)

/etc/init.d/jenkins restart  

이제 메인 페이지 화면에서  

Jenkins 관리

시스템 설정 

TestLink  (Ctrl +F 로 찾아도 된다.)

찾고나면 옆에 추가 버튼이 있습니다.

추가 버튼을 누르게 되면 아래와 같은 화면이 나오게 됩니다. 하나씩 설명 하자면

보시면 Name과 Developer Key 에만 Mandatory Property (필수 속성) 이라고 되어있지만

사실은 URL도 필수 속성에 속합니다.

URL을 지정을 해둬야지 api 를 가져올수 있기 때문이죠.. 결론은 3개다 필수 속성입니다.

Name은 지정안하면 만들어주질 않기 때문에 

Name : 사용하는 TestLink 의 이름을 지정합니다 ( 실제 이름이 아닌 Jenkins 에서 사용할 이름)

예를 들어 testlink 를 2개 사용한다고 가정 하였을때 A는 테스트용 테스트링크고 B는 실제 사용 테스트링크 라고 하면 2개를 설치 후에

A의 Name은 - test testlink 

B의 Name은 - QA_Team_TestLink 식으로 이름을 지정해 놓아야  추후 빌드 할때 잘 골라서 사용할수 있습니다.

** 한글로 작성시에는

집사님(Jenkins) 께서 노하시기 때문에 영어로 작성을 하도록 합니다.

URL :  api 를 사용할수 있는 페이지 url을 지정 합니다.

// 보시게 되면 기본으로

http://localhost/testlink/lib/api/xmlrpc.php 라고 되어있는데

testlink 가 설치된 서버가 127.0.0.1 이라고가정할시에

http://127.0.0.1/testlink/lib/api/xmlrpc.php 라고 무턱대고 사용하면 연결이 되지않는다

** Port번호

http://127.0.0.1:8080/testlink/lib/api/xmlrpc.php 라고 무턱대고 사용하면 연결이 되지않는다

으로하여도 안될수가 있다. ! 왜냐면

testlink 버전 마다 xmlrpc.php 의 위치는 다르기 때문이다.

필자가 사용한 버전은 testlink - 1.9.16 버전이기 때문에 해당 버전에서 xmlrpc.php 의 위치는

http://ip주소:8080/testlink/lib/api/xmlrpc/v1/xmlrpc.php 위치한다. 위와 다른점은 

해당 부분이추가 되었다. 해당 블로그를 보다가 아 이제 Name부터 해볼까!

하고 작성하면 해당 에러가 뜰수 있다. (403) Jenkins의 로그인 Session 이끝났단 이야기 이니까 

그냥 다시 F5누르고 로그인 하시고 작업하시면 됩니다.

해당 403에러는 종종볼수 있습니다.

이제 남은 부분 개발자 도구 키 !

해당 키는 target Testlink 에서 생성하여서 받아 오셔야 합니다.

testlink 가 설치된 서버 혹은 주소로 접속 후 

해당 버튼을 누릅니다.

그리고 해당화면에서

해당 키를 생성하고 개인 API 접근 키 를 복사해서 Developer Key 에 입력 합니다.

Developer Key :

이렇게 설치까지 다 확인이 되었지만 Jenkins 에서 프로퍼티 끝에 보시면 아래와 같이 물음표 가 있습니다. 여기 물음표만 눌러서 진행하여도 웬만한 기능들 사용에는 많이 무리가 오진 않을것 같습니다.

눌르게되면 URL에 대해서 Usually it is http://host.port/testlink/lib/api/xmlrpc.php 라고 나옵니다.

예시를 하나 더 보여드리면

/var/lib/jenkins 에 대한 설명 도 나옵니다.  Jenkins 사용시에는 물음표부터 클릭해보면 알수 있습니다.

이번에는 testLink Installation 만 하였으며 다음에 빌드 에 대해서 작성 하겠습니다.

앞서 설정한대로 젠킨스의 설치가 끝났고 포트설정까지 되어있고 실행되어있는 상태 일시

ps aux | grep jenkins 라고 검색 하였을 시에

[tos@localhost _api_]$ ps aux | grep jenkins
jenkins   1772  0.1 16.3 4710916 612508 ?    
Ssl   1월15   3:07 /etc/alternatives/java -Dcom.sun.akuma.Daemon=daemonized -Djava.awt.headless=true 
-DJENKINS_HOME=/var/lib/jenkins -jar /usr/lib/jenkins/jenkins.war --logfile=/var/log/jenkins/jenkins.log
 --webroot=/var/cache/jenkins/war --daemon --httpPort=8888 --debug=5 --handlerCountMax=100 --handlerCountMaxIdle=20
[tos@localhost _api_]$

와 같이 동작중인 형태가 보여져야 현재 실행 됐다고 볼수 있다

이후 웹 브라우저를 킨후 (필자는 Chrome 63)

localhost:8888  로 접속 후 좌측 화면에 Jenkins 관리 버튼 을 누른다 

이후 나오는 창에서 플러그인 관리 클릭

누른후에 나오는 탭 중에서 "설치 가능" 탭을 눌러서 필요한 플러그인들을 설치 하여야 한다

여기서 설치 하여야 할 것들이 많이 나오기 때문에 Ctrl + F 로 직접 검색을 하여서 설치 하도록 한다.

testlink 연동을 위해서 설치 하여야할 플러그인

1. Testlink plugin (Current 3.12)

this plugin integrated, Jenkins and TestLink

2. Junit Plugin  // testLink exceution result , report etc use

3. JUnit Attachments Plugin (필자는 연동시에 사용하였지만 해당 플러그인은 필요 없어도 될것으로 보인다.)

젠킨스 tesltink 공식 매뉴얼

https://wiki.jenkins.io/display/JENKINS/TestLink+Plugin

해당 플러그인들을 좌측 check box에서 체크 한 후에 

맨 하단에서 "재시작 없이 설치하기 " 혹은 "지금 다운로드 하고 재시작 후 설치하기"

필자는 후자로 진행하였습니다. 큰 의미는 없습니다.

메인 페이지 -> Jenkins 관리 -> 시스템 설정 

에 들어가시게 되면

해당 부분이 보이실겁니다.  그렇다면 현재 Jenkins 에 testlink plugin , junit plugin 이 설치가 끝났습니다.

다음에는 해당 플러그인을 통해서 

Jenkins 자체에 target testlink 를 Install 하고 해당 테스트링크에 존재하는 테스트 계획 및 테스트 케이스를 찾아서 가져오는 작업 및 testlink-plugin 의 동작방식에 대해

작성하도록 하겠습니다.

젠킨스 젠킨스 IT 하는 사람들이라면 한번쯤 어디서든 들어봤을 법한 단어다

Jenkins(젠킨스),hudson(허드슨),git(깃),svn(에스브이엔) , 형상관리  

코드를 짜는 부분만이 개발자의 다라고 할수 없다.  물론 QA도 마찬가지다

테스트케이스를 만들고 결과 를 도출해내고 매번 같은 케이스를 수작업으로 확인하고 

Unit_Test를 작성한다고 하여도 매번 직접 확인하거나 매번 직접 실행하여야 하는 부분들이있다.

이런 경우에 테스트 중인 프로그램의 규모가 커지거나 하였을때는 어떻게 하겠는가 

그냥 꼴딱 밤을 샐것인가 ? 

너무 비효율적이다. IT하는사람이라면 컴퓨터를 노예 부리듯이 부릴 줄 아는것도 좋아보인다.

QA도 고도화된 개발자 만큼은 아니여도 어느정도 개발자 수준의 코드 퍼포먼스 정도는 낼줄알아야 한다. 젠킨스 든 git이든 개발자의 툴이다 아니다

QA도 사용하여야 할 툴이고 테스트가 진행될수록 프로그램이 커질수록 TestCase는 끝없이 방대해지며 이것들을 검증하는 스펙트럼은 QA의 역량에 따라 다르다 

높은 QA일수록 더 많은 스케일에 대한 테스트가 가능하다 이것들을 위해서 수동이 아닌 자동으로 되는 부분들에 대한 케이스를 CI를 통해서 통합하고 사용할수 있도록 하여야 한다.

자동화 테스트를 위한 젠킨스 사용은 필수이다

(다른 여러 방법이 있겠지만)

이것을 도와주기 위해서 오늘은 CI 툴인 Jenkins( 젠킨스) 에 대해서 조사한 내용과 설치 정도까지 할려고 한다. 

젠킨스 ?

흔히 검색하면 나오는 말이다. 지속적 통합 , CI 서버 CI ? (Continuous Integration) 라고 한다. 

대부분 개발자들은 개발된 코드를 지속적으로 통합하여 충돌 내용을 방지하기 위해서 사용한다고 한다.

최초에는 허드슨 프로젝트로 시작되었다. 

이로인해 어드민 페이지등은 허드슨과 매우 유사한 점이 많으며 허드슨 플러그인을 참고하여도 될정도이다.

공식 웹 사이트 : https://jenkins.io/ 

프로그래밍 언어 : Java 

최신 버전 : 금일자 기준으로 2017 년 8월 17일 자 버전인 (2.60.3)

 OS : Cross PlatForm

라이선스 : MIT 

종류 : 웹 어플리케이션

플러그인 :  400개 이상의 플러그인

(라이센스 관련 내용은 딸도 정리해서 올려놓았습니다.)

이외의 대표적인 젠킨스의 기능들

1. 저장소 통합 

2. 소스코드 체크아웃 이벤트 

3. 빌드 및 테스트 자동화

4. 테스트 보고서 생성

5. 실행결과 통보(이메일)

6. 산출물 저장

7. 배포

Install 

필자는 CentOS 계열을 사용하기 때문에 해당 젠킨스 설치도 CentOS 기준으로 6.0 7.0 으로 적도록 하겠습니다.

1. 설치 하기전 필수 사항 

JDK : 1.7 이상 ( 자바 프로그램이기 때문에 JDK 는 필수조건이다.)

2. 설치 (설치 방법은 홈페이지에서 파일을 받아도 되지만 CentOS에서는 명령어로 설치)

2-1 wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo

rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key

2-2 yum install jenkins

(설치가 끝납니다. ) 매우 간단

3. 기본 세팅 

3-1 이미 띄워놓은 여러 프로젝트들이 포트를 쓰고있어서 포트를 변경합니다.

기본 Default: 는 8080으로 되어있는데 해당 포트는 예약 포트이기 겹칠 확률이 있습니다.

3-2 vi /etc/sysconfig/jenkins

JENKINS_PORT  를 검색하면 찾을수있습니다. 

JENKINS_PORT="8888"  로 변경

etc

JENKINS_HOME = "var/lib/jenkins" 해당 사항은 알아 두어야 합니다. 

젠킨스에서 작업되는 워크스페이스 등에 대한 홈 위치 이기때문에 자주 접속하게 됩니다.

/etc/init.d/jenkins start  or /etc/init.d/jenkins restart 젠킨스 시작 및 재시작

// (루트 권한으로 시작 하여야합니다. sudo -s 혹은 su 

 4. 젠킨스 접속 

jenkins start 혹은 restart로 시작하였다면 웹 어플리케이션 답게 웹으로 접속하여야 합니다.

같은 동일 PC에서 하신다면 localhost:8888 

// 위에 8888로 설정하였기 때문에 혹시 안된다면 8080으로 해보셔도 되고 재시작을 해보시고 8888로 하시면 됩니다. 위에서 설정만 하고 말았다면 적용이 안되어있을수 있음 

5. Unlock Jenkins 

위의 4번에서 제킨스를 접속하게 되면

 Unlock Jenkins 라고 나오게 된다. 해당 부분에서

car /var/lib/jenkins/secrets/initialAdminPassword 하게되면 나오는 키를 입력해주면 된다.

6. Customize Jenkins

 Install suggested plugins 설치 ( 기본 설치 이므로 원하지 않는다면 선택 하지 않아도 된다.)

7 어드민 계정 생성

id: test

pw: test_QA

// 해당 admin 계정으로만 jenkins의 플러그인  + 쉘 스크립트 작성 등에 대한 설정이 가능하니 유의해서 만들기 바람