이 호스팅 가이드는 서버리스 컨테이너 런타임인 Google Cloud Run에서 n8n을 셀프 호스팅하는 방법을 보여줍니다. 이제 막 n8n을 시작했고 프로덕션급 배포가 필요하지 않다면, 아래의 "이지 모드(easy mode)" 옵션으로 배포하면 됩니다. 반면 이 n8n 배포를 대규모로 사용할 계획이라면, 아래쪽에 있는 "듀러블 모드(durable mode)" 안내를 참고하세요.

또한 Gmail, Drive와 같은 Google Workspace에 OAuth를 통한 접근을 활성화하여, 이러한 서비스를 n8n 워크플로 도구로 사용할 수도 있습니다. n8n에 이러한 서비스에 대한 접근 권한을 부여하는 방법은 이 문서의 끝부분에 나와 있습니다.

Google Kubernetes Engine(GKE)에 배포하고 싶다면 이 안내를 참고하세요.

시작하기 전에: Google Cloud 프로젝트 준비하기#

아직 Google Cloud 프로젝트를 만들지 않았다면 먼저 이 작업을 진행하세요 (그리고 프로젝트에 결제가 활성화되어 있는지 확인하세요. Cloud Run 서비스가 무료로 실행되더라도 배포하려면 결제가 활성화되어 있어야 합니다). 그렇지 않다면 n8n을 배포하려는 프로젝트로 이동하세요.

이지 모드#

이는 Cloud Run에 n8n을 배포하는 가장 빠른 방법입니다. 이 배포에서 n8n의 데이터는 메모리에만 저장되므로, 데모 용도로만 권장됩니다. 이 Cloud Run 서비스가 0으로 스케일 다운되거나 재배포될 때마다 n8n 데이터가 손실됩니다. 프로덕션급 배포가 필요하다면 아래의 듀러블 모드 안내를 참고하세요.

아직 Google Cloud 프로젝트를 만들지 않았다면 먼저 이 작업을 진행하세요 (그리고 프로젝트에 결제가 활성화되어 있는지 확인하세요. Cloud Run 서비스가 무료로 실행되더라도 배포를 활성화하려면 결제가 활성화되어 있어야 합니다). 그렇지 않다면 n8n을 배포하려는 프로젝트로 이동하세요.

Cloud Shell 터미널을 여세요(Google Cloud 콘솔에서 "G"를 입력한 다음 "S"를 입력하거나, 오른쪽 상단의 터미널 아이콘을 클릭하면 됩니다).

세션이 열리면, 로그인을 위해 먼저 이 명령을 실행해야 할 수 있습니다(그리고 요청하는 단계를 따라 완료하세요):

gcloud auth login

Cloud Run API를 명시적으로 활성화할 수도 있습니다(이 작업을 하지 않아도 배포할 때 활성화 여부를 물어봅니다):

gcloud services enable run.googleapis.com

n8n을 배포하려면:

gcloud run deploy n8n \
    --image=n8nio/n8n \
    --region=us-west1 \
    --allow-unauthenticated \
    --port=5678 \
    --no-cpu-throttling \
    --memory=2Gi \
    --set-env-vars="N8N_ENDPOINT_HEALTH=health"

("us-west1" 대신 원하는 리전을 지정할 수 있습니다)

배포가 완료되면 다른 탭을 열어 서비스 URL로 이동하세요. n8n이 아직 로딩 중일 수 있으며, "n8n is starting up. Please wait" 메시지가 표시되지만, 곧이어 n8n 로그인 화면이 나타날 것입니다.

선택 사항: 데이터 손실을 최대한 방지하기 위해 이 n8n 서비스를 가능한 한 오래 실행 상태로 유지하고 싶다면, 수동 스케일을 1로 설정하여 0으로 자동 스케일링되지 않도록 할 수도 있습니다.

gcloud run deploy n8n \
    --image=n8nio/n8n \
    --region=us-west1 \
    --allow-unauthenticated \
    --port=5678 \
    --no-cpu-throttling \
    --memory=2Gi \
    --scaling=1 \
    --set-env-vars="N8N_ENDPOINT_HEALTH=health"

이렇게 하더라도 Cloud Run 서비스가 재배포/업데이트될 때와 같은 경우의 데이터 손실을 완전히 막지는 못합니다. 데이터를 완전히 영구적으로 유지하고 싶다면, 데이터베이스를 연결하는 방법에 대한 아래 안내를 참고하세요.

듀러블 모드#

