Jenkins를 활용한 CI/CD - 5.3 [실습] Netlify 수동 배포 및 Netlify CLI 설치하기

Netlify에 프로젝트 수동 배포하기

Netlify 수동 배포는 Jenkins CI/CD 자동화의 기초를 다지는 단계예요. 먼저 강의 자료로 제공된 build 폴더를 내려받아 압축을 풀어주세요. 윈도우에서 압축을 풀 때 파일이 보이지 않는 경우가 있는데, 그럴 때는 반디집 같은 프로그램을 사용하면 문제를 쉽게 해결할 수 있어요.

Netlify 사이트에 로그인한 뒤 프로젝트 탭 아래쪽에 있는 ‘Upload project files’ 버튼을 클릭하세요. 빌드 폴더를 그대로 드래그하거나 선택해서 올리면 배포가 시작돼요. 업로드가 끝나면 ‘Open production deploy’ 버튼을 눌러 실제 사이트가 정상적으로 나오는지 확인해보세요.

이 과정은 자동화가 아니라 사람이 직접 하는 수동 배포라는 점을 기억하세요. Jenkins에서는 이 모든 클릭 과정을 코드로 대신해야 하므로, 지금 단계에서 수동 배포 흐름을 정확히 이해하는 것이 중요해요.

Netlify CLI 설치와 기본 명령어

Netlify CLI는 브라우저 없이 터미널에서 Netlify 기능을 제어할 수 있게 해주는 도구예요. Jenkins CI/CD 파이프라인에서 자동 배포를 하려면 이 CLI가 필수적이에요.

설치는 npm을 통해 진행하는데, 글로벌 설치(-g 옵션)를 그대로 쓰면 권한 문제로 실패할 수 있어요. 따라서 프로젝트 폴더 안에 node_modules를 이용해 설치하는 방식을 추천해요. 예를 들어 아래처럼 작성하면 돼요.

npm install netlify-cli@20.1.1 npx netlify --version

버전이 제대로 출력되면 설치가 성공한 거예요. 이렇게 하면 Jenkins가 실행할 때도 별도 권한 문제가 발생하지 않아요. Netlify CLI를 설치한 뒤에는 간단한 배포 명령어로 수동 배포와 동일한 결과를 얻을 수 있다는 점을 꼭 기억하세요.

Jenkins 파이프라인에 Netlify CLI 적용하기

이제 Jenkins CI/CD 파이프라인에 Netlify CLI를 넣는 방법을 알아볼게요. 기존 스테이지 뒤에 deploy 스테이지를 추가하세요. sh 블록 안에서 Netlify CLI를 실행하도록 코드를 작성하면 돼요.

주의할 점은 -g 옵션을 빼고 npx를 활용하는 거예요. 이렇게 해야 Jenkins가 root 권한 없이도 안정적으로 실행할 수 있어요. 커밋과 푸시를 한 뒤 빌드를 돌려서 Netlify CLI 버전이 잘 나오는지, 배포까지 이어지는지 확인해보세요.

실전에서는 deploy 스테이지에 실제 배포 명령어를 추가하고, 환경변수로 Netlify 토큰을 관리하는 것이 안전해요. 이렇게 하면 수동으로 하던 모든 과정을 Jenkins가 자동으로 처리할 수 있게 됩니다.