Junhyunny's Devlogs

글 검색

기술 글 제목, 본문, 카테고리에서 검색합니다.
    이전 화면으로

    젠킨스(Jenkins) 설치

    CI/CD 파이프라인 구축을 위해 맥북에 젠킨스를 설치하고 초기 설정한 뒤, ngrok 터널링으로 외부에서 대시보드에 접속하는 과정을 정리했다.

    강준현
    • information
    • jenkins
    이 글의 목차

    0. 들어가면서

    Extream Programming(XP) 책은 지속적인 통합(CI, Continuous Integration), 지속적인 전달(CD, Continuous Delivery), 테스트 주도 개발(TDD, Test Driven Development)을 강조한다.

    이터레이션(iteration)마다 쌓이는 기능과 테스트를 개발자가 일일이 통합 > 빌드 > 테스트 > 배포한다면 피로도가 높아진다. 시간을 절약하고 개발자의 피로도를 낮추려면 CI/CD 파이프라인을 구축해야 한다.

    마침 지난 프로젝트에서 CI/CD 환경이 필요하다는 피드백을 받은 팀원이 이번 프로젝트에서 먼저 구축해 보자고 제안했다. 좋은 의견이었기에 여러 아이디어를 주고받다가 많은 곳에서 사랑받는 젠킨스(Jenkins)를 사용하기로 했다. CI/CD 환경 구축에 필요한 몇 가지 작업을 주제로 글을 쓸 예정이며, 첫 주제로 젠킨스 설치 방법을 정리했다.

    1. 개발 및 테스트 환경

    여러 가지 이유로 개발용 CI/CD 환경을 구축하는 데 어려움을 겪었다. 특히 젠킨스를 올릴 호스팅(hosting) 서버가 없었는데, 다행히 회사에 남는 맥북을 지원받았다. 처음엔 도커 이미지로 젠킨스를 설치했지만, 맥북 자원을 모두 사용하는 편이 좋겠다고 판단해 로컬에 설치했다. 개발용 CI/CD 환경은 다음과 같다.

    • 젠킨스 서버는 ngrok을 사용해 로컬 서버를 외부 인터넷에 노출했다.
    • 테스트용 애플리케이션은 AWS 프리티어(freetier) EC2에 배포했다.

    2. 젠킨스 설치 및 실행

    맥에서는 brew 명령어로 젠킨스를 쉽게 설치할 수 있다. 다음 명령어를 실행한다.

    $ brew install jenkins

    다음 명령어로 젠킨스를 실행한다.

    $ brew services start jenkins

    다음 명령어로 젠킨스를 종료할 수 있다.

    $ brew services stop jenkins

    다음 명령어로 젠킨스를 재시작할 수 있다.

    $ brew services restart jenkins

    브라우저에서 http://localhost:8080에 접속하면 젠킨스 대시보드를 볼 수 있다.

    처음 대시보드에 들어가면 비밀번호를 입력해야 한다. 화면은 /Users/junhyunk/.jenkins/secrets/initialAdminPassword 파일에 초기 비밀번호가 있다고 안내한다. 경로는 설치한 사용자마다 다르니 자신의 화면에 보이는 경로를 확인한다.

    다음 명령어로 얻은 비밀번호로 로그인한다.

    $ cat /Users/junhyunk/.jenkins/secrets/initialAdminPassword

    로그인한 뒤 젠킨스가 추천하는 플러그인(plugin)을 설치했다.

    다음으로 젠킨스 관리자 정보를 설정한다. 이후에도 몇 가지 절차가 있었지만, 따로 수정하지 않고 기본값을 사용했다.

    모든 설정을 마치면 다음과 같은 젠킨스 대시보드 화면을 볼 수 있다.

    3. ngrok 터널링(tunneling)

    로컬 호스트뿐 아니라 외부에서도 젠킨스 대시보드를 확인해야 했기 때문에 ngrok을 사용했다. ngrok은 외부에서 인터넷을 통해 로컬 서비스에 접근할 수 있도록 터널링(tunneling)을 수행하는 애플리케이션이다.

    ngrok allows you to expose a web server running on your local machine to the internet. Just tell ngrok what port your web server is listening on.

    ngrok도 brew 명령어로 설치할 수 있다.

    $ brew install --cask ngrok

    다음 명령어를 실행하면 외부에서 8080 포트로 들어온 요청을 localhost:8080 서버로 연결한다.

    $ ngrok http 8080

    ngrok 터널링 세션은 2시간 동안 유효하다. 로그인해서 발급받은 토큰으로 인증하면 세션이 만료되지 않는다. Free Plan에서는 ngrok 클라이언트를 동시에 1개만 사용할 수 있다.

    ngrok이 만든 도메인으로 접속하면 앞에서 구축한 젠킨스 대시보드 화면을 볼 수 있다.

    KEEP READING

    DISCUSSION

    댓글