대표 사례 02 · 사내 솔루션 배포 시스템

귀찮은 솔루션 패키징 작업을 “클릭 몇 번”으로 바꿨습니다.

솔루션 버전과 실행 목적을 선택하면 빌드·전체 패키지·패치·테스트 배포 중 필요한 경로가 자동 실행됩니다.

문제 상황

고객사마다 다른 서버 환경

온프레미스로 납품하는 제품이라 고객사 서버의 실행 환경이 각각 고정돼 있고, 같은 소스라도 환경에 맞춰 다시 조립해야 했습니다.

기존 방식의 병목 고객사마다 다른 패키징 조합
고객사 A 패키징
NVIDIA H100 Ubuntu Ubuntu 22 A 라이브러리 모델 v1 솔루션 v1 MariaDB v10.6
고객사 B 패키징
NVIDIA L40S Red Hat Red Hat 8 B 라이브러리 모델 v2 솔루션 v2 MySQL v8.0
고객사 C
고객사 D
패키징 결과 불일치
같은 소스 버전도 작업자의 파일 선택에 따라 결과가 달라졌습니다.
누락·오선택 위험
필수 의존성을 빠뜨리거나 다른 환경의 파일을 포함할 수 있었습니다.
반복적인 시간·인력 소요
고객사마다 GPU·OS·라이브러리·모델 조합이 달라, 고객사 수만큼 수동 패키징 작업 N회가 필요했습니다.

해결 방안

고객사 환경의 프로필화

서로 다른 고객사 환경에 알맞는 의존성을 코드로 명세해두었습니다.
고객사별 서버 환경에 맞는 런타임 프로필을 선택하고, 파이프라인이 해당 의존성을 자동 구성하는 흐름
profiles.yaml 공개용 런타임 프로필 예시
schema_version: 1

profiles:
  hopper:
    tensorrt: "10.3.0.26"
    cuda: "12.4"
    opencv: "4.9.0"

GitLab CI/CD 연동

테스트 서버 배포부터 고객사 납품용 패키징 과정을 하나의 CI/CD 파이프라인에서 처리합니다.
GitLab CI/CD 실행 흐름
빌드 서버가 런타임 프로필에 맞춰 빌드와 전체 패키지 조립을 수행하고, GitLab Package Registry가 컨테이너 이미지와 라이브러리·모델·설정을 함께 보관하며, 테스트 서버는 이미지로 서비스를 교체하고 전달받은 패키지의 설치를 검증하는 구조
Registry는 컨테이너 이미지뿐 아니라 라이브러리·모델·설정까지 버전별로 보관해, 같은 버전을 언제든 다시 조립할 수 있습니다.

패키지 무결성 검증

조립 단계에서 산출물의 구성과 해시를 manifest에 기록하고, 설치 직전에 다시 계산해 대조합니다. 작업자가 눈으로 확인하던 “파일이 다 들어갔는지”를 파이프라인이 판정하게 만든 부분입니다.
manifest.json 조립 단계 · 구성과 해시 기록
{
  "solution_version": "1.4.2",
  "runtime_profile": "hopper",
  "built_from": "9f2c1ab",
  "sha256": {
    "lib/libinfer.so": "3b7c…9e1",
    "models/face_v2.engine": "a41d…07c",
    "config/runtime.yaml": "c05f…4b8"
  }
}
verify_manifest.py 설치 직전 · 재계산 후 대조
def verify(pkg: Path, profile: str) -> None:
    m = json.loads((pkg / "manifest.json").read_text())

    # 다른 환경용 패키지를 먼저 걸러낸다
    if m["runtime_profile"] != profile:
        raise Aborted(f"프로필 불일치: {m['runtime_profile']}")

    for path, expected in m["sha256"].items():
        target = pkg / path
        if not target.exists():
            raise Aborted(f"파일 누락: {path}")

        if sha256(target.read_bytes()).hexdigest() != expected:
            raise Aborted(f"체크섬 불일치: {path}")

구현 성과

작업자 투입 시간 약 95% 감소

고객사마다 파일을 직접 골라 조립하던 과정을, 프로필 선택과 결과 확인으로 줄인 기준입니다.

핵심 성과 약 95%

작업자 투입 시간 감소

오류 제거

패키징 오류 제거

프로필·manifest·체크섬 검증으로 의존성 누락과 다른 환경의 파일 선택을 방지했습니다.

대응 시간 ↓

고객사 업데이트 대응 단순화

변경분만 담은 패치 패키지를 자동 생성해 전체 파일을 다시 선별하는 작업을 없앴습니다.