[Jenkins CI/CD] 1. GitHub Repository Clone하기

JoonYoung Maeng·2022년 4월 10일

Jenkins CI/CD

목록 보기

1/5

젠킨스를 이용해서 스프링 부트, 그래들 프로젝트를 자동으로 서버에 배포하기 위한 절차를 정리한다.

GitHub Repository 코드를 clone 하기
그래들 프로젝트를 빌드하기
빌드된 Jar 파일을 클라우드 서버로 전달
Develop 브랜치 PR 시 자동으로 배포 (WebHook 사용)
Jenkins Slack 연동

🪙 Credentials 세팅

Credential Plugin은 젠킨스가 각종 리소스에 접근하기 위한 키, 토큰 등을 저장하고 관리하는 플러그인이다.

젠킨스 서버를 이용해 CI/CD를 이용하기 위해서 GitHub Repository에 접근하기 위한 토큰을 관리한다.

젠킨스 대시보드에서 젠킨스 관리 > 시스템 설정으로 들어가서 스크롤을 내리다 보면 GitHub 탭이 있다.

Name 부분과 Credentials부분을 세팅한다.

Credentials 부분을 확인 해보면 GitHub Settings 에서 Personal access token을 생성해야 한다고 작성되어있다.

Access token을 발급 시에 추후 WebHook을 사용하기 위해 “admin:repo_hook”부분과 레포지토리가 private 레포지토리라면 “repo” 부분을 모두 체크해야 젠킨스가 해당 토큰을 가지고 레포지토리에 관련된 것들을 관리할 수있다고 되어있다.

Add 버튼을 클릭하면 아래와 같이 Credentials를 생성할 수 있는 팝업이 나타난다.

위에 설명을 보면 Crendentials를 Secret Text 형식으로 만들라고 되어있다.

Kind를 Secret Text로 바꿔주고, Secret은 GitHub Setting 에서 발급받은 access token을 복사해서 붙여넣는다. ID는 해당 설정을 구분할 수 있는 이름이므로 알아볼 수 있게 작성해준다.

Credentials를 생성했다면 Test Connection을 통해 제대로 연결되었는지 확인이 가능하다.

📌 Github Access Token 발급 받기

GitHub 오른쪽 상단 프로필을 클릭해 Settings > Developer Settings > Personal Access Tokens > Generate new token 으로 이동한다.

repo, admin:repo_hook 부분을 체크한 후 토큰을 생성한다.

Access Token 값은 생성 시에 한번만 보여주기 때문에 잃어버리지 않도록 잘 저장해둔다. 잃어버리면 다시 생성해야한다.

⛓ Pipeline 설정

젠킨스의 핵심 중 하나인 파이프라인은 젠킨스의 Job들을 순차적으로 실행시키거나 직접 작성한 스크립트를 이용해 Job을 연속적으로 실행시키는 기능이다.

파이프라인 기능을 이용해 젠킨스는 통합하고 구현을 지원하며 CD (Continuous Delivery)를 가능하게 해준다.

젠킨스 대시보드에서 “새로운 Item”을 클릭한다.

파이프라인 이름을 작성하고, Pipeline 기능을 선택한 후 OK를 클릭한다.

General 탭의 하단 부분에 Pipeline Script를 작성할 수 잇는 텍스트 박스에 공식문서에서 예시로 들고 있는 Declarative Pipeline 부분의 코드를 토대로 Pipeline Script를 만들어준 후 하단의 Pipeline Syntax를 클릭한다.

pipeline {
    agent any 
    stages {
        stage('GitHub Repository Clone') { 
            steps {
                
            }
        }
    }
}

Pipeline : 하나의 파이프라인을 의미한다.
Stages : stage들을 모아놓은 집합 블록이다.
stage : 전체 파이프라인을 통하여 수행되는 작업의 일부분으로 Build, Test, Deploy 등과 같이 하나의 작업에 대해 정의하는 블록이다.
steps : 하나의 작업을 의미한다. sh [command] 를 이용해 쉘 명령어를 이용해 실제 작업을 수행한다.