[웹 개발 2화] 네이버 블로그 이전 웹서비스 : Netlify 배포 방법과 폴더 구조
시리즈 · 수익화 블로그·웹서비스 개발기 2화
ℹ 한 줄 요약
Netlify에 올릴 때는 화면 파일(public)과 함수 폴더(netlify/functions)를 함께 배포해야 합니다. 폴더를 화면에 끌어다 놓는 방식은 함수가 빠질 수 있어 CLI나 GitHub 연동을 권합니다.
Netlify에 올릴 때는 화면 파일(public)과 함수 폴더(netlify/functions)를 함께 배포해야 합니다. 폴더를 화면에 끌어다 놓는 방식은 함수가 빠질 수 있어 CLI나 GitHub 연동을 권합니다.
프로젝트 폴더 구성
배포용 폴더는 단순합니다. 화면과 변환 코드는 public 폴더에, 네이버 중계 함수는 netlify/functions 폴더에 둡니다. 배포 설정은 netlify.toml 한 파일에 적습니다.
- public/index.html, app.js: 화면과 동작
- public/worker.js, core.py: 브라우저에서 파이썬을 돌리는 부분
- public/config.js: 운영자 설정(구글 클라이언트 ID)
- netlify/functions/naver.js: 네이버 조회 중계 함수
- netlify.toml: 게시 폴더와 함수 폴더 지정
배포 방법 두 가지
방법 1. Netlify CLI
터미널에서 로그인한 뒤 배포 명령 한 번이면 됩니다. 함수까지 함께 올라가므로 가장 확실합니다. 사이트 이름을 지정해 새 사이트를 만들면서 바로 운영 배포까지 할 수 있습니다.
방법 2. GitHub 연동
폴더를 저장소에 올리고 Netlify에서 저장소를 연결하면, 이후 파일을 수정해 올릴 때마다 자동으로 다시 배포됩니다. 설정을 따로 바꿀 필요는 없습니다.
⚠ 주의
폴더를 Netlify 화면에 끌어다 놓는 방식은 화면은 뜨지만 함수가 빠져서 글 목록 불러오기가 실패할 수 있습니다.
폴더를 Netlify 화면에 끌어다 놓는 방식은 화면은 뜨지만 함수가 빠져서 글 목록 불러오기가 실패할 수 있습니다.
보안과 첫 실행
중계 함수는 blog.naver.com의 글 목록, 본문, 태그 조회 주소 세 가지만 허용합니다. 다른 주소 요청은 거절해서 남용을 막습니다. 처음 접속하면 브라우저가 파이썬 엔진을 내려받느라 10~30초 걸리고, 이후에는 캐시되어 빨라집니다.
배포 후 확인 순서
- 사이트 주소로 접속해 화면이 뜨는지 확인합니다.
- 네이버 아이디를 넣고 글 목록이 불러와지는지 확인합니다.
- 구글 로그인 팝업이 열리는지 확인합니다.
💡 팁
수정 후 반영이 안 보이면 Ctrl+F5로 새로고침하세요. 브라우저가 이전 파일을 들고 있을 수 있습니다.
수정 후 반영이 안 보이면 Ctrl+F5로 새로고침하세요. 브라우저가 이전 파일을 들고 있을 수 있습니다.
자주 묻는 질문
Q. 로컬에서 먼저 테스트할 수 있나요?
A. Netlify CLI의 netlify dev 명령으로 8888번 포트에서 테스트할 수 있습니다. 이때 구글 승인된 원본에 로컬 주소도 추가해야 합니다.
Q. 배포했는데 설정 값이 바뀌지 않아요.
A. config.js를 고친 뒤에는 다시 배포해야 반영됩니다.
핵심 정리
✔ 세 줄로 기억하기
- 화면(public)과 함수(netlify/functions)를 함께 배포해야 합니다.
- CLI나 GitHub 연동을 권하고, 드래그 앤 드롭은 주의합니다.
- 설정 파일을 고치면 반드시 다시 배포합니다.
다음 이야기 · 다음 화에서는 구글 OAuth 클라이언트 ID 발급과 로그인 오류 해결법을 다룹니다.
#Netlify배포 #Netlify함수 #정적사이트 #웹서비스개발 #서버리스 #블로그수익화 #SEO #GEO
