게시 날짜 : 12 월 4, 2024

GitLab을 사용하여 CI/CD 파이프라인 구축

마샬 페인

GitLab CI/CD 설정

먼저 GitLab 계정과 GitLab 프로젝트가 있는지 확인하세요. 아직 프로젝트가 없다면 애플리케이션 프로젝트를 만드세요. 그런 다음 GitLab Runner를 포함하여 필요한 항목을 설정합니다. GitLab Runner는 .gitlab-ci.yml 파일에 있는 작업을 실행합니다.

GitLab CI/CD를 위한 필수 구성 요소

GitLab 계정 및 프로젝트: 활성화된 GitLab 계정이 있어야 합니다. 소스 코드와 CI/CD 설정을 보관할 프로젝트 저장소도 있으면 좋습니다.
서버 환경: 애플리케이션이 위치할 가상 사설 서버와 같은 서버 환경에 액세스할 수 있어야 합니다.
버전 관리 : Git과 같은 버전 관리 시스템을 사용하여 소스 코드를 관리하는 것은 매우 중요합니다. Git과 GitLab 저장소를 사용하면 변경 사항을 쉽게 추적하고, 팀과 협력하고, 필요 시 이전 버전으로 돌아갈 수 있습니다.

GitLab 프로젝트 생성

GitLab 대시보드로 가서 "새 프로젝트" 버튼을 클릭합니다.

프로젝트 이름과 설명을 입력하세요. 또한, 공개 또는 비공개 중 공개 수준을 선택하세요. 빈 프로젝트로 시작하거나 앱 유형에 맞는 템플릿을 사용할 수 있습니다.

그런 다음 "프로젝트 만들기"를 클릭하세요. 이제 새 코드를 저장할 새 프로젝트 저장소가 준비되었습니다.

GitLab Runner 설정

러너를 설정하려면 프로젝트의 "설정"으로 이동하여 "CI/CD"를 클릭하세요. 제공된 등록 토큰을 사용하여 "러너" 섹션에서 새 러너를 등록할 수 있습니다. Docker 또는 SSH 등 선택한 러너 유형에 맞는 단계를 따르세요. 러너를 등록하면 CI 파이프라인 작업을 실행할 수 있습니다.

GitLab CI/CD 파이프라인 이해

GitLab CI/CD를 시작하는 것은 쉽습니다. 먼저 GitLab 계정과 GitLab 프로젝트가 있는지 확인하세요. 아직 프로젝트가 없다면 애플리케이션 프로젝트를 만드세요.

그런 다음 GitLab Runner를 포함하여 필요한 항목을 설정합니다. Runner는 파이프라인 작업을 처리하기 때문에 중요합니다. .gitlab-ci.yml 파일에 있는 작업을 실행합니다. 이를 통해 코드가 원하는 방식으로 빌드, 테스트 및 배포되도록 할 수 있습니다.

파이프라인이란 무엇인가?

파이프라인은 자동화된 프로세스입니다 애플리케이션의 생성, 테스트 및 배포를 간소화합니다. "CI"는 개발자가 코드 변경 사항을 중앙 저장소에 자주 병합하는 지속적 통합을 의미합니다. "CD"는 애플리케이션을 의도한 환경에 자동으로 릴리스하는 지속적 배포 또는 지속적 전달을 의미합니다.

기본 파이프라인 구성

GitLab 대시보드로 이동하여 "새 프로젝트" 버튼을 클릭하세요. 프로젝트 이름과 설명을 입력하고, 공개 또는 비공개 중 공개 수준을 선택하세요. 빈 프로젝트로 시작하거나 템플릿을 사용할 수 있습니다. 모든 세부 정보를 입력했으면 "프로젝트 만들기"를 클릭하세요.

파이프라인 단계 및 작업

배포 프로세스를 명확한 단계와 작업으로 구분하면 체계적이고 세부적인 작업을 수행할 수 있습니다. 각 단계에는 특정 작업에 할당된 작업자(작업)가 있습니다. 이러한 설정은 코드 품질을 향상시키고 문제 해결을 용이하게 합니다.

