본문 바로가기

전체288

n8n 커스텀 노드 Authorization 실패 트러블슈팅 — Worker 분산 환경의 함정 n8n을 큐 모드로 운영하면서, 단일 인스턴스 환경에서는 멀쩡하던 커스텀 노드가 운영에서만 401 에러를 뿜기 시작했다. 원인은 n8n 자체가 아니라 "프로세스 로컬 메모리 캐시"라는 무심한 설계 가정이었다. 이번 글에서는 그 디버깅 과정과 해결책(Redis 기반 분산 토큰 캐시)을 정리한다.1. 증상자체 개발한 커스텀 노드(외부 API 연동)에서 드롭다운(예: 프로젝트 목록)이 처음에는 정상 로드됨Execute Step을 수동으로 누른 이후부터 Error fetching options 발생HTTP 401 Unauthorized + Authorization failed - please check your credentials로컬 단일 인스턴스 환경에서는 재현되지 않고, 운영(메인 1대 + Worker 3.. 2026. 5. 5.
사내 n8n을 외부에서 호출하기 (Webhook 분리 + AWS API Gateway 아키텍처) n8n을 사내에 구축해 운영하다 보면 거의 반드시 마주치는 요구가 있다. "외부 SaaS / 파트너 시스템에서 n8n 워크플로를 직접 호출하고 싶다". 이 글은 내부 인프라는 그대로 보호한 채 Public 호출을 안전하게 받기 위해, n8n 내부 구조 분리 + AWS API Gateway 도입을 어떻게 조합했는지를 정리한 기록이다.1. 배경과 목적n8n은 사내 인프라에 구축되어 있으며, 내부 네트워크에 위치한 Private ALB를 통해서만 접근 가능하도록 구성되어 있었다. 그러나 외부 시스템(SaaS, 파트너 시스템, 외부 이벤트 소스 등)에서 n8n 워크플로를 직접 호출해야 하는 요구가 지속적으로 발생했다.이를 해결하기 위해 다음 두 가지 구조적 개선을 진행했다.n8n 내부 구조 개선Main / Wo.. 2026. 5. 5.
[The Nature of Software Development] 을 또 읽고나서 🔖 이미 ‘소프트웨어의 본질’이라는 책을 읽은 적이 있다.그리고 독후감을 작성한 적도 있었다.https://happy-coding-day.tistory.com/219 [The Nature of Software Development] 을 읽고나서 🔖이 책을 읽게된 이유는 트레바리 테크유닛으로 이직을 한 뒤로 풀리지 않던 고민이 하나 있었기 때문이다. 코딩은 코딩이다. 개발은 개발이다. 명시적이고, 부담감이 느껴지지 않는다. 그러나 'happy-coding-day.tistory.com그때는 AI 시대 이전이었다.지금 다시 같은 주제를 바라보니, 분명히 달라진 지점들이 보인다.무엇이 달라졌을까?가장 크게 느껴지는 변화는 하나다.이제는 코드를 직접 작성하지 않아도 된다는 것자연어만으로도 상당 부분의 구현이 가능해.. 2026. 5. 4.
n8n Queue 모드 아키텍처와 운영 포인트 n8n Queue 모드 아키텍처와 운영 포인트워크플로우 자동화 도구인 n8n을 본격적으로 운영하다 보면, 어느 순간 단일 프로세스만으로는 트래픽과 안정성을 감당하기 어려운 시점이 옵니다. 이 글에서는 n8n의 두 가지 운영 모드(단일 / 큐)를 비교하고, 큐 모드의 아키텍처와 실제 운영에서 챙겨야 할 포인트를 정리합니다.본 내용은 n8n 1.121.3 기준이며, 운영 중인 환경의 버전과 일부 차이가 있을 수 있습니다.1. 들어가며n8n은 다음 두 가지 모드로 운영할 수 있습니다.단일(regular) 모드 — 하나의 프로세스가 모든 역할 처리큐(queue) 모드 — 역할을 분리하여 수평 확장 가능큐 모드는 대규모 트래픽과 높은 안정성이 요구되는 환경에 적합하며, 역할 분리를 통해 확장성을 확보할 수 있습니.. 2026. 5. 4.
AI시대, 우리는 어디로 흘러가고 있나요? 예전에 JPA로 개발하던 시절이 있었다.JPA를 사용해본 개발자라면 한 번쯤 들어봤을 규칙이 있다.“Many-to-Many 연관관계는 사용하지 말라.”이 규칙이 존재하는 이유는 단순하다.데이터가 한 번 흘러가기 시작한 연관관계는 이후 변경이 매우 어렵고, 변경을 시도하더라도 상당한 비용이 발생하기 때문이다. 결국 우리는 초기 설계에서 미래의 변화 가능성을 고려해 더 유연한 구조를 선택하게 된다.문득 이런 생각이 들었다.지금 우리가 살고 있는 시대도 이와 비슷하지 않은가.이미 AI라는 흐름은 시작되었고, 이 흐름 자체를 되돌리거나 무시하기는 어려운 수준에 이르렀다. 이제는 흐름을 바꾸려 하기보다, 그 흐름 위에 올라타야 하는 시점에 가까워졌다. 그리고 이 변화는 단순히 도구 하나가 추가된 것이 아니라, 우.. 2026. 4. 29.
하네스 엔지니어링, 왜 지금 이렇게 많이 언급되는가 최근 들어 LinkedIn, X 등 다양한 채널에서 하네스 엔지니어링(Harness Engineering)이라는 키워드가 자주 언급되고 있다.그렇다면 하네스란 무엇이며, 왜 이렇게까지 주목받고 있는 것일까?처음 이 개념을 접하면 다소 허무하게 느껴질 수 있다.흔히 말하는 “소문난 잔치에 먹을 것 없다”는 표현처럼, 하네스를 구성하는 개별 요소들은 이미 우리가 알고 있는 것들이다.예를 들어 다음과 같은 것들이다.CLAUDE.mdSubAgentHooksMCPSkills이 자체만 놓고 보면 새로운 개념이라기보다, 기존에 존재하던 구성 요소들의 집합처럼 보인다.그렇다면 왜 이 개념이 다시 강조되고 있는 것일까?하네스가 중요한 이유: 숨겨진 의도이 질문에 답하기 위해서는 과거 개발 방식과 현재를 비교해볼 필요가 .. 2026. 4. 13.
[과학적 관리법] 직감이 과학을 이기는 시대 과학적 관리법이란 무엇일까.이 책에서 말하는 과학적 관리법은 감이나 경험에만 의존하지 않고, 관찰과 측정, 분석을 통해 가장 효율적인 작업 방식을 찾아 표준화하자는 관리 방식이다.이 정의를 처음 접했을 때 가장 먼저 든 생각은 단순했다.“이건 너무 당연한 이야기 아닌가?”“요즘에도 과학적 관리법과 다르게 일하는 회사가 있을까?”그런데 곰곰이 지난 회사들을 떠올려보니, 오히려 이 책이 지금도 유효한 이유가 분명해 보였다. 생각보다 많은 조직이 여전히 ‘효율적인 일하는 방식’을 명확히 찾지 못한 채 방황하고 있기 때문이다.다시 말해, 과학적 관리법은 아주 특별하거나 난해한 이야기가 아니다.업무 환경에서 효율을 높일 수 있는 방법에 대해 가설을 세우고, 그것을 검증한 뒤, 실제로 더 높은 효율이 확인되면 그에.. 2026. 3. 30.
GPT Actions로 실제로 쓰는 가계부를 만들어봤습니다 ChatGPT를 업무에서 활용하는 개발자는 많아졌지만,“실제로 생활 속에서 매일 쓰는 도구”를 만든 사례는 아직 많지 않다고 느꼈습니다.이번 글에서는 GPT Actions를 활용해, 실제로 동작하고 실제로 사용 중인 가계부 앱을 만든 경험을 정리해보려고 합니다.왜 가계부를 만들었는가아내와 함께 가계부를 쓰려고 여러 앱을 사용해봤습니다.하지만 오래 쓰지 못했습니다.이유는 단순했습니다.입력이 귀찮았습니다.자동 연동은 신뢰가 가지 않았습니다.결국 “캡처해서 올리면 알아서 정리되면 좋겠다”는 생각만 남았습니다.토스 앱에는 이미 결제 내역이 잘 정리되어 있었고, 매번 그 화면을 보며 “이걸 그대로 가계부로 옮길 수 있으면 좋겠다”는 생각이 들었습니다.그래서 만들었습니다.앱이 아니라 ChatGPT 안에서 해결하기처.. 2025. 12. 28.
⚙️ n8n 워크플로우 구축 후기 - 많은 workflow 중 왜 n8n 이였을까? 사내 비개발자 대상으로 workflow 를 구축하면서 경험한 내용입니다. (12월 8일 기준)Workflow란 무엇이고, 왜 구축하려고 했는지?Workflow(워크플로우)의 개념이란, 워크플로우는 업무를 자동화하기 위해 작업을 단계별로 나누고 연결한 흐름 입니다. 각 작업(Task)을 하나의 노드(Node)로 만들어 연결하면, 사람이 직접 개입하지 않아도 시스템이 정의한 흐름에 따라 동작되는 것을 말합니다.여기에 AI Agent 를 더하여, 스스로 판단하고 실행할 수 있는 실용적인 도구로 활용될 수 있습니다.한 때 노코드 툴이라는 이름으로 불리기도 했고, Zapier 와 같은 도구가 대표적인 예시가 될 수 있습니다. 그러던 중 AI Agent 의 활용도가 높아지면서 Workflow 의 활용이 높아지게 되.. 2025. 12. 8.
"기본만 해라, 질문의 출발점" - 생각의 주도권을 디자인하라 인간은 역시 생각하는 동물이다.최근에 ‘배구감독 김연경’이라는 예능 프로그램에 빠져 있다. 예능이지만 다큐멘터리를 보는 듯한 느낌을 주는 프로그램이다. 이제 막 2회차를 지나고 있는 신생 예능인데, 출연하는 선수 대부분은 은퇴한 여자 배구 선수들이다. 이들이 프로 선수팀과 경기를 치르는 장면 중, 김연경 감독이 작전 타임에서 했던 말이 떠오른다.“기본만 해라. 딱 기본만 해라.”내가 읽은 책과 연결된 장면이 바로 이 대목이었다. 왜 ‘기본만 해라’라는 말이 인상 깊게 남았을까?ChatGPT를 처음 사용할 때가 떠올랐다. 단 한 줄의 프롬프트만 입력해도 의도한 결과를 얻어낼 수 있다는 점이 매력적이었다. 처음에는 무엇이든 물어보며 탐구했지만, 시간이 지나면서 점점 프롬프트가 단순해졌다. 어느 순간부터는 “.. 2025. 10. 8.
『직업으로서의 소설가』를 읽고: “아무튼 하지 않으면 안 되는 일” 최근 무라카미 하루키의 에세이 『직업으로서의 소설가』를 읽으면서 여러 인상 깊은 구절들이 있었지만, 특히 두 가지 키워드가 마음에 오래 남았다. 하나는 오리지널리티, 다른 하나는 아무튼 하지 않으면 안 되는 일이라는 표현이다.오리지널리티에 대해 다시 생각하다.책을 읽으며 흥미롭게 느꼈던 부분 중 하나는 바로 오리지널리티에 대한 하루키의 생각이다. 이 단어를 처음 접했을 때, 올리버 색스의 다음과 같은 인용문이 함께 소개된다.창조성에는 지극히 개인적이라는 특징이 있으며, 강고한 아이덴티티와 개인적인 스타일이 있어서 그것이 재능에 반영되고 녹아들어 개인적인 몸과 형태가 된다. 그런 의미에서 창조성이란 새롭게 만들어내는 것. 기존의 견해를 타파하고 상상의 영역에서 자유롭게 날갯짓하면서 마음속으로 완전한 세계를.. 2025. 5. 5.
레디스를 DB 처럼 쓴다고 하는데, 정말 믿어도 될까? - 백업, 복제 1. Redis 란 무엇인가? 1. Redis란 무엇인가?메모리 기반의 NoSQL Key-Value 저장소빠른 읽기/쓰기 속도, 다양한 자료구조 지원 (String, List, Set, Hash, Sorted Set 등)일반적으로 캐시로 많이 사용되지만, **데이터 저장소(DB)**처럼 사용하는 사례도 늘어남→ 그렇다면, “데이터를 잃지 않고” 안정적으로 저장하는 데에 Redis는 믿을만한가? 2. 가용성이란 무슨 뜻인가? 가용성(Availability): 서비스가 얼마나 지속적으로 동작 가능한지를 나타내는 지표(Availability = 사용 가능 시간 / 전체 시간) 그러니까, 가용성 99.9% 라고 한다면, 100분 중에 단 1분만이 문제가 발생했다는 것을 의미한다.Redis 는 가용성을 높이기 .. 2025. 5. 4.
객체지향 프로그래밍에서 왜 역할/책임/협력을 계속 이야기할까? 우리가 ERD를 먼저 설계하고, 속성 중심으로 객체를 정의한 뒤 개발을 시작하면 어떤 문제가 발생할까?가장 큰 문제는 해당 객체가 어떤 문맥(context)에서 사용될지를 고려하지 않은 채 데이터를 설계하게 된다는 점이다. 이렇게 되면 이후 개발 과정에서 억지로 데이터를 껴맞추는 상황이 발생하게 된다. 예를 들어, 복잡한 조인을 포함한 2중, 3중의 SQL을 작성하고 있다면 이미 냄새가 풍기고 있는 셈이다. 객체를 똑똑하게 만들기 위해서는 객체가 사용될 문맥, 즉 사용 시나리오를 고려해야 한다. 이 지점에서 책임(responsibility)이라는 개념이 등장한다.그렇다면 여기서 말하는 문맥(context)이란 무엇일까? 이를 이해하기 위해 절차지향 방식의 문제점부터 다시 짚어보자.절차지향 프로그래밍의 한.. 2025. 4. 1.
AI 시대의 문해력, 프롬프트로 시작하다 - '최고의 프롬프트 엔지니어링 강의'를 읽고 지난주, 구글에서 제미나이 2.5를 발표했다. 구글은 이번 모델이 지금까지 출시된 모든 생성형 AI를 압도하는 성능을 보여준다고 대대적으로 홍보했다. 이 책이 처음 출간된 시점은 2024년 6월로, 당시만 해도 OpenAI의 ChatGPT가 시장을 주도하고 있었다. 그러나 1년도 채 지나지 않아, 또 다른 강력한 성능의 LLM(대규모 언어 모델)이 등장한 것이다.이처럼 시간이 흐르는 동안, 발전한 건 LLM만이 아니었다. 동영상 생성, 이미지 생성, 코드 리뷰 등 다양한 분야에서 특화된 AI들이 잇달아 출시되었고, 사용할 때마다 놀라움을 금치 못했다. 특히 SORA의 동영상 생성 기술을 봤을 때는 ‘이게 정말 가능한 일인가?’ 싶을 정도로 입이 다물어지지 않았다.LLM의 중요성은 날이 갈수록 커지고 있으.. 2025. 3. 31.
설계의 함정 - 소프트웨어 설계의 정석을 읽고 소프트웨어 설계란 무엇일까? 개발자는 개발에 앞서 설계라는 과정을 충분히 수행하고 있을까?소프트웨어 설계의 목적은 무엇일까?‘설계’란 공학 분야에서 제품을 어떻게 만들지에 대한 계획을 세우는 일이다.그렇다면 소프트웨어 설계란 코드를 작성하기 전, 미리 계획하고 준비하는 일련의 과정이라 할 수 있다.그렇다면 우리는 이 과정을 잘하고 있을까? 여러 회사를 경험하거나 이야기를 듣다 보면, 이 질문에 확신 있게 ‘그렇다’고 답할 수 있는 경우는 그리 많지 않다. 그렇기에 우리는 소프트웨어 설계에 대해 더 깊이 고민하고, 비평해볼 필요가 있다.이 책에서 말하는 ‘소프트웨어 설계를 잘하기 위해 필요한 요소’는 세 가지다. 1. 설계의 목적을 명확히 파악할 것2. 설계에 필요한 최소한의 테크닉을 습득할 것3. 그리고.. 2025. 3. 16.
내가 테스트 코드를 작성하지 못하는 이유에 대해서 테스트 코드의 중요성을 배워도, 실질적으로 잘 작성하는 건 또 다른 문제입니다.내가 작성하는 테스트 코드는 정말 의미가 있을까?잘 작성된 테스트 코드는 어떻게 다음 할 일을 알려준다는 걸까?테스트 코드가 개발 과정에서 길을 잃었을 때 나를 도와준다는 말이 무슨 뜻일까? 이처럼 많은 이야기를 들어도 테스트 코드를 잘 쓰지 못했던 이유가 있었습니다. 내가 테스트 코드를 잘 쓰지 못하는 이유테스트 코드를 제대로 작성하지 못하는 이유를 세 가지로 정리해 보았습니다.1. 너무 빠르게 작성하려고 한다테스트 코드를 작성하다 보면, 자연스럽게 프로덕션 코드와 테스트 코드 사이를 끊임없이 오가게 됩니다. 문제는 이 과정에서 코드의 본질을 충분히 이해하지 못한 채, 테스트를 “통과”시키는 데만 집중하게 된다는 점입니다.테.. 2024. 12. 1.
스프링에서 제공하는 XXTemplate 은 무엇일까? (RestTemplate, JdbcTemplate, TransactionTemplate, HibernateTemplate, SqlSessionTemplate...) 인프런의 토비 스프링 강의 일부 내용을 좀더 딥다이브한 내용입니다.Template 이란 무엇일까? 템플릿이란 어떤 목적을 위해 미리 만들어둔 모양이 있는 틀. 고정된 틀 안에 바꿀 수 있는 부분을 넣어서 사용하도록 만들어진 오브젝트입니다. 우리가 아는 템플릿 메소드 패턴또한 템플릿을 사용합니다.템플릿 메소드 패턴이란?템플릿 메소드 패턴은 고정된 틀의 로직을 가진 템플릿 메소드를 슈퍼클래스에 두고, 바뀌는 부분을 서브클래스의 메소드에 두는 구조로 이뤄진다. 스프링에서 제공하는 `XXTemplate`은 특정 프로세스의 공통 부분을 재사용하면서, 세부적으로 다른 로직을 쉽게 확장할 수 있도록 지원하는 클래스입니다. 이 클래스는 Template 메서드 패턴을 활용하여 변경되는 부분과 고정된 부분을 분리해 줍니다.. 2024. 11. 8.
(수정)DB 에서 하는 동시성제어와 애플리케이션에서 하는 동시성 제어는 어떤게 다른걸까? 데이터베이스에서 하는 동시성 제어와 애플리케이션에서 하는 동시성 제어는 모두 동시성 문제를 해결하는 방법이지만,적용되는 레벨과 사용되는 기술에서 차이가 있다. 이 둘은 각각 다른 목적으로, 다른 상황에서 사용되며, 서로 보완적인 역할을 할 수 있다.1. 데이터베이스에서의 동시성 제어 데이터베이스에서의 동시성 제어는 트랜잭션 관리를 통해 여러 클라이언트가 동시에 동일한 데이터에 접근할 때 발생하는 데이터 무결성과 일관성을 보장하는 것을 목표로 한다. 그래서 자주 사용하는 것은 잠금(Locking), 격리 수준(Isolation Level) 등의 기술을 사용한다.트랜잭션 기반이라는 말은, 데이터베이스는 트랜잭션 단위로 동시성을 제어한다. 트랜잭션은 하나 이상의 쿼리가 실행되며, 트랜잭션이 완료될 때까지 데.. 2024. 10. 8.
Java 에서 패키지(Package) 라는 것을 왜 사용해야만 할까? 자바에서 사용하는 패키지는 왜 사용할까? 일단 Java 에서 Package 라고 하면 다음과 같이 생각하는 것이 일반적이다.패키지(Package) 패키지란? 클래스의 묶음으로 클래스를 용도별이나, 기능별로 그룹화 [참고 - https://wikidocs.net/231]이것을 고민했던 이유는 다음과 같습니다.이걸 보면, Zzzz 클래스는 아무런 패키지없이도 만들 수 있습니다. 그런데 패키지가 왜 필요한거지?멘토링을 진행하면서 '이렇게 패키지 구조를 만들었는데, 적절한가요?' 라는 질문을 정말 많이 받았는데요. 이 질문에 답변을 하는 과정에서 패키지 구조만 보고 내가 어떻게 적절하다고 판단을 하지? 라는 생각을 했습니다. 적어도 옛날에 읽었던 클린 소프트웨어 책에서 패키지는 이렇게 하는거야! 라는 내용을 읽.. 2024. 10. 3.
왜 사람들은 빈약한 도메인 모델을 만들어 활용할까? 왜 사람들은 빈약한 도메인 모델을 만들까?조영호님의 인프런 강의를 들으며 좋은 인사이트를 많이 얻을 수 있었는데, 강의를 모두다 수강한 뒤에 궁금한 것이 있었다.우리 선배개발자님들은 왜 빈약한 도메인 모델을 관례처럼 만들까? 왜그럴까?도메인 계층에는 객체지향 프로그래밍을 해야된다는 것을 머리속으로는 알고는 있지 않을까? 궁금함을 찾을 수 없어, 조영호님에게 직접 물어보았다.왜 선배개발자님들은 빈약한 도메인 모델과 트랜잭션 스크립트 패턴을 작성하게 되었을까?현 시점에 우리의 선배개발자님이 이렇게 된 배경에는 2가지가 있을 수 있다고 조심스럽게 조영호님께서 말씀해주셨다.하나는 개발을 배우거나 실무에서 참고하는 기존 코드들이 이미 절차적으로 작성되어 있기 때문에 많은 사람들이 이 방식을 그대로 답습하고 있기 .. 2024. 9. 22.

티스토리툴바