다음 안내는 Cloud Run에서 n8n을 더 견고하고 프로덕션급으로 배포하기 위한 것입니다. 여기에는 영속성을 위한 데이터베이스, 민감한 데이터를 위한 시크릿 매니저와 같은 리소스가 포함됩니다.

Terraform을 통해 다음 설정을 배포하고 싶다면, 다음과 동일한 설정을 배포하는(Google Workspace 도구를 위한 OAuth 설정은 제외) 이 예제를 참고하세요.

API 활성화 및 환경 변수 설정#

Cloud Shell 터미널을 열고(Google Cloud 콘솔에서 "G"를 입력한 다음 "S"를 입력하거나, 오른쪽 상단의 터미널 아이콘을 클릭하면 됩니다) 터미널 세션에서 다음 명령을 실행하세요:

## You may need to login first
gcloud auth login

gcloud services enable run.googleapis.com
gcloud services enable sqladmin.googleapis.com
gcloud services enable secretmanager.googleapis.com

또한 이어지는 안내에서 사용할 몇 가지 환경 변수를 설정해야 합니다:

export PROJECT_ID=your-project
export REGION=region-where-you-want-this-deployed

Postgres 데이터베이스 설정하기#

Postgres DB 인스턴스를 만들려면 이 명령을 실행하세요(완료까지 몇 분 정도 걸립니다. 또한 root-password 필드를 원하는 비밀번호로 업데이트했는지 확인하세요):

gcloud sql instances create n8n-db \
    --database-version=POSTGRES_13 \
    --tier=db-f1-micro \
    --region=$REGION \
    --root-password="change-this-password" \
    --storage-size=10GB \
    --availability-type=ZONAL \
    --no-backup \
    --storage-type=HDD

완료되면 n8n이 사용할 데이터베이스를 추가할 수 있습니다:

gcloud sql databases create n8n --instance=n8n-db

n8n용 DB 사용자를 만드세요(당연히 비밀번호 값은 변경하세요):

gcloud sql users create n8n-user \
    --instance=n8n-db \
    --password="change-this-password"

다음 단계에서 이 비밀번호를 Secret Manager에 저장할 수 있도록, n8n-user에 설정한 비밀번호를 파일로 저장해 둘 수 있습니다. 이 파일은 나중에 반드시 삭제하세요.

민감한 데이터를 Secret Manager에 저장하기#

필수는 아니지만, 민감한 데이터를 Secrets Manager에 저장하는 것을 적극 권장합니다.

데이터베이스 비밀번호에 대한 시크릿을 만드세요("/your/password/file"을 위에서 n8n-user 비밀번호를 위해 만든 파일로 바꾸세요):

gcloud secrets create n8n-db-password \
    --data-file=/your/password/file \
    --replication-policy="automatic"

암호화 키를 만드세요(직접 만든 키를 사용해도 되며, 이 예제는 무작위 키를 생성합니다):

openssl rand -base64 -out my-encryption-key 42

이 암호화 키에 대한 시크릿을 만드세요(직접 만든 키를 제공하는 경우 "my-encryption-key"를 바꾸세요):

gcloud secrets create n8n-encryption-key \
    --data-file=my-encryption-key \
    --replication-policy="automatic"

이제 my-encryption-key와 위에서 만든 데이터베이스 비밀번호 파일을 삭제할 수 있습니다. 이 값들은 이제 Secret Manager에 안전하게 저장되어 있습니다.

Cloud Run용 서비스 계정 만들기#

이 Cloud Run 서비스는 필요한 리소스에만 접근할 수 있도록 제한하는 것이 좋습니다. 다음 명령은 서비스 계정을 만들고, 시크릿과 데이터베이스에 접근하는 데 필요한 권한을 추가합니다:

gcloud iam service-accounts create n8n-service-account \
    --display-name="n8n Service Account"

gcloud secrets add-iam-policy-binding n8n-db-password \
    --member="serviceAccount:n8n-service-account@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/secretmanager.secretAccessor"

gcloud secrets add-iam-policy-binding n8n-encryption-key \
    --member="serviceAccount:n8n-service-account@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/secretmanager.secretAccessor"

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:n8n-service-account@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudsql.client"

Cloud Run 서비스 배포하기#

이제 n8n 서비스를 배포할 수 있습니다:

