GitLab CI/CD

 ☑️ 시작 전에 확인할 사항

---

https://gitlab.com/

The One DevOps Platform | GitLab

 

 

• 프로젝트 확인 : CI/CD를 사용하기 위한 GitLab 프로젝트
• 권한 확인 : 프로젝트 소유자 또는 관리자 권한 부여된 계정
  • Owner : 그룹/프로젝트 생성자
    • 모든 권한
    • 그룹에서 추가적으로 구성원에게 부여 가능
  • Maintainer : 관리자
    • 업무 배정/병합 요청 승인
    • 그룹과 프로젝트의 수정과 삭제, 그룹 회원관리 등의 기능을 제외한 모든 권한

 

📎 CI/CD 프로세스 개요

---

• runner가 있는지 확인합니다.
  • GitLab SaaS를 사용할 경우, 별도 설치는 필요하지 않습니다.
  • 러너가 없는 경우의 사용 방법은 링크연결을 해두겠습니다.
    • install GitLab Runner
    • register a runner
• .gitlab-ci.yml 파일을 생성합니다.
  • 저장소 root에 생성합니다.
  • CI/CD 작업을 정의하는 파일입니다.

파일을 저장소에 커밋하면 러너가 작업을 실행합니다. 작업 결과는 파이프라인에 노출됩니다.

 

📎 기존 CI/CD 툴을 마이그레이션 하기

---

• Migrate from CircleCI.
• Migrate from Jenkins.

 

🦊 GitLab SaaS 환경에서 시작하기

---

CII/CD 환경을 아래 세 단계를 통해 구축할 수 있습니다.

1. runners 활성화하기
2. yml 파일 생성
3. 파이프라인 상태 보기

 

사용가능한 runner 확인하기

1. 좌측 메뉴에서 Settings > CI/CD 탭으로 이동합니다.
2. 러너 활성화되어있는지 확인하기

 

.gitlab-ci.yml 파일 생성

1. 루트에 신규 파일을 생성합니다.

2. 작성 후 저장하여 파일을 교체합니다.

build-job:
  stage: build
  script:
    - echo "Hello, $GITLAB_USER_LOGIN!"

test-job1:
  stage: test
  script:
    - echo "This job tests something"

test-job2:
  stage: test
  script:
    - echo "This job tests something, but takes more time than test-job1."
    - echo "After the echo commands complete, it runs the sleep command for 20 seconds"
    - echo "which simulates a test that runs 20 seconds longer than test-job1"
    - sleep 20

deploy-prod:
  stage: deploy
  script:
    - echo "This job deploys something from the $CI_COMMIT_BRANCH branch."
  environment: production

 

파이프라인 상태 보기

각 단계별로 실행이 성공적으로 완료됨을 확인할 수 있습니다.

각각 job의 로그를 확인할 수 있습니다.

 

🦊 GitLab Runner 설치하기

---

macOS 기준으로 작성하였습니다. Windows에서 설치는 여기서 확인하시고 진행하시면 됩니다.

설치 방법은 두 가지로 수동 설치 방법과 Homebrew를 이용한 설치 방법이 있습니다. gitLab에서 권장하고 있는 수동 설치 방법으로 진행해보겠습니다.

• 해당하는 칩에 맞춰 다운로드를 합니다.
  • For Intel-based systems:
  • sudo curl --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64"
  • For Apple Silicon-based systems:
  • sudo curl --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-arm64"
• 실행 권한을 부여합니다.

  • sudo chmod +x /usr/local/bin/gitlab-runner

• 러너를 등록합니다. (macOS 기준)

  • gitlab-runner register

• 사용자 변경 후 설치와 실행을 합니다.

  • su - <username>

  • cd ~
    gitlab-runner install
    gitlab-runner start

 

[참고 자료]

https://docs.gitlab.com/ee/ci/quick_start/

Get started with GitLab CI/CD | GitLab