3강: 도커(Docker)로 n8n 설치하기: 단계별 가이드

도커(Docker)로 n8n 설치하기: 단계별 가이드

이번 강에서는 도커(Docker)를 사용하여 n8n을 셀프호스팅 환경에 설치하는 방법을 단계별로 설명합니다. 도커는 n8n을 컨테이너화하여 실행할 수 있게 해주는 도구로, 손쉽게 설치하고 관리할 수 있는 장점이 있습니다. 도커를 사용하면 n8n을 다양한 환경에서 일관되게 실행할 수 있어 유용합니다.

도커 설치하기

먼저, n8n을 실행하기 위해서는 도커와 도커 컴포즈(Docker Compose)를 설치해야 합니다. 도커는 애플리케이션을 컨테이너화하여 실행할 수 있게 해주는 도구로, 서버 환경에 관계없이 일관된 환경을 제공합니다.

도커 설치

도커는 대부분의 리눅스 배포판에서 패키지 매니저를 통해 쉽게 설치할 수 있습니다. 예를 들어, Ubuntu에서는 다음 명령어를 입력하여 도커를 설치할 수 있습니다:

sudo apt update
sudo apt install docker.io

설치가 완료된 후, 도커가 제대로 실행되는지 확인하려면 다음 명령어로 도커 버전을 확인할 수 있습니다:

docker --version

도커가 정상적으로 설치되었다면, 이제 도커 컴포즈(Docker Compose)를 설치할 차례입니다.

도커 컴포즈 설치

도커 컴포즈는 다수의 컨테이너를 정의하고 실행할 수 있도록 돕는 도구입니다. 도커와 함께 설치하여 여러 개의 컨테이너를 동시에 관리할 수 있습니다. Ubuntu에서는 아래 명령어로 도커 컴포즈를 설치할 수 있습니다:

sudo apt install docker-compose

도커 컴포즈가 정상적으로 설치되었는지 확인하려면, 다음 명령어로 버전을 확인합니다:

docker-compose --version

n8n 도커 이미지 다운로드

도커가 설치된 후, n8n을 실행하기 위해 필요한 도커 이미지를 다운로드해야 합니다. n8n의 공식 도커 이미지는 Docker Hub에서 제공됩니다. 다음 명령어로 n8n 도커 이미지를 다운로드합니다:

docker pull n8nio/n8n

이 명령어는 최신 버전의 n8n 이미지를 다운로드합니다. 다운로드가 완료되면, 이제 n8n을 실행할 준비가 되었습니다.

n8n 컨테이너 실행하기

n8n을 도커에서 실행하려면, 도커 컨테이너를 실행하는 명령어를 입력해야 합니다. 아래 명령어는 n8n 컨테이너를 실행하여 브라우저에서 n8n을 사용할 수 있게 설정하는 방법입니다.

docker run -d --name n8n -p 5678:5678 n8nio/n8n

위 명령어에서, -d는 백그라운드 모드에서 실행하겠다는 의미이고, -p 5678:5678은 포트 5678을 열어 n8n에 접근할 수 있도록 설정합니다. 컨테이너가 실행되면, 웹 브라우저에서 http://<서버 IP>:5678 주소로 n8n에 접속할 수 있습니다.

환경 변수 설정

n8n을 실행할 때, 환경 변수를 설정하여 n8n의 설정을 맞춤화할 수 있습니다. 예를 들어, 데이터베이스 연결, SMTP 설정 등 다양한 기능을 설정할 수 있습니다. 이를 위해 도커 명령어에 환경 변수를 추가할 수 있습니다. 예시로, 아래와 같이 환경 변수를 설정할 수 있습니다:

docker run -d --name n8n -p 5678:5678 -e DB_TYPE=postgresdb -e DB_POSTGRESDB_HOST= -e DB_POSTGRESDB_PORT=5432 -e DB_POSTGRESDB_USER= -e DB_POSTGRESDB_PASSWORD= n8nio/n8n

위 명령어에서 DB_TYPE, DB_POSTGRESDB_HOST, DB_POSTGRESDB_USER 등의 환경 변수를 사용하여 n8n의 데이터베이스 연결을 설정할 수 있습니다.

n8n 도커 컴포즈 파일 설정

도커 컴포즈를 사용하면 여러 개의 컨테이너를 한 번에 설정하고 실행할 수 있어 더 효율적인 관리가 가능합니다. 다음은 docker-compose.yml 파일을 사용하여 n8n을 실행하는 예시입니다:

version: '3'
services:
  n8n:
    image: n8nio/n8n
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=
      - DB_POSTGRESDB_USER=
      - DB_POSTGRESDB_PASSWORD=
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/root/.n8n

이 파일을 생성한 후, 도커 컴포즈 명령어로 n8n을 실행할 수 있습니다. 명령어는 아래와 같습니다:

docker-compose up -d

이 명령어로 n8n을 백그라운드 모드에서 실행할 수 있습니다.

마무리

이 강에서는 도커를 사용하여 n8n을 설치하고 실행하는 방법을 배웠습니다. 도커를 활용하면 n8n을 손쉽게 설치하고 관리할 수 있으며, 여러 서버 환경에서 일관된 실행 환경을 제공할 수 있습니다. 이제 n8n이 설치된 서버에서 다양한 자동화 워크플로우를 구성할 수 있습니다. 다음 강의에서는 n8n을 활용한 기본적인 설정과 기능들을 다룰 예정입니다.

bloghi 님의 블로그