빌드 (Build)

빌드(Build)는 소스 코드와 설정, 필요한 자산을 처리해 실행하거나 배포할 결과물을 만드는 과정입니다. 프로젝트에 따라 컴파일, 파일 묶기, 코드 변환, 자산 복사 같은 작업을 포함합니다. 빌드를 수행하는 명령과 결과물의 형태는 개발 도구가 정하며, 빌드 성공과 실제 서비스 배포 성공은 별도로 확인합니다.

소스에서 결과물로 이어지는 작업

웹 애플리케이션의 소스에는 여러 모듈과 스타일, 이미지가 흩어져 있을 수 있습니다. 빌드는 이 의존 관계를 따라 필요한 파일을 처리하고 브라우저나 서버가 사용할 형태로 만듭니다. webpack의 개념 문서는 진입점에서 의존 그래프를 구성한 뒤 필요한 모듈을 하나 이상의 번들로 묶는 과정을 설명합니다. 번들링은 빌드에 포함될 수 있는 작업 가운데 하나입니다.

컴파일은 코드를 다른 표현이나 실행 가능한 형태로 변환하는 작업입니다. 빌드는 이 작업과 함께 여러 파일을 연결하거나 환경별 설정을 반영하는 더 넓은 절차를 가리킬 수 있습니다. 프로젝트에 따라 컴파일 단계가 없거나 다른 도구가 변환을 맡기도 합니다. ‘빌드한다’는 말만으로 모든 소스가 하나의 기계어 실행 파일이 된다고 해석하지 않습니다.

개발 모드와 운영용 빌드는 목적이 다를 수 있습니다. 개발 중에는 빠른 갱신과 오류 위치 확인이 중요하고, 운영 결과물에서는 전송량과 실행 효율을 위한 최적화가 적용될 수 있습니다. webpack도 모드에 따라 최적화 구성을 달리하는 방식을 제공합니다. 개발 서버에서 화면이 열린다는 사실만 확인하면 운영용 결과물을 만드는 과정에서만 드러나는 오류를 놓칠 수 있습니다.

프로젝트가 정의한 빌드 명령

npm의 스크립트 문서는 package.json의 scripts에 명령을 정의하고 npm run으로 실행하는 방식을 설명합니다. npm run build가 무엇을 하는지는 해당 프로젝트의 build 스크립트가 정합니다. 같은 명령 이름을 쓰더라도 어떤 프로젝트는 코드만 변환하고, 다른 프로젝트는 검사나 파일 생성 같은 추가 절차를 함께 수행할 수 있습니다.

스크립트 이름만으로 테스트 실행 여부가 정해지지는 않습니다. 테스트가 빌드에 연결돼 있을 때도 있지만 별도 명령인 프로젝트도 있습니다. 빌드 로그와 스크립트 정의를 읽으면 어떤 단계가 실행됐고 어디에서 멈췄는지 구분됩니다. AI 코딩 도구가 ‘빌드 통과’라고 보고했다면 실제 실행 명령과 종료 결과를 함께 남겨 검증 범위를 확인할 수 있게 합니다.

같은 프로젝트에서도 의존성 버전과 도구 버전, 환경 설정이 다르면 결과가 달라질 수 있습니다. 소스만 복사하고 필요한 설정을 빠뜨리면 이전에 성공했던 명령이 새 환경에서 실패하기도 합니다. 문제를 재현할 때는 어느 커밋에서 어떤 런타임과 의존성을 사용했는지 기록합니다. 로그에 나온 첫 원인과 뒤따른 연쇄 오류를 구분하면 수정할 지점을 좁히기 쉽습니다.

결과물과 배포 상태의 구분

CMake 명령 문서는 소스 트리와 빌드 트리를 나누어 설명합니다. 소스 트리는 원본 파일이 있는 위치이고, 빌드 트리는 빌드 시스템 파일과 결과물이 만들어지는 위치입니다. cmake --build는 준비된 빌드 트리에서 빌드를 수행하는 명령입니다. 사용한 도구의 출력 위치를 확인하면 원본 코드와 다시 생성할 수 있는 파일을 구별할 수 있습니다.

빌드가 끝나도 결과물이 사용자에게 제공되는 서버로 옮겨졌는지, 올바른 환경 설정으로 실행되는지는 별도의 문제입니다. 배포 자동화가 빌드를 이어서 호출할 수는 있지만, 각 단계의 실패 원인은 다릅니다. 파일 생성은 성공했는데 업로드나 실행 시작이 실패할 수도 있습니다. 작업 기록에는 빌드 완료와 배포 완료를 각각 남겨 실제 서비스 상태를 과장하지 않습니다.

최종 확인에서는 의도한 결과물이 생성됐는지와 그 결과물로 주요 기능이 동작하는지를 봅니다. 이전 빌드의 파일이 남아 있거나 다른 출력 폴더를 배포하면 새 코드를 수정했어도 사용자에게는 옛 동작이 보일 수 있습니다. 빌드 대상 커밋과 배포한 산출물을 연결해 두면 이 차이를 추적하기 쉽습니다. 원본과 의존성만으로 복구할 수 없는 추가 자산이 있다면 그것도 별도로 보관합니다.