InfoGrab DocsInfoGrab Docs

Git 기반 프로모션

요약

Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. n8n은 프로모트된 콘텐츠를 리포지터리 루트의 n8n/ 폴더에 저장합니다.

Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. 각 환경은 하나의 리포지터리와 브랜치입니다.

Note

Preview 상태

Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용하는 것이 좋습니다.

n8n이 리포지터리에 기록하는 내용#

n8n은 프로모트된 콘텐츠를 리포지터리 루트의 n8n/ 폴더에 저장합니다. 이 폴더에는 n8n 패키지가 들어 있습니다. n8n은 프로모트할 때 패키지를 내보내고, 적용할 때 패키지를 가져옵니다. n8n은 해당 폴더 밖의 내용은 변경하지 않으므로, 리포지터리에 CI 구성 같은 다른 파일을 함께 둘 수 있습니다.

직접 커밋과 기능 브랜치#

설정에 따라 인스턴스가 변경 사항을 프로모트하는 환경은 다음 중 하나로 동작합니다.

  • 해당 브랜치에 직접 커밋합니다.
  • 프로모트할 때마다 해당 브랜치를 기반으로 한 n8n-promotion/<timestamp> 이름의 기능 브랜치로 푸시합니다. n8n은 강제 푸시(force-push)를 하지 않습니다. 기능 브랜치를 사용하는 경우 환경의 브랜치가 Git 호스트에 이미 있어야 합니다.

해당 환경에서 변경 사항을 적용하는 인스턴스는 환경의 브랜치를 읽으므로, 기능 브랜치의 변경 사항은 누군가 머지한 뒤에야 볼 수 있습니다.

제공자#

제공자는 n8n이 Git 호스트에 연결하고 인증하는 데 사용하는 세부 정보를 담고 있습니다. 한 인스턴스의 여러 환경이 같은 제공자를 사용할 수 있습니다. 제공자 유형에 따라 사용할 수 있는 기능이 달라집니다.

기능 Generic Git GitLab
인증 SSH 키, 또는 사용자 이름과 액세스 토큰 액세스 토큰
목록에서 리포지터리와 브랜치 선택 아니요 예
프로모션 리뷰 아니요 예: n8n에 동기화된 GitLab 머지 리퀘스트와 Reviews의 변경 사항 시각적 diff

GitHub, Bitbucket 및 기타 Git 호스트는 Generic Git을 통해 사용할 수 있으며, 리포지터리 목록과 프로모션 리뷰는 제공되지 않습니다.

셀프 호스팅 n8n#

  • GitLab 인스턴스가 내부 네트워크에 있다면 SSRF 보호에서 N8N_SSRF_ALLOWED_HOSTNAMES 또는 N8N_SSRF_ALLOWED_IP_RANGES로 GitLab API 호출을 허용합니다.
  • Git 호스트가 사설 인증 기관(CA)의 인증서를 사용한다면 Git에는 GIT_SSL_CAINFO 또는 GIT_SSL_CAPATH를 설정하고, API 호출에는 사용자 지정 인증 기관을 구성합니다.
  • 상세 로그를 얻으려면 N8N_LOG_SCOPES=promotions를 설정합니다.

문제 해결#

Could not complete the Git operation#

다음을 확인합니다.

  • 제공자의 인증 정보가 올바르고 만료되지 않았습니다.
  • SSH의 경우 배포 키(deploy key)에 쓰기 권한이 있습니다.
  • Git 호스트에 해당 브랜치가 있습니다.
  • 리포지터리 URL이 인증 유형에 맞는 형식입니다. Generic Git을 참고합니다.

이 섹션의 내용#

  • Generic Git: SSH 또는 HTTPS로 모든 Git 리포지터리에 연결합니다.
  • GitLab: 액세스 토큰으로 GitLab에 연결하고, 프로모션을 머지 리퀘스트로 검토합니다.

관련 리소스#

