배포 (Deployment)
배포는 만든 프로그램을 사용할 환경에 설치하거나 반영하는 과정입니다. 웹에서는 서버나 호스팅에 올려 접속하게 하며 공개 범위와 운영 여부는 별도로 설정합니다.
같은 말:디플로이Deployment호스팅Hosting배포하기도메인 연결셀프호스팅Self-hostingDNS 레코드
🤔 localhost 주소를 보냈는데 열리지 않을 때
내 컴퓨터에서 localhost:3000으로 열리는 앱 주소를 친구에게 보냈다고 해 봅니다. 친구의 브라우저에서 localhost는 친구 자신의 컴퓨터를 가리킵니다. 여러분의 앱으로 연결되는 주소가 아닙니다.
다른 사람이 이용하게 하려면 접근 가능한 환경과 주소를 마련해야 합니다. 배포(Deployment)는 프로그램을 사용할 환경에 설치하거나 반영하는 과정입니다. 인터넷 공개 사이트뿐 아니라 접근이 제한된 사내 환경이나 시험 환경에도 배포할 수 있습니다.
🏠 개발과 미리보기 및 운영
| 환경 | 주된 목적 | 확인할 점 |
|---|---|---|
| 개발 | 내 컴퓨터에서 코드를 고치고 확인 | 실행 위치와 개발 데이터 |
| 미리보기 또는 시험 | 변경을 적용해 검토 | 접근 권한과 시험용 데이터 |
| 운영 | 실제 이용자에게 서비스 제공 | 승인한 버전과 실제 기능 및 운영 데이터 |
호스팅은 앱이나 파일을 제공할 서버 환경을 운영하는 일입니다. 빌드는 소스 코드를 배포 가능한 결과물로 만드는 과정입니다. 빌드 성공은 화면과 기능이 모두 올바르다는 뜻은 아닙니다. 호스팅에 올렸다고 장애 없이 24시간 작동하는 것이 보장되지도 않습니다.
🚀 어디에 배포할지 정하기
Vercel이나 Netlify 같은 서비스는 Git 저장소와 연결해 웹 프로젝트를 배포하는 기능을 제공합니다. 정적 파일만 제공하는지, 서버 코드와 데이터베이스가 필요한지에 따라 요구 환경이 다릅니다. 기존 프로젝트가 사용하는 서비스와 실행 조건을 먼저 확인합니다.
무료라고 표시돼 있어도 허용 용도, 사용량과 초과 비용은 따로 확인합니다. 이 수업의 첫 연습에는 가입이나 결제가 필요하지 않습니다. 실제로 배포할 때 고른 배포 서비스의 현재 요금과 제한을 확인합니다.
📝 자동 배포가 시작되는 조건
Git 저장소 연동이 설정된 경우 지정 브랜치의 변경을 감지해 배포가 시작될 수 있습니다. 푸시는 로컬 커밋을 원격 저장소에 보내는 동작이며 자동 배포 설정이 없으면 푸시만으로 사이트가 갱신되지는 않습니다.
변경 확인 → 원격 저장소의 대상 브랜치로 전송 → 빌드 → 미리보기 확인 → 운영 반영 및 확인위 흐름은 이해를 돕기 위해 단계를 줄여 적은 예입니다. 실제 프로젝트에서 어떤 단계가 자동인지, 어떤 브랜치가 운영 주소를 바꾸는지 확인합니다. CI는 변경을 통합하며 자동 검사하는 과정이고 CD는 배포 준비나 반영을 자동화하는 과정입니다. 자동 배포 하나만으로 테스트까지 갖췄다고 판단하지 않습니다.
Vercel의 Preview(미리보기)와 Production(운영)은 환경과 변수 설정이 구분됩니다. 새 프로젝트의 첫 배포처럼 예외가 있으므로 브랜치 이름만 믿지 말고 실제 표시된 대상 환경을 확인합니다. 미리보기라는 이름도 접근 제한을 보장하지는 않습니다.
변경을 보낸 뒤 배포 상태와 실제 서비스 결과를 확인합니다. 접근 범위는 별도 설정입니다.
🌐 도메인(Domain) 뜻과 배포 서비스에 연결하는 방법
도메인(Domain)은 숫자로 된 IP 주소 대신 사람이 읽고 기억할 수 있게 붙인 인터넷 주소입니다. 인터넷에 연결된 컴퓨터는 서로를 192.0.2.10 같은 IP 주소로 찾습니다. 브라우저에 example.com 같은 도메인을 입력하면 DNS(Domain Name System)가 그 도메인에 연결된 서버 주소를 알려 주고, 브라우저는 그 서버에 접속합니다.
도메인을 집 주소에, 서버를 실제 집 건물에 빗대면 DNS는 주소를 보고 건물의 위치를 알려 주는 지도 앱에 해당합니다. 서버를 다른 곳으로 옮겨도 DNS에 적은 연결 값만 바꾸면 방문자는 같은 도메인으로 새 서버에 접속합니다.
배포 서비스가 제공한 기본 주소(Vercel이라면 프로젝트이름.vercel.app 형태)로 공유를 마칠 수 있다면 처음부터 도메인을 살 필요는 없습니다. 브랜드 이름이 들어간 주소가 필요해지면 도메인 등록 업체(Registrar)에서 도메인을 기간을 정해 등록합니다. 결제 전에 원하는 이름을 쓸 수 있는지와 첫 등록 비용, 갱신 비용, 등록 기간을 확인합니다. 등록 기간이 끝나기 전에 갱신해야 같은 주소를 계속 쓸 수 있습니다.
DNS 레코드의 종류
도메인으로 들어온 방문자를 어느 서버로 보낼지 적는 설정 한 줄을 DNS 레코드라고 부릅니다. 자주 만나는 레코드는 네 가지입니다.
| 레코드 | 하는 일 | 예시 |
|---|---|---|
| A | 도메인을 IP 주소에 연결합니다 | example.com → 192.0.2.10 |
| CNAME | 도메인을 다른 도메인 이름에 연결합니다 | www.example.com → project.example.net |
| TXT | 도메인 소유 확인이나 메일 인증에 쓰는 글자 값을 담습니다 | 소유 확인 값 |
| MX | 그 도메인으로 오는 메일을 받을 메일 서버를 지정합니다 | example.com → mail.example.net |
표의 도메인과 IP는 문서용 예시 값이므로 실제 설정에 복사하지 않습니다. 웹사이트를 배포 서비스에 연결할 때는 주로 A 레코드와 CNAME을 쓰고, MX와 TXT는 메일과 소유 확인에 쓰이므로 사이트를 연결하면서 지우지 않습니다.
Vercel에 도메인 연결하기
Vercel에서는 프로젝트를 고른 뒤 Settings > Domains 화면에서 Add Domain 버튼을 눌러 도메인을 입력합니다. 그러면 Vercel이 그 도메인에 넣을 레코드 종류와 값을 보여 줍니다. example.com 같은 루트 도메인(apex domain)은 A 레코드로, www.example.com이나 docs.example.com 같은 하위 도메인은 CNAME 레코드로 연결하도록 안내합니다.
76.76.21.21은 Vercel이 루트 도메인의 A 레코드 값으로 안내해 온 IP 주소입니다. Vercel 안내 문서는 대부분의 프로젝트가 이 값을 쓰지만 새 프로젝트는 다른 IP를 받을 수 있으므로 프로젝트의 도메인 화면에 표시된 값을 쓰라고 안내합니다. 하위 도메인용 CNAME 값도 프로젝트마다 다릅니다. 그래서 다른 글이나 다른 프로젝트에서 본 값을 옮겨 적지 않고, 내 프로젝트의 Domains 화면에 표시된 값을 그대로 씁니다.
레코드 값은 도메인을 산 등록 업체가 아니라, 지금 그 도메인의 DNS를 관리하는 업체의 관리 화면에 입력합니다. 도메인의 DNS 응답을 맡는 서버를 네임서버라고 부르며, 등록 업체와 DNS 관리 업체가 다를 수 있으므로 현재 네임서버가 가리키는 DNS 관리 화면을 먼저 확인합니다. 기존 업무용 주소의 레코드를 잘못 바꾸면 메일이나 다른 서비스가 끊길 수 있으니 바꾸기 전 값을 기록해 둡니다.
Vercel Domains 화면이 안내한 값: CNAME, www, 프로젝트 고유 값
현재 DNS 관리 화면의 기록: CNAME, www, old.example.net위 가상 기록에서 레코드 종류와 이름은 같고 값만 다르므로, 바꿀 대상은 www의 CNAME 값 하나입니다. 레코드를 입력한 뒤에는 Vercel Domains 화면에 연결이 완료된 상태가 표시되는지, https://로 시작하는 실제 주소에서 내 사이트가 열리는지, 통신을 암호화하는 HTTPS가 적용됐는지 확인합니다. 바꾼 DNS 값이 인터넷 전체에 반영되는 데 시간이 걸릴 수 있으므로 값을 계속 바꾸기보다 표시된 상태를 기다리며 확인합니다.
🏠 셀프호스팅이란: 플랫폼 호스팅과의 차이
셀프호스팅(Self-hosting)은 Vercel이나 Netlify 같은 호스팅 플랫폼 대신, 직접 준비한 서버에서 앱을 실행하고 운영하는 방식입니다. 서버로는 내 컴퓨터를 쓰거나, 서버 컴퓨터의 자원을 나눠 빌려 쓰는 VPS(가상 사설 서버)를 임대합니다.
| 구분 | 플랫폼 호스팅(Vercel 등) | 셀프호스팅 |
|---|---|---|
| 서버 관리 | 플랫폼이 서버와 기반 환경을 관리하고, 앱 설정과 데이터 관리는 직접 합니다 | 서버 설치와 보안 업데이트, 백업까지 직접 합니다 |
| 비용 | 무료 범위와 사용량에 따른 요금을 냅니다 | 서버 임대료, 저장 공간과 통신 비용에 운영 시간이 더해집니다 |
| 실행 방식 | 플랫폼이 지원하는 실행 방식 안에서 씁니다 | 실행 환경을 직접 구성합니다 |
| 장애 대응 | 플랫폼 기반 장애는 플랫폼이 복구하고, 앱 오류는 직접 찾습니다 | 서버가 멈춘 원인을 직접 찾아 복구합니다 |
셀프호스팅에서는 플랫폼이 대신 해 주던 연결을 직접 구성합니다. 예를 들어 DNS의 A 레코드가 VPS의 IP를 가리키게 하고, 웹 요청을 받아 앱으로 전달하는 서버 프로그램 Nginx와 앱이 꺼지지 않게 실행을 관리하는 도구 PM2를 함께 두는 구성이 있습니다. 모든 서비스가 이 조합을 써야 하는 것은 아닙니다.
셀프호스팅은 플랫폼이 지원하지 않는 실행 방식(오래 걸리는 작업이나 특수한 실행 환경)이 필요할 때, 규정 때문에 직접 관리하는 서버에만 자료를 저장해야 할 때, 현재 플랫폼의 사용량 제한과 요금이 실제 업무를 막을 때 검토합니다. 서버를 빌리기 전에는 원격 접속, 비밀값 관리, 백업과 복원을 해 본 경험이 있는지 먼저 따져 봅니다. 셀프호스팅을 골라도 서버를 운영하는 시간과 장애 대응 부담은 남습니다. 자동화 도구 n8n을 직접 설치해 쓰는 셀프호스팅 예는 n8n 수업에서 다룹니다.
🔒 환경 변수와 데이터베이스
내 컴퓨터의 .env 파일이 배포 환경에 자동 전달된다고 가정하지 않습니다. 배포 환경마다 필요한 설정을 등록하고 적용 시점을 확인합니다. 운영 데이터베이스 연결값을 시험 환경에 그대로 복사하면 시험 입력이 실제 자료를 바꿀 수 있습니다.
서버에서 localhost는 그 서버 자신을 뜻합니다. 개발 컴퓨터의 데이터베이스에 자동으로 연결되는 주소가 아닙니다. 배포 환경에서 접근 가능한 시험용 또는 운영용 데이터베이스인지와 연결 권한을 확인합니다.
🧯 배포 실패와 기능 오류 구분하기
빌드가 실패했는지, 배포는 됐지만 기능이 실패했는지 먼저 구분합니다. 프로젝트에 build 명령이 있다면 정해진 방식으로 로컬 빌드를 확인할 수 있습니다. 다만 로컬 성공이 배포 서버의 환경 차이까지 없애지는 않습니다.
오류가 나면 배포 버전과 환경, 실패 시각과 로그를 확인합니다. 로그에 비밀 키나 개인정보가 있다면 가리고 전달합니다. 환경 변수 누락 외에도 의존성, 실행 버전, 네트워크와 데이터 접근 권한 등이 원인일 수 있습니다.
운영 문제가 생겨 이전 코드로 되돌리더라도 이미 보낸 알림이나 바뀐 데이터베이스까지 자동 복구되지는 않습니다. 영향 범위와 복구할 대상을 나눠 확인합니다. 첫 배포에서는 가상 자료로 입력과 저장, 다시 조회하기까지 확인합니다.
📝 가상 배포 기록에서 다음 행동 찾기
메모장에 아래 기록을 옮깁니다. 실제 프로젝트를 외부에 올리는 연습은 아닙니다.
목표: 시험용 모임 메모를 두 사람만 검토
배포 기록: Preview, 버전 A, 빌드 성공
확인 결과: 링크를 아는 누구나 접속, 저장 요청은 API_KEY 누락으로 실패빌드 성공만 보고 완료라고 할 수 없습니다. 목표에 맞는 접근 제한을 설정하고 시험 환경에 필요한 설정을 확인한 뒤 저장과 재조회까지 다시 확인해야 합니다. 실제 비밀 값은 점검 메모에 적지 않습니다.
이번에는 “버전 B, 두 검토자만 접속 가능, 가상 메모 저장 후 다시 조회 성공”으로 바꿉니다. 이 범위에서는 미리보기 확인을 마친 것이며 운영 반영은 별도입니다. 목표와 실제 결과를 대조해 남은 일을 설명하면 첫 연습을 마친 것입니다.
📋 3줄 요약
-
배포는 사용할 환경에 프로그램을 반영하는 일이며 공개 범위와 운영 여부는 따로 확인합니다.
-
localhost는 접속하는 기기 자신을 뜻하므로 그 주소를 보내도 다른 사람의 앱에 연결되지 않습니다.
-
대상 환경과 버전을 확인하고 빌드 성공 뒤에도 접근 권한과 실제 기능 및 저장 결과를 점검합니다.
📚 참고 자료
배포 환경 공식 문서 확인: 2026년 10월 3일. Vercel 도메인 연결 문서 확인: 2026년 10월 24일.

제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
로컬에서는 되던 기능이 Vercel 미리보기에서 실패하고 로그에 API_KEY가 없다고 나옵니다. 먼저 무엇을 확인하나요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.