gcloud run deploy n8n \
    --image=n8nio/n8n:latest \
    --command="/bin/sh" \
    --args="-c,sleep 5;n8n start" \
    --region=$REGION \
    --allow-unauthenticated \
    --port=5678 \
    --memory=2Gi \
    --no-cpu-throttling \
    --set-env-vars="N8N_PORT=5678,N8N_PROTOCOL=https,N8N_ENDPOINT_HEALTH=health,DB_TYPE=postgresdb,DB_POSTGRESDB_DATABASE=n8n,DB_POSTGRESDB_USER=n8n-user,DB_POSTGRESDB_HOST=/cloudsql/$PROJECT_ID:$REGION:n8n-db,DB_POSTGRESDB_PORT=5432,DB_POSTGRESDB_SCHEMA=public,GENERIC_TIMEZONE=UTC,QUEUE_HEALTH_CHECK_ACTIVE=true" \
    --set-secrets="DB_POSTGRESDB_PASSWORD=n8n-db-password:latest,N8N_ENCRYPTION_KEY=n8n-encryption-key:latest" \
    --add-cloudsql-instances=$PROJECT_ID:$REGION:n8n-db \
    --service-account=n8n-service-account@$PROJECT_ID.iam.gserviceaccount.com

배포가 완료되면 다른 탭을 열어 서비스 URL로 이동하세요. n8n 로그인 화면이 나타날 것입니다.

문제 해결#

"Cannot GET /" 화면이 보인다면, 이는 대개 n8n이 아직 시작 중이라는 뜻입니다. 페이지를 새로고침하면 결국 로드될 것입니다.

(선택 사항) Google Workspace 서비스를 n8n 도구로 활성화하기#

Google Workspace 서비스(Gmail, Calendar, Drive 등)를 n8n의 도구로 사용하고 싶다면, 이러한 서비스에 접근하기 위해 OAuth를 설정하는 것을 권장합니다.

먼저 원하는 각 API가 활성화되어 있는지 확인하세요:

## Enable whichever APIs you need
## Note: If you want Sheets/Docs, it's not enough to just enable Drive; these services each have their own API
gcloud services enable gmail.googleapis.com
gcloud services enable drive.googleapis.com
gcloud services enable sheets.googleapis.com
gcloud services enable docs.googleapis.com
gcloud services enable calendar-json.googleapis.com

필요한 OAuth 콜백 URL을 환경 변수로 지정하여 Cloud Run에서 n8n을 다시 배포하세요:

export SERVICE_URL="your-n8n-service-URL"
## e.g. https://n8n-12345678.us-west1.run.app

gcloud run services update n8n \
    --region=$REGION \
    --update-env-vars="N8N_HOST=$(echo $SERVICE_URL | sed 's/https:\/\///'),WEBHOOK_URL=$SERVICE_URL,N8N_EDITOR_BASE_URL=$SERVICE_URL"

마지막으로 이러한 서비스에 대해 OAuth를 설정해야 합니다. https://console.cloud.google.com/auth로 이동하여 다음 단계를 따르세요:

1. 이 Cloud 프로젝트에서 아직 OAuth를 설정하지 않은 경우 표시되는 "Get Started" 버튼이 보이면 클릭하세요.
2. "App Information"에서 원하는 "App Name"과 "User Support Email"을 입력하세요.
3. "Audience"에서, 동일한 Google Workspace 내의 사용자에게만 접근을 허용하려면 "Internal"을 선택하세요. 그렇지 않다면 "External"을 선택할 수 있습니다.
4. "Contact Information"을 입력하세요.
5. "External"을 선택했다면, "Audience"를 클릭하고 접근 권한을 부여해야 할 테스트 사용자를 추가하세요.
6. "Clients" > "Create client"를 클릭하고, "Application type"으로 "Web application"을 선택한 다음, "Authorized JavaScript origins"에 n8n 서비스 URL을 입력하고, "Authorized redirect URIs"에 "/rest/oauth2-credential/callback"을 입력하세요. 여기서 YOUR-N8N-URL 역시 n8n 서비스 URL입니다(예: https://n8n-12345678.us-west1.run.app/rest/oauth2-credential/callback). 나중에 콘솔에서 다시 확인할 수 없는 클라이언트 시크릿이 포함되어 있으므로, 생성된 클라이언트의 JSON 파일을 반드시 다운로드하세요.
7. "Data Access"를 클릭하고 n8n이 접근할 수 있도록 하려는 범위를 추가하세요(예: Google Sheets에 접근하려면 https://googleapis.com/auth/drive.file과 https://googleapis.com/auth/spreadsheets가 필요합니다).
8. 이제 이러한 워크스페이스 서비스를 사용할 수 있습니다. n8n에 로그인하고, 해당 서비스에 대한 도구를 추가한 다음, 6단계에서 받은 OAuth 클라이언트 JSON 파일의 정보를 사용하여 자격 증명을 추가하면 제대로 작동하는지 테스트할 수 있습니다.