.gitlab-ci.yml 쓰기

.gitlab-ci.yml 파일은 YAML로 작성되었습니다. 이 파일은 GitLab CI 및 CD 파이프라인의 주요 명령 센터 역할을 합니다. 이 파일은 CI/CD 워크플로의 단계, 작업, 종속성 및 설정을 정의합니다.

자동화된 빌드, 테스트 및 배포 프로세스 전체를 관리할 수 있습니다. 이제 .gitlab-ci.yml 파일의 구조와 주요 구성 요소를 살펴보겠습니다.

.gitlab-ci.yml의 구조

각 작업은 이름이 있으며 각 단계에 속합니다. 단계는 "빌드", "테스트", "배포"와 같이 파이프라인의 여러 단계를 의미합니다.

각 작업마다 실행에 필요한 명령과 종속성을 나열해야 합니다. 변수를 생성하고, 스크립트를 사용하고, 파이프라인 내 작업 간 데이터 공유를 지원하는 아티팩트를 포함할 수도 있습니다.

직업 정의

저장소의 기본 폴더에 있는 .gitlab-ci.yml 파일은 GitLab CI/CD 설정에 매우 중요합니다. 이 파일은 "빌드", "테스트", "배포"와 같은 단계를 정의하며, 여기서 단위 테스트나 코드 변경 시 애플리케이션 자동 실행과 같은 작업을 추가할 수 있습니다. AWS CodePipeline과 같은 유사한 도구를 사용하면 파이프라인을 효과적으로 관리할 수 있습니다.

변수 사용

변수에는 데이터베이스 비밀번호나 API 키처럼 환경에 따라 달라지는 설정이 포함될 수 있습니다. 또한 배포 시 변경될 수 있는 애플리케이션 설정도 변수에 포함될 수 있습니다. GitLab은 이러한 변수를 관리하는 여러 가지 방법을 제공합니다. .gitlab-ci.yml 파일에서 직접 설정하거나, GitLab UI를 사용하여 프로젝트 수준 변수를 관리하거나, 환경 변수를 사용하여 민감한 정보를 안전하게 처리할 수 있습니다.

고급 GitLab CI/CD 기능

GitLab은 소프트웨어 개발과 지속적인 배포에 도움이 되는 다양한 유용한 기능을 제공합니다.

파이프라인 아티팩트 관리

.gitlab-ci.yml 파일은 공백을 사용하여 명확한 구조로 CI/CD 파이프라인을 구성합니다. 각 작업은 이름이 지정되고 "빌드", "테스트", "배포"와 같은 단계에 속합니다. 원활한 데이터 공유를 위해 명령, 종속성, 설정, 변수, 스크립트 및 아티팩트를 포함합니다. 이러한 설정은 GitLab CI/CD 또는 Bitbucket 파이프라인과 같은 다른 오픈소스 CI 솔루션 전반의 워크플로우를 쉽게 이해하고 재사용하며 일관성을 유지할 수 있도록 합니다.

GitLab Cache 사용하기

파이프라인 트리거 및 일정

특정 이벤트가 파이프라인을 트리거하거나, 특정 시간에 파이프라인을 예약하여 중요한 기능을 효과적으로 수행할 수 있습니다. 또한 변수를 사용하면 여러 작업과 단계에서 재사용할 수 있는 값을 정의하여 기본 스크립트를 변경하지 않고도 자동화된 빌드 및 배포를 맞춤 설정할 수 있습니다.

다음은 작업을 구성하는 템플릿의 예입니다.

투기:
  입력 :
    단계:
      기본값: 빌드
      설명: '빌드 단계를 정의합니다'
    rust_버전:
      기본값: 최신
      설명: 'Rust 버전을 지정하고 https://hub.docker.com/_/rust/tags의 값을 사용합니다. 기본값은 최신입니다.'
--- 

