구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트 | 가나투데이

구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트 | 가나투데이

구글 클라우드(GCP) 맞춤형 n8n 마법의 설치 스크립트를 준비했습니다. 이 스크립트는 단순히 설치만 하는 게 아니라, 서버의 기초 공사(Docker 설치)부터 n8n의 집(컨테이너)을 짓는 것까지 한 방에 끝내줍니다. 

GCP 우분투 터미널에 접속해서 아래 내용을 순서대로 진행해 보세요.


[Step 1] 도커 및 기본 인프라 원클릭 설치 스크립트

GCP 터미널(SSH)에 접속하자마자 아래 명령어를 복사해서 붙여넣으세요. 서버를 n8n이 살 수 있는 최적의 상태로 만듭니다.

Bash
# 1. 시스템 업데이트 및 필수 도구 설치
sudo apt-get update && sudo apt-get install -y docker.io docker-compose git

# 2. 도커 서비스 활성화 및 현재 사용자 권한 부여
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER

# 3. 설치 확인 (버전이 나오면 성공!)
docker --version && docker-compose --version

[Step 2] n8n 실행을 위한 마법의 Docker-Compose 코드

이제 n8n을 24시간 돌릴 설정 도면을 만듭니다. 터미널에서 nano docker-compose.yml을 입력하고 아래 내용을 복사해서 붙여넣은 뒤 Ctrl+O, Enter, Ctrl+X로 저장하세요.

YAML
version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n_agent
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=0.0.0.0
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://[너의-GCP-외부-IP]:5678/
      - GENERIC_TIMEZONE=Asia/Seoul
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

주의: [너의-GCP-외부-IP] 부분은 GCP 콘솔에서 확인한 본인의 정적 IP로 꼭 바꿔주세요!


[Step 3] 에이전트 깨우기 (마지막 단계)

도면 작성이 끝났다면, 아래 명령어로 에이전트를 세상 밖으로 불러냅니다.

Bash
docker-compose up -d
  • 내부 로직 스캔: -d 옵션은 '백그라운드 실행'을 의미합니다. 터미널 창을 꺼도 에이전트는 GCP 서버 안에서 24시간 계속 일하게 됩니다.


설치 후 에이전트 아키텍트의 꼼꼼한 체크리스트

스크립트를 돌렸는데도 접속이 안 된다면, GCP만의 방화벽 로직을 점검해야 합니다.

  1. GCP 방화벽 개방: GCP 콘솔 -> VPC 네트워크 -> 방화벽에서 tcp:5678 포트를 허용하는 규칙을 만드세요. (이게 안 되어 있으면 에이전트가 밖으로 신호를 못 보냅니다.)

  2. 데이터 보존: 위 스크립트의 volumes 설정 덕분에, 서버가 꺼지거나 도커를 재시작해도 친구가 짠 소중한 워크플로우와 API 키는 사라지지 않고 안전하게 보관됩니다.

  3. 상시 감시: docker ps 명령어를 입력했을 때 n8n_agentUp 상태라면 에이전트가 건강하게 숨 쉬고 있다는 증거입니다.

#가나 투데이 #ganatoday

그린아프로