Git 기반 프로모션
n8n v2.47요약
Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. n8n은 프로모트된 콘텐츠를 리포지터리 루트의 n8n/ 폴더에 저장합니다.
Git 기반 프로모션에서는 변경 사항이 Git 리포지터리를 통해 n8n 인스턴스 사이를 이동합니다. 각 환경은 하나의 리포지터리와 브랜치입니다.
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에 연결하고, 프로모션을 머지 리퀘스트로 검토합니다.