"빌드-$[[ 입력.rust_버전 ]]":
  스테이지: $[[ inputs.stage ]]
  이미지: rust:$[[ inputs.rust_version ]]
  스크립트:
    - 카고 빌드 --verbose

의존성 관리

GitLab을 사용하면 작업의 종속성을 나열할 수 있습니다. 즉, 작업이 실행되기 전에 필요한 라이브러리, 패키지 또는 도구가 설치됩니다. JavaScript의 경우 npm, Python의 경우 pip, PHP의 경우 Composer와 같은 패키지 관리자를 사용하면 .gitlab-ci.yml 파일에서 프로젝트에 필요한 항목을 정의하고 관리할 수 있습니다.

Docker와 통합

Docker는 GitLab CI/CD 워크플로와 통합되어 안정적이고 반복 가능한 환경을 만듭니다.

Docker 이미지 빌드

.gitlab-ci.yml 파일에서 Docker 빌드 단계를 설정할 수 있습니다. 이 설정은 GitLab CI/CD가 자동화된 워크플로우 중에 이미지를 빌드하도록 합니다.

.gitlab-ci.yml에서 Docker 사용하기

GitLab CI/CD에는 Docker 컨테이너에서 작업을 실행할 수 있는 Docker 실행기가 있습니다.

애플리케이션의 필요에 맞는 특정 Docker 이미지를 선택할 수 있습니다. 이를 통해 각 작업에 대해 안정적이고 별도의 테스트 환경을 구축할 수 있습니다. 예를 들어, 앱에서 Node.js를 사용하는 경우 CI/CD 작업에 공식 Node.js Docker 이미지를 사용할 수 있습니다.

이 방법을 사용하면 로컬 설정과 CI/CD 환경 간의 차이로 인해 발생할 수 있는 문제를 줄일 수 있습니다. Docker는 안정성을 보장하고 문제 해결을 더 쉽게 만들어줍니다.

Docker 통합을 위한 모범 사례

Docker를 CI/CD 워크플로에 통합하는 데는 두 가지 주요 방법이 있습니다.

Docker 컨테이너에서 CI/CD 작업을 실행합니다. CI/CD 작업을 생성하여 애플리케이션 테스트, 빌드 또는 게시와 같은 작업을 수행할 수 있습니다. 이러한 작업은 Docker 컨테이너에서 실행될 수 있습니다.
Docker 또는 kaniko를 사용하여 Docker 이미지를 빌드합니다. CI/CD 작업을 생성하여 Docker 이미지를 빌드하고 컨테이너 레지스트리에 게시할 수 있습니다.

GitLab CI/CD의 보안

GitLab CI/CD는 비밀을 유지합니다 safe, 환경을 보호하고 특정 규칙을 따릅니다.

비밀 관리

GitLab에서는 프로젝트 수준 변수를 사용하여 비밀을 저장할 수 있습니다. 파이프라인의 특정 작업이나 단계에서는 이러한 변수가 유지됩니다. safe 필요할 때 접근할 수 있습니다.

보안 환경에서 작업 실행

GitLab Runner를 보호된 네트워크에서 작동하도록 설정하여 적합한 사용자 또는 시스템에만 접근 권한을 부여하세요. CI/CD 작업에 Docker 컨테이너를 사용할 수도 있습니다. 컨테이너는 가벼우며 별도의 환경을 생성합니다.

규정 준수 및 감사 로그

GitLab의 감사 로그는 작업 실행, 파이프라인 시작, 코드 변경, 사용자 작업 등의 이벤트를 기록합니다. 각 로그 항목에는 타임스탬프, 해당 작업을 수행한 사람 또는 작업 내용, 그리고 이벤트에 대한 세부 정보가 포함됩니다. GitLab은 공유 소스 코드 저장소 내에서 명확하고 추적 가능한 CI/CD 작업 이력을 유지할 수 있도록 지원합니다.

문제 해결 및 최적화

