배포 / 클라우드
빌드(Build)
작성한 코드를 실행하거나 배포할 수 있는 결과물로 만드는 과정입니다.
쉬운 설명
AI로 만든 웹사이트가 내 컴퓨터에서는 잘 열리는데, 공유하려니 “먼저 빌드해 주세요”라는 안내가 나올 수 있어요. 빌드는 작성한 코드를 실제 서비스에 사용할 파일 등으로 만드는 과정이에요. 프로젝트에 따라 여러 파일을 묶거나 코드를 변환하는 작업을 해요. 빌드가 끝났다는 것은 결과물을 만들었다는 뜻이며, 다른 사람이 접속할 수 있게 공개됐다는 뜻은 아니에요.
이런 상황에서 만나요
배포 전 점검을 하거나, 배포 서비스에서 Build failed라는 실패 메시지를 볼 때 만납니다.
“배포하기 전에 빌드부터 확인해 주세요”
만든 웹사이트를 공유하기 전에 결과물을 만드는 상황
$ npm run build├─ index.html
└─ assets/
├─ app.js
└─ app.css- 1프로젝트에 등록된 build 작업을 실행합니다.
- 2dist는 이 예시에서 결과물을 저장하는 폴더입니다.
- 3빌드 완료 뒤에 배포와 실제 기능 확인이 남습니다.
스터디 발표 전에 AI에게 “이 프로젝트의 빌드 방법을 확인하고 실행 결과를 알려 줘”라고 요청할 수 있습니다. 실패하면 마지막의 실패 문구만 보지 말고 그 앞에 나온 파일 이름과 구체적인 오류를 확인합니다.
헷갈리기 쉬운 점
빌드가 성공하면 배포도 끝난 건가요?
아니요. 빌드는 결과물을 만드는 단계입니다. 배포 서비스가 빌드와 배포를 연달아 처리할 수는 있지만, 빌드 성공만으로 공유할 사이트가 열렸다고 판단하지는 않습니다.
빌드 성공이 모든 기능의 정상 동작을 보장하지는 않습니다. 결과물을 실행하거나 배포한 뒤 로그인, 저장 등 핵심 기능을 별도로 확인합니다.
왜 알아야 할까요?
빌드 단계에서 실패했는지 구분하면 사이트 주소나 공유 설정을 바꾸기 전에 코드와 빌드 로그부터 확인할 수 있습니다.
조금 더 자세히
웹 프로젝트에서는 개발할 때 작성한 코드를 브라우저나 서버가 사용할 형태로 변환합니다. 결과물의 종류와 저장 위치는 도구마다 다릅니다. 예를 들어 Vite의 기본 설정으로 정적 웹사이트를 빌드하면 dist 폴더에 결과물이 만들어집니다.
npm run build는 프로젝트의 package.json에 등록된 build 작업을 실행합니다. 빌드에 타입 검사나 테스트까지 포함하는지는 프로젝트 설정에 달려 있습니다. 개발 서버에서 화면이 열렸어도 빌드에 필요한 파일이나 설정이 빠져 있으면 이 단계에서 실패할 수 있습니다.
직접 사용할 때 확인해 보세요
- 프로젝트에 등록된 빌드 명령을 확인한다
- 실패하면 구체적인 오류가 시작되는 부분을 읽는다
- 성공 후에도 실행 결과와 핵심 기능을 확인한다
관계 지도
