본문 바로가기

분류 전체보기43

Spring Batch 무중단 배포: 심볼릭 링크로 ClassNotFoundException 해결 핵심 요약: 본 문서는 스프링 배치(Spring Batch) 실행 중 배포 시 발생하는 ClassNotFoundException 문제를 해결하기 위해, 심볼릭 링크(Symbolic Link)를 활용한 무중단 배포 전략을 단계별로 설명한다. 이 가이드를 통해 안정적인 배치 운영 환경을 구축할 수 있다.스프링 배치 Job 실행 중에 새로운 버전의 JAR 파일이 배포되면서 발생하는 java.lang.NoClassDefFoundError 또는 java.lang.ClassNotFoundException는 많은 개발자가 직면하는 문제이다. 이로 인해 배치 Job은 비정상적으로 중단되고 데이터 정합성 문제까지 야기할 수 있다. 본 문서는 이러한 문제를 해결하고 안정적인 배포 파이프라인을 구축하는 것을 목표로 한다.0.. 2025. 6. 16.
n8n을 Cursor AI의 MCP 서버로 활용하기 핵심 요약: 본 문서는 AI 코딩 어시스턴트 Cursor AI의 요청을 받아 처리하는 n8n MCP(Microservice Communication Protocol) 서버 워크플로우의 생성 및 연동 방법을 단계별로 설명한다. 이 가이드를 통해 사용자는 Webhook을 이용하여 n8n을 외부 서비스의 백엔드로 활용하는 기본 원리를 습득할 수 있다.n8n을 활용한 자동화는 보통 여러 서비스의 클라이언트 역할을 수행하지만, Webhook 노드를 사용하면 외부 요청을 수신하는 강력한 서버로 기능할 수 있다. 본 문서는 AI 코딩 어시스턴트인 Cursor AI가 n8n 워크플로우를 원격으로 호출하여 작업을 수행하도록, n8n을 MCP 서버로 설정하는 구체적인 절차를 안내하는 것을 목표로 한다.0. 시작 전 준비 .. 2025. 6. 16.
내 서버에 n8n 자동화 허브 구축하기 (feat. Coolify) 핵심 요약: 본 문서는 Coolify에서 n8n을 배포하고 개인 도메인(FQDN)을 연결하는 과정을 스크린샷 중심으로 설명합니다. 각 단계를 시각적으로 따라하며 누구나 쉽게 n8n 인스턴스를 구축할 수 있습니다.Coolify를 이용하면 복잡한 서버 설정 없이 강력한 자동화 도구 n8n을 손쉽게 운영할 수 있습니다. 이 가이드는 텍스트 설명을 최소화하고, 실제 실행 화면을 통해 배포 전 과정을 안내합니다.0. 필수 준비 사항: DNS 설정배포에 앞서, 가장 중요한 단계는 도메인 설정입니다. 사용하실 도메인의 DNS 설정에서, n8n에 할당할 서브도메인이 Coolify 서버의 IP를 가리키도록 A 레코드를 추가해야 합니다.(예시) spaceship에서 A 레코드 설정: 이름(n8n) → 내용(Coolify .. 2025. 6. 15.
Ubuntu 22.04 환경에서 Coolify PaaS 구축하는 방법 핵심 요약: 본 문서는 자체 호스팅 PaaS(Platform as a Service) 솔루션인 Coolify의 설치, 초기 관리자 설정, 그리고 핵심 메뉴(서버, 소스, 목적지, 프로젝트, 애플리케이션, 데이터베이스 등)의 기능과 사용법을 단계별로 상세히 설명한다. 이 가이드를 통해 사용자는 Coolify의 기본 아키텍처를 이해하고 자신의 애플리케이션을 직접 배포 및 관리할 수 있는 역량을 갖추게 된다.클라우드 네이티브 시대에 접어들면서, 개발자들은 인프라 관리의 복잡성에서 벗어나 비즈니스 로직 개발에 집중하기를 원한다. Heroku, Vercel, Netlify와 같은 PaaS 플랫폼은 이러한 요구에 부응하며 많은 사랑을 받고 있다. 그러나 특정 클라우드에 대한 종속성이나 비용 문제로 인해 자체 서버에.. 2025. 6. 15.
Coolify 설치부터 실행까지, 초보자를 위한 셀프 호스팅 PaaS 구축 가이드 TL;DR: 이 글은 내 개인 서버에 Vercel이나 Netlify 같은 PaaS(Platform as a Service)를 직접 구축하는 Coolify 설치 과정을 다룬 글이야. 결론부터 말하면 curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash 명령어 하나면 설치는 끝나. 바쁜 사람은 이것만 기억해도 좋아.혹시 Vercel이나 Heroku 같은 플랫폼 쓰다가 월말에 요금 청구서 보고 깜짝 놀란 경험 없어? 난 얼마 전에 사이드 프로젝트 몇 개 돌렸다고 생각보다 높은 금액이 나와서 '아, 내 서버에 직접 이런 환경을 만들어볼 순 없나?' 하는 생각이 들더라고. 그래서 찾게 된 게 바로 Coolify야. 나처럼 저렴하게, 하지만 강력하게 나만의 P.. 2025. 6. 15.
개발자를 위한 n8n 셀프 호스팅 A to Z: Docker 설치부터 초기 설정까지 TL;DR: 이 포스트에서는 Docker를 사용하여 오픈소스 워크플로우 자동화 도구인 n8n을 쉽고 안정적으로 서버에 설치하고 실행하는 방법을 다룹니다. `docker-compose.yml` 파일을 이용해 몇 가지 간단한 명령어로 자신만의 n8n 인스턴스를 구축하는 과정을 단계별로 안내합니다.반복적인 작업을 자동화하고 여러 서비스를 연동하는 과정에서 Zapier나 Make 같은 툴을 사용하다가, 실행 횟수 제한이나 비싼 요금제 때문에 아쉬웠던 경험, 다들 한 번쯤 있으시죠? 🤔 저 역시 비슷한 고민 끝에 강력한 오픈소스 대안인 n8n을 셀프 호스팅(Self-hosting)하여 사용하고 있습니다.이 글에서는 저와 같은 개발자분들이 데이터 주권을 지키고 비용을 절감하며 무제한으로 워크플로우를 실행할 수 있.. 2025. 6. 15.