문제 해결 및 워크플로 최적화는 효과적인 CI/CD 프로세스를 유지하는 데 필수적입니다. 문제를 조기에 해결하고 스마트한 개선 방법을 활용하면 파이프라인이 원활하게 작동하고 고품질 소프트웨어를 꾸준히 제공할 수 있습니다.

일반적인 문제 및 수정 사항

GitLab을 사용하면 프로세스를 효과적으로 모니터링하고 기록하고, 데이터 유출을 감지하여 보안을 강화하고, 개선된 개발 방법을 구현하여 성능을 최적화할 수 있습니다.

모니터링 및 로깅

GitLab은 일정 기간 동안 로그를 저장하지만, 프로젝트 필요에 따라 보관 기간을 변경할 수 있습니다. 실패한 작업에 대한 알림을 설정하고, 빌드 시간을 모니터링하여 개발 프로세스에서 속도가 느린 부분을 파악하고, 배포 빈도를 확인할 수도 있습니다.

파이프라인 성능 최적화

파이프라인 성능을 최적화하는 데 사용되는 기술은 여러 가지가 있습니다.

캐싱 종속성이후 파이프라인 실행 중에 반복적인 다운로드를 방지하기 위해 다운로드한 종속성을 저장합니다.

최적화 기법	기술설명
캐싱 종속성	이후 파이프라인 실행 중에 반복적인 다운로드를 방지하기 위해 다운로드한 종속성을 저장합니다.
작업 병렬화	작업 간에 상호 종속성이 없는 경우 작업이 동시에 실행되도록 구성합니다.
더 빠른 주자 사용	까다로운 작업에는 처리 능력이나 메모리가 더 뛰어난 러너를 선택하세요.
테스트 모음 최적화	통합 테스트 내에서 느리게 실행되는 테스트를 식별하고 최적화하여 전체 실행 시간을 줄입니다.

실제 사용 사례

GitLab CI/CD는 매우 유연하여 다양한 실제 상황에 적합합니다. 간단한 웹사이트 제작부터 복잡한 마이크로서비스 설정 실행까지 모든 작업에 활용할 수 있습니다.

웹 애플리케이션을 위한 지속적인 통합

공유 저장소에 커밋될 때마다 애플리케이션을 빌드하도록 GitLab 파이프라인을 설정하세요. 단위 테스트, 통합 테스트, 엔드투엔드 테스트를 실행하고 코드 품질을 확인할 수 있습니다. 이러한 작업을 성공적으로 완료하면 파이프라인은 애플리케이션을 검토를 위해 스테이징 영역으로 자동 전송하거나 바로 프로덕션 환경으로 전환할 수 있습니다.

끊임없는 Deploy클라우드 공급자에 대한 조언

파이프라인에서 앱을 빌드하고 Docker 이미지와 같은 배포 가능한 항목으로 패키징하는 작업을 설정하세요. 그런 다음 선택한 클라우드 플랫폼(AWS, Google Cloud Platform, Azure 등)으로 전송할 수 있습니다.

테스트 파이프라인 자동화

.gitlab-ci.yml 파일을 사용하면 파이프라인의 다양한 테스트 단계를 간략하게 정의할 수 있습니다. 코드의 각 부분을 검사하는 단위 테스트, 앱의 여러 부분이 어떻게 연동되는지 확인하는 통합 테스트, 그리고 앱이 제대로 작동하는지 확인하기 위해 실제 사용자 동작을 모방하는 종단 간 테스트를 실행하도록 작업을 설정할 수 있습니다.

Digital.ai 및 GitLab: 자동화를 위한 협력

Digital.ai Release 및 GitLab 통합

Digital.ai 워크플로를 제공합니다, 인기 있는 도구와의 통합복잡한 환경에서 일관된 관행을 시행하고, 가시성을 유지하며, 대규모 애플리케이션을 원활하게 제공하기 위한 페르소나 기반 대시보드입니다.

Digital.ai Release GitLab과 통합 전달 워크플로와 프로세스를 실행하고 자동화와 효율성을 높이기 위해 커밋 및 풀 트리거를 사용합니다.

이상의 주제

이 게시물을 공유하기