GitLab CI/CD 시작하기

시작하기 전에 다음 사항을 확인합니다.

• CI/CD를 사용하려는 GitLab의 프로젝트
• 프로젝트에 대한 Maintainer 또는 Owner 액세스 권한

CI/CD 프로세스 개요

GitLab CI/CD를 사용하려면 :

1. Job을 실행할 수 있는 Runner가 있는지 확인합니다. 러너가 없는 경우 GitLab Runner를 설치하고 인스턴스, 프로젝트 또는 그룹에 대한 러너를 등록합니다.
2. .gitlab-ci.yml 파일을 리포지토리의 루트에 생성합니다. 이 파일은 CI/CD Job을 정의하는 곳입니다.

파일을 리포지토리에 커밋하면 러너가 Job을 실행합니다. Job 결과는 파이프라인에 표시됩니다.

Runner를 사용할 수 있는지 확인

GitLab에서 Runner는 CI/CD Job을 실행하는 에이전트입니다. GitLab 인스턴스의 모든 프로젝트에서 사용할 수 있는 공유 러너를 포함하여 프로젝트에 사용할 수 있는 러너가 이미 있을 수 있습니다.

사용 가능한 러너를 보려면 :

• Settings > CI/CD로 이동하여 Runners를 확장합니다.

활성 상태인 러너가 하나 이상 있고 그 옆에 녹색 원이 있으면, Job을 처리할 수 있는 러너가 있는 것입니다.

UI의 Runners 페이지에 러너가 나열되지 않으면, 사용자 또는 시스템 관리자가 GitLab Runner를 설치하고 하나 이상의 러너를 등록해야 합니다.

CI/CD를 테스트하는 경우, 로컬 컴퓨터에 GitLab Runner를 설치하고 러너를 등록할 수 있습니다. CI/CD Job이 실행되면 로컬 컴퓨터에서 실행됩니다.

.gitlab-ci.yml 파일 생성

.gitlab-ci.yml 파일은 GitLab CI/CD에 대한 특정 지침을 구성하는 YAML 파일입니다.

이 파일에서 다음을 정의합니다.

• 러너가 실행해야 하는 작업(Job)의 구조와 순서
• 특정 조건이 발생할 때 러너가 내려야 하는 결정

예를 들어, master를 제외한 브랜치에 커밋할 때 테스트 모음을 실행할 수 있습니다. master에 커밋하면 동일한 테스트 슈트(Test Suite)를 실행하고 애플리케이션도 게시하려고 합니다.

이 모든 것은 .gitlab-ci.yml 파일에 정의되어 있습니다.

.gitlab-ci.yml 파일을 생성하려면 :

1. Project overview > Details로 이동합니다.
2. 파일 목록 위에서, 커밋할 브랜치를 선택하고 플러스 아이콘을 클릭 한 다음 New file을 선택합니다.

3. 파일 이름으로 .gitlab-ci.yml을 입력하고 큰 창에서 다음 샘플 코드를 붙여 넣습니다.

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."

$GITLAB_USER_LOGIN 및 $CI_COMMIT_BRANCH는 Job이 실행될 때 채워지는 미리 정의된 변수입니다.

4. Commit changes 버튼을 클릭합니다.

커밋되면 파이프라인이 시작됩니다.

파이프라인 및 작업 상태 보기

변경 사항을 커밋하면 파이프라인이 시작되었습니다.

파이프라인을 보려면 :

• CI/CD > Pipelines로 이동합니다.
  세 단계(Stage)의 파이프라인이 표시되어야 합니다.

• 파이프라인의 시각적 표현을 보려면, 파이프라인 ID를 클릭합니다.

• Job의 세부 정보를 보려면, 작업 이름(예: deploy-prod)을 클릭합니다.

작업 상태가 stuck인 경우, 러너가 프로젝트에 대해 적절하게 구성되어 있는지 확인하십시오.

깃랩 문서 바로가기