From e0987c02ce8d3d00a00b6c0b3fde419c76110c4c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=B1=84=EB=AC=B8=EC=B0=BD=40MBA?= Date: Tue, 13 Oct 2026 20:26:54 +0900 Subject: [PATCH] =?UTF-8?q?n8n=20=EC=84=A4=EC=A0=95=20=EB=B6=80=EB=B6=84?= =?UTF-8?q?=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Last3Mon/65/SETUP-N8N.md | 64 +++++++++++++++++++++---- Last3Mon/65/n8n/compose.yml | 35 +++++--------- Last3Mon/65/n8n/register-credentials.sh | 5 +- 3 files changed, 72 insertions(+), 32 deletions(-) diff --git a/Last3Mon/65/SETUP-N8N.md b/Last3Mon/65/SETUP-N8N.md index 86c89c4..d8b1558 100644 --- a/Last3Mon/65/SETUP-N8N.md +++ b/Last3Mon/65/SETUP-N8N.md @@ -1,8 +1,8 @@ # 사전 준비 · n8n 실행과 OpenAI API 키 연결 -65일차부터 노코드 워크플로우 도구 **n8n**을 사용합니다. 수업의 LLM은 **OpenAI API**(기본 모델 `gpt-4.1-mini`)입니다. API 키는 git에 올라가지 않는 `.env` 파일 한 곳에만 두고, n8n과 WSL의 `miniflow`가 모두 그 파일에서 키를 읽습니다. 64일차의 Ollama는 **대체용**으로 같은 Compose에서 함께 실행합니다 (OpenAI가 실패하거나 키가 없을 때). +65일차부터 노코드 워크플로우 도구 **n8n**을 사용합니다. 수업의 LLM은 **OpenAI API**(기본 모델 `gpt-4.1-mini`)입니다. API 키는 git에 올라가지 않는 `.env` 파일 한 곳에만 두고, n8n과 WSL의 `miniflow`가 모두 그 파일에서 키를 읽습니다. n8n은 **n8n 공식 한 줄 설치**(`curl -fsSL https://get.n8n.io | sh`, [공식 안내](https://docs.n8n.io/deploy/host-n8n/install-options/one-line-setup))로 WSL의 Docker에 설치하고, 64일차의 Ollama는 **대체용**으로 수업 Compose가 함께 실행합니다 (OpenAI가 실패하거나 키가 없을 때). -> 이미지 다운로드가 약 5GB입니다(n8n 1.1GB, Ollama 4.2GB). **수업 전날 집에서 5단계까지 끝내 주세요.** 9월에 Docker로 Ollama를 써 봤다면 Ollama 이미지는 이미 있을 수 있습니다. +> 이미지 다운로드가 약 6.5GB입니다 (공식 설치의 n8n 묶음 약 2.3GB: n8n 1.1GB · 코드 실행기 0.55GB · 샌드박스 0.43GB · 검색 0.26GB / Ollama 4.2GB). **수업 전날 집에서 6단계까지 끝내 주세요.** 9월에 Docker로 Ollama를 써 봤다면 Ollama 이미지는 이미 있을 수 있습니다. ```mermaid flowchart LR @@ -10,8 +10,15 @@ flowchart LR E[".env
OPENAI_API_KEY
(git 제외)"] -.-> M & C subgraph WSL["WSL2 (Ubuntu)"] M["miniflow
(uv 프로젝트)"] - subgraph DC["Docker Compose · day65-n8n"] - N["n8n :5678"] -. "대체" .-> O["Ollama :11434"] + subgraph DC["Docker Compose 프로젝트 day65-n8n"] + subgraph OFF["~/day65-n8n (공식 한 줄 설치)"] + N["n8n :5678"] + RN["runners
Code 노드 실행"] + SB["sandbox · searxng
(n8n AI 기능용)"] + end + O["Ollama :11434
(Last3Mon/65/n8n이 더함)"] + N -. "대체" .-> O + N --- RN end C["register-credentials.sh"] -->|"Credential 등록"| N M -->|"http://localhost:5678/webhook/..."| N @@ -100,15 +107,45 @@ ls /usr/share/ollama/.ollama/models 2>/dev/null && echo "서비스 설치 경로 | `서비스 설치 경로 사용` | `OLLAMA_DATA=/usr/share/ollama/.ollama` (기본값 그대로) | | `홈 경로 확인 필요` | `OLLAMA_DATA=/home//.ollama` 로 바꾸기 | -## 5. n8n 실행과 첫 설정 (이미지 다운로드 10~30분) +## 5. n8n 공식 한 줄 설치 (이미지 다운로드 5~15분) + +n8n이 제공하는 설치 스크립트가 Docker Compose 설정을 **자동으로** 만들고 n8n을 켭니다. 수업에서는 두 가지만 정해서 실행합니다. + +```bash +cd ~ +curl -fsSL https://get.n8n.io | N8N_DIR=./day65-n8n sh -s -- --version 2.42.6 +``` + +| 옵션 | 이유 | +| --- | --- | +| `N8N_DIR=./day65-n8n` | 설치 폴더 `~/day65-n8n`. 폴더 이름이 Docker 프로젝트 이름이 되어, 67일차부터 쓰는 사내 데이터 API가 같은 네트워크(`day65-n8n_default`)에 붙습니다 | +| `--version 2.42.6` | 수업 자료를 이 버전으로 만들고 측정했습니다. 빼면 그날의 최신 버전이 설치됩니다 | + +```text +✔ Started n8n 2.42.6 and sandbox services +n8n is running at: http://localhost:5678 +Config files: ./day65-n8n/compose.yml, ./day65-n8n/.env +``` + +스크립트가 만든 파일은 이렇습니다. **고치지 않고 그대로 둡니다.** + +| 파일 | 내용 | +| --- | --- | +| `~/day65-n8n/compose.yml` | n8n, `runners`(Code 노드의 코드를 따로 실행), `sandbox-*`·`searxng`(n8n 화면 안 AI 도우미용) | +| `~/day65-n8n/.env` | n8n 버전과 내부 비밀값 (git 밖, 공유하지 않음) | +| Docker 볼륨 `day65-n8n_n8n-data` | 워크플로우·계정·Credential·실행 기록 | + +### 5.1 수업 Compose로 Ollama까지 함께 켜기 + +`Last3Mon/65/n8n/compose.yml`은 위 공식 `compose.yml`을 **포함(include)** 하고 Ollama만 더합니다. 그래서 오늘부터는 이 폴더에서 Compose 명령 하나로 n8n과 Ollama를 함께 다룹니다. ```bash cd ~/aio-01d4-stu/Last3Mon/65/n8n -docker compose up -d +docker compose up -d # Ollama를 더하고, n8n 쪽은 이미 켜져 있으면 그대로 docker compose ps ``` -- `docker compose ps`에서 `n8n`과 `ollama`가 모두 `running`이면 성공입니다. +- `docker compose ps`에서 `n8n`, `runners`, `ollama`(그리고 `sandbox-api`, `sandbox-runner-1`, `searxng`)가 `running`이면 성공입니다. - Windows 브라우저에서 **http://localhost:5678** 을 열고, 처음 한 번 관리자 계정(이메일·이름·비밀번호)을 만듭니다. 이 계정은 내 노트북 안에만 저장되며, 외부로 가입되는 것이 아닙니다. - 설문 화면이 나오면 건너뛰어도 됩니다. @@ -146,12 +183,17 @@ Reply (openai, 2.9s): ready ## 8. 끄고 켜기 +`Last3Mon/65/n8n` 폴더에서 합니다. 공식 설치 폴더(`~/day65-n8n`)에서 따로 켜고 끌 필요는 없습니다. + ```bash +cd ~/aio-01d4-stu/Last3Mon/65/n8n docker compose stop # 수업이 끝나면 멈춤 (데이터는 유지) docker compose start # 다음에 다시 켬 docker compose down # 컨테이너 삭제 (워크플로우·계정·Credential은 n8n-data 볼륨에 유지) ``` +`docker compose down -v`는 볼륨까지 지우므로 쓰지 않습니다. n8n 버전을 올리는 공식 명령(`... | sh -s -- --upgrade`)도 수업 중에는 쓰지 않습니다 (자료가 2.42.6 기준). + ## 9. 문제 해결 | 증상 | 해결 | @@ -161,13 +203,17 @@ docker compose down # 컨테이너 삭제 (워크플로우·계정·Credent | `HTTP 429 insufficient_quota` | 키의 조직에 API 크레딧이 없음 → 강사·운영진에 알림 | | `register-credentials.sh`가 `No .env with OPENAI_API_KEY found` | 2단계를 `Last3Mon` 폴더에서 했는지 확인 | | `port is already allocated` (11434) | 3단계: `sudo systemctl stop ollama` | -| `port is already allocated` (5678) | 다른 n8n이 실행 중인지 `docker ps`로 확인 후 멈춤 | +| `port is already allocated` (5678) / 설치 스크립트가 `something is already listening on port 5678` | 다른 n8n이 실행 중인지 `docker ps`로 확인 후 멈춤 | +| 설치 스크립트가 `Docker is not installed` / `daemon is not running` | 1단계(WSL Docker 설치), `docker` 그룹 적용을 위해 터미널 다시 열기, `sudo systemctl start docker` | +| 설치 스크립트가 `./day65-n8n exists and is not empty` | 이미 설치됨. 5.1절로 넘어가기 (`~/day65-n8n`을 지우지 않습니다) | +| `docker compose up`이 `.../day65-n8n/compose.yml: no such file or directory` | 5단계를 홈(`cd ~`)에서 하지 않았거나 수업 저장소가 `~/aio-01d4-stu`가 아님 → n8n을 설치한 폴더를 `.env`의 `N8N_HOME=`에 적기 | +| `Docker Hub pull rate limit` | 잠시 후 다시, 또는 `docker login` | | 브라우저에서 `localhost:5678`이 열리지 않음 | `docker compose ps`로 상태 확인, `docker compose logs n8n`으로 오류 확인. WSL 안의 컨테이너도 Windows 브라우저에서 `localhost`로 열리는 것이 기본이며, 계속 안 되면 PowerShell에서 `wsl --shutdown` 후 WSL을 다시 열기 | | 웹훅 호출이 404 (`not registered`) | 워크플로우 오른쪽 위 **Publish** 토글 확인. 같은 워크플로우를 여러 번 가져왔다면 기존 것을 삭제하고 한 번만 가져온 뒤 Publish | ## 확인 - [ ] `Last3Mon/.env`에 키를 넣었고, `git status`에 `.env`가 보이지 않는다 -- [ ] `docker compose ps` → n8n, ollama 모두 running +- [ ] `~/day65-n8n`에 공식 설치가 있고(`compose.yml`, `.env`), `Last3Mon/65/n8n`에서 `docker compose ps` → n8n, runners, ollama 모두 running - [ ] n8n Credentials에 `OpenAI (.env)`, `Ollama local`이 있다 - [ ] `uv run miniflow check` → `Reply (openai, …): ready` diff --git a/Last3Mon/65/n8n/compose.yml b/Last3Mon/65/n8n/compose.yml index 2b23735..c1f5fa9 100644 --- a/Last3Mon/65/n8n/compose.yml +++ b/Last3Mon/65/n8n/compose.yml @@ -1,35 +1,26 @@ -# n8n (LLM: OpenAI API, key from Last3Mon/.env via register-credentials.sh) + Ollama as the fallback. -# docker compose up -d (run from this folder) -# n8n editor : http://localhost:5678 -# Ollama API : http://localhost:11434 (n8n uses http://ollama:11434 inside the network) +# Course stack for days 65-79: the official n8n one-line setup + Ollama (fallback LLM). +# +# 1) Install n8n once with the official script, into ~/day65-n8n (the folder name becomes the +# Docker project name, so the network stays day65-n8n_default for the day 67+ data APIs): +# cd ~ && curl -fsSL https://get.n8n.io | N8N_DIR=./day65-n8n sh -s -- --version 2.42.6 +# 2) From this folder, run everything together: +# docker compose up -d (start / stop / ps / logs n8n / exec ollama ... as usual) +# +# This file includes ~/day65-n8n/compose.yml (n8n, task runners, sandbox, search) as written by the +# script, and adds Ollama. n8n reaches Ollama at http://ollama:11434; WSL programs use localhost:11434. name: day65-n8n -services: - n8n: - image: docker.n8n.io/n8nio/n8n:2.42.6 - ports: - - "5678:5678" - environment: - - GENERIC_TIMEZONE=Asia/Seoul - - TZ=Asia/Seoul - - N8N_SECURE_COOKIE=false - volumes: - - n8n-data:/home/node/.n8n - - ./workflows:/home/node/workflows:ro - depends_on: - - ollama - restart: unless-stopped +include: + - path: ${N8N_HOME:-../../../../day65-n8n}/compose.yml +services: ollama: image: ollama/ollama:latest ports: - "11434:11434" volumes: - # Reuse the models downloaded on day 64 by setting OLLAMA_DATA in .env - # (default: a new Docker volume, then run: docker compose exec ollama ollama pull gemma3:4b) - ${OLLAMA_DATA:-ollama-data}:/root/.ollama restart: unless-stopped volumes: - n8n-data: ollama-data: diff --git a/Last3Mon/65/n8n/register-credentials.sh b/Last3Mon/65/n8n/register-credentials.sh index e09ce3d..8b46a83 100644 --- a/Last3Mon/65/n8n/register-credentials.sh +++ b/Last3Mon/65/n8n/register-credentials.sh @@ -2,6 +2,7 @@ # Register the course credentials in n8n from the .env file, so the API key is never typed into # a workflow or committed to git. # cd Last3Mon/65/n8n && docker compose up -d && bash register-credentials.sh +# N8N_CONTAINER= if your n8n container has another name (docker ps). # # Creates (or updates) two credentials with fixed ids that the course workflows already use: # OpenAI (.env) id openAiCourse0001 <- OPENAI_API_KEY (and OPENAI_BASE_URL if set) @@ -39,7 +40,9 @@ fi credentials=$(printf '[{"id":"openAiCourse0001","name":"OpenAI (.env)","type":"openAiApi","data":{"apiKey":"%s","url":"%s"}},{"id":"ollamaLocal0001","name":"Ollama local","type":"ollamaApi","data":{"baseUrl":"http://ollama:11434"}}]' "$key" "$base_url") # The JSON goes through stdin into a temporary file inside the container, then is deleted. -printf '%s' "$credentials" | docker compose exec -T n8n sh -c \ +container="${N8N_CONTAINER:-day65-n8n-n8n-1}" +docker inspect "$container" >/dev/null 2>&1 || { echo "n8n container '$container' not found. Start n8n first: cd Last3Mon/65/n8n && docker compose up -d" >&2; exit 1; } +printf '%s' "$credentials" | docker exec -i "$container" sh -c \ 'cat > /tmp/course-credentials.json && n8n import:credentials --input=/tmp/course-credentials.json; status=$?; rm -f /tmp/course-credentials.json; exit $status' echo "Registered 'OpenAI (.env)' and 'Ollama local' from $env_file"