Git 기반 프로모션

n8n v2.47
원문 보기

요약

Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. n8n은 프로모트된 콘텐츠를 리포지터리 루트의 n8n/ 폴더에 저장합니다.

Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. 각 환경은 하나의 리포지터리와 브랜치입니다.

Note

Preview 상태

Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용하는 것이 좋습니다.

n8n이 리포지터리에 기록하는 내용#

n8n은 프로모트된 콘텐츠를 리포지터리 루트의 n8n/ 폴더에 저장합니다. 이 폴더에는 n8n 패키지가 들어 있습니다. n8n은 프로모트할 때 패키지를 내보내고, 적용할 때 패키지를 가져옵니다. n8n은 해당 폴더 밖의 내용은 변경하지 않으므로, 리포지터리에 CI 구성 같은 다른 파일을 함께 둘 수 있습니다.

직접 커밋과 기능 브랜치#

설정에 따라 인스턴스가 변경 사항을 프로모트하는 환경은 다음 중 하나로 동작합니다.

  • 해당 브랜치에 직접 커밋합니다.
  • 프로모트할 때마다 해당 브랜치를 기반으로 한 n8n-promotion/<timestamp> 이름의 기능 브랜치로 푸시합니다. n8n은 강제 푸시(force-push)를 하지 않습니다. 기능 브랜치를 사용하는 경우 환경의 브랜치가 Git 호스트에 이미 있어야 합니다.

해당 환경에서 변경 사항을 적용하는 인스턴스는 환경의 브랜치를 읽으므로, 기능 브랜치의 변경 사항은 누군가 머지한 뒤에야 볼 수 있습니다.

제공자#

제공자는 n8n이 Git 호스트에 연결하고 인증하는 데 사용하는 세부 정보를 담고 있습니다. 한 인스턴스의 여러 환경이 같은 제공자를 사용할 수 있습니다. 제공자 유형에 따라 사용할 수 있는 기능이 달라집니다.

기능 Generic Git GitLab
인증 SSH 키, 또는 사용자 이름과 액세스 토큰 액세스 토큰
목록에서 리포지터리와 브랜치 선택 아니요 예
프로모션 리뷰 아니요 예: n8n에 동기화된 GitLab 머지 리퀘스트와 Reviews의 변경 사항 시각적 diff

GitHub, Bitbucket 및 기타 Git 호스트는 Generic Git을 통해 사용할 수 있으며, 리포지터리 목록과 프로모션 리뷰는 제공되지 않습니다.

셀프 호스팅 n8n#

  • GitLab 인스턴스가 내부 네트워크에 있다면 SSRF 보호에서 N8N_SSRF_ALLOWED_HOSTNAMES 또는 N8N_SSRF_ALLOWED_IP_RANGES로 GitLab API 호출을 허용합니다.
  • Git 호스트가 사설 인증 기관(CA)의 인증서를 사용한다면 Git에는 GIT_SSL_CAINFO 또는 GIT_SSL_CAPATH를 설정하고, API 호출에는 사용자 지정 인증 기관을 구성합니다.
  • 상세 로그를 얻으려면 N8N_LOG_SCOPES=promotions를 설정합니다.

문제 해결#

Could not complete the Git operation#

다음을 확인합니다.

  • 제공자의 인증 정보가 올바르고 만료되지 않았습니다.
  • SSH의 경우 배포 키(deploy key)에 쓰기 권한이 있습니다.
  • Git 호스트에 해당 브랜치가 있습니다.
  • 리포지터리 URL이 인증 유형에 맞는 형식입니다. Generic Git을 참고합니다.

이 섹션의 내용#

  • Generic Git: SSH 또는 HTTPS로 모든 Git 리포지터리에 연결합니다.
  • GitLab: 액세스 토큰으로 GitLab에 연결하고, 프로모션을 머지 리퀘스트로 검토합니다.

관련 리소스#