Bitbucket Self Hosted Runner(Window) Guide

Bitbucket Self Hosted Runner(Window) Guide

2021년 하반기부터 Bitbucket 에서 공식적으로 Pipe Line 에서 Runner를 지원하기 시작하였습니다. 더불어 로컬 PC에서도 돌아갈 수 있는 Self Hosted Runner도 지원하였습니다.
관련 링크 : https://bitbucket.org/blog/pipelines-runners

Bitbucket Self Hosted Runner 란?

Bitbucket은 Pipeline 을 통한 CI/CD를 지원합니다.
Pipelien 스크립트를 통해서 빌드 및 다양한 배포 환경을 구성 할 수 있습니다. 다만 우리의 PC 자원을 사용하는 것이 아닌 Bitbucket의 자원을 사용하는 것인 만큼 돈이 필요합니다.... ㅜㅜ

물론 간단한 빌드일 경우에는 무료로도 충분히 사용이 가능해 보이지만 몇시간씩 돌아가야 할 빌드에서는 돈을 내야만 한다.
이럴때 필요한 것이 Self Hosted Runner 이다.
Self Hosted Runner는 Bitbucket 서버에서 진행하는 것이 아닌 내 Local PC 에서 빌드를 진행한다.
그래서 내 Local PC 만 살아있다면 얼마든지 자유롭게 사용할 수 있는 Build Runner인 것이다.

Self Hosted Runner 사용법

Bitbucket 에서는 두가지 Repository, Workspace Runner 두가지를 제공한다. 말 그대대로 Repository 에서 작동하게 할 것인지 Workspace에서 작동하게 할 것인지를 결정한다. 여기에서는 Repository Runner를 기준으로 진행하도록 하겠다.

1. 먼저 Runner를 만들 Repository Setting - Pipeline - Runner 으로 이동해 준다.
2. ![image](https://user-images.githubusercontent.com/84961864/176809601-cffccb77-58fe-4dc2-9aef-b45fcb58e861.png)
3. Pipeline을 활성화 시켜준다. (이미 파이프라인이 만들어진 상황이라면 건너 뛰어도 된다. )
4. 활성화 시켜준 뒤에 다시 1번의 경로로 이동하면 다음과 같은 화면이 나온다.Add Runner 를 클릭하여 Runner를 추가해 준다.
5. ![image](https://user-images.githubusercontent.com/84961864/176810320-08fd6480-1c12-473a-a704-1c9c935cadd1.png)
6. 우리는 Window 기반의 Runner를 원하기 때문에 Window를 선택해 준다.Runner의 이름을 입력해 주고 다음을 눌러준다.
7. ![image](https://user-images.githubusercontent.com/84961864/176810450-64a89feb-78c0-4907-abb8-0aafdd6b07ea.png)
8. 다음과 같은 화면이 나오는데 위에서부터 순서대로 복사 한 다음에 내가 Runner를 설치하고자 하는 PC에 차례대로
   진행해 주면 된다. 마직막에 낙서가 되어있는 문장은 꼭 어딘가에 저장해 두길 바란다. 다시 찾고자 하면 상당히 귀찮아 질 것이다.이 과정에서 필요한 사항은 다음과 같다.(필수적으로 준비가 되어 있어야 한다. )
   • OpenJDK 11 (11.0.15 or newer)
   • Git
   • PowerShell 5.0+
9. ![image](https://user-images.githubusercontent.com/84961864/176810886-ef222440-7d9d-46bf-a420-00e7405aab35.png)
10. Self Hosted Runner의 세팅을 다 마치고 다음을 눌렀다면 다음과 같은 화면이 보일 것이다.5 번째 라인부터 있는 내용을 여러분의 Pipeline.yml 에 작성한 뒤 Self Hosted Runner의 PC에서 동작할
    Script를 작성하면 된다.
11. ![image](https://user-images.githubusercontent.com/84961864/176811456-1058364d-b8d3-4ab2-add9-cee6e8e8102d.png)

작성 예시

image: atlassian/default-image:3

pipelines:
  pull-requests:
    '**': #this runs as default for any branch not elsewhere defined
      - step:
          name: Step 1 
          script:
            - echo "그저 풀리퀘가 형성되었습니다." 
    feature/*: #any branch with a feature prefix
      - step:
          script:
            - echo "featue에서 풀리퀘가 형성되었습니다." 
  branches:
    master:
      - step:
          script:
            - echo "This script runs only on commit to the main branch."
      - step:
          name: Step 1
          runs-on: 
            - 'self.hosted'
            - 'windows'
          script:
            - echo "This step will run on a self hosted runner.";

  custom:
    customPipelineWithRunnerStep:
      - step:
          name: Step 1
          runs-on: 
            - 'self.hosted'
            - 'windows'
          script:
            - echo "This step will run on a self hosted runner.";
      - step:
          name: Step 2
          script:
            - echo "This step will run on Atlassian's infrastructure as usual.";

이 Guide를 잘 따라왔다면 여러분은 이제 Bitbucket Self Hosteed Server를 사용하여 여러분의 PC 로 CI/CD 환경을 구축할 수 있을 것이다.

[ 참고 자료 ]

• https://support.atlassian.com/bitbucket-cloud/docs/runners/
• https://support.atlassian.com/bitbucket-cloud/docs/adding-a-new-runner-in-bitbucket/
• https://support.atlassian.com/bitbucket-cloud/docs/set-up-runners-for-windows/
• https://bitbucket.org/blog/pipelines-runners