Git 리포지터리를 n8n 인스턴스에 연결하고 소스 컨트롤을 설정합니다.

n8n은 환경을 제공하기 위해 소스 컨트롤을 사용합니다. 자세한 내용은 n8n의 환경을 참조하세요.

사전 요구 사항#

n8n에서 소스 컨트롤을 사용하려면 다음이 있는 Git 리포지터리가 필요합니다:

• SSH 접근 (배포 키 사용), 또는
• HTTPS 접근 (개인 접근 토큰 사용)

이 문서에서는 Git과 Git 제공업체에 익숙하다고 가정합니다.

1단계: 리포지터리와 브랜치 설정#

새로운 설정의 경우:

1. n8n과 함께 사용할 새 리포지터리를 만듭니다.
2. 필요한 브랜치를 만듭니다. 예를 들어 테스트 및 프로덕션을 위한 다른 환경을 계획하는 경우 각각에 대한 브랜치를 설정합니다.

사용 사례에 필요한 브랜치를 결정하는 데 도움이 되는 내용은 브랜치 패턴을 참조하세요.

2단계: n8n에서 Git 설정#

1. 설정 > 환경으로 이동합니다.
2. 연결 방법을 선택합니다:
   • SSH: Git 저장소 URL에 저장소의 SSH URL을 입력합니다 (예: git@github.com:username/repo.git).
   • HTTPS: Git 저장소 URL에 저장소의 HTTPS URL을 입력합니다 (예: https://github.com/username/repo.git).
3. 연결 방법에 따라 인증을 구성합니다:
   • SSH의 경우: n8n은 ED25519 및 RSA 공개 키 알고리즘을 지원합니다. ED25519가 기본값입니다. Git 호스트에서 RSA가 필요한 경우 SSH 키 아래에서 RSA를 선택합니다. SSH 키를 복사합니다.
   • HTTPS의 경우: 자격 증명을 입력합니다:
     • 사용자 이름: Git 제공업체의 사용자 이름.
     • 토큰: Git 제공업체의 개인 액세스 토큰(PAT).

3단계: 인증 설정#

선택한 연결 방법에 따라 인증을 설정합니다.

SSH 인증 (배포 키 사용)#

n8n의 SSH 키를 사용하여 리포지터리의 배포 키를 만들어 SSH 접근을 설정합니다. 키에는 쓰기 접근 권한이 있어야 합니다.

단계는 Git 제공업체에 따라 다릅니다. 일반적인 제공업체의 도움말 링크:

• GitHub | 배포 키 관리
• GitLab | 배포 키

HTTPS 인증 (개인 접근 토큰 사용)#

리포지터리 접근 권한이 있는 개인 접근 토큰(PAT)을 만듭니다.

일반적인 제공업체에서 PAT를 만드는 도움말 링크:

• GitHub | 개인 접근 토큰 관리
• GitLab | 개인 접근 토큰
• Bitbucket | 앱 비밀번호

토큰에 필요한 권한:

• 리포지터리 읽기/쓰기 접근
• 콘텐츠 읽기/쓰기 (GitHub의 경우)
• 소스 코드 Pull/Push (GitLab의 경우)

4단계: n8n 연결 및 인스턴스 설정#

1. n8n의 Settings > Environments에서 Connect를 선택합니다. n8n이 Git 리포지터리에 연결됩니다.
2. Instance settings 아래에서 현재 n8n 인스턴스에 사용할 브랜치를 선택합니다.
3. 선택 사항: Protected instance를 선택하여 사용자가 이 인스턴스에서 소스 컨트롤로 관리되는 리소스를 편집하지 못하도록 합니다. 프로덕션 인스턴스를 보호하는 데 유용합니다.
4. 선택 사항: 인스턴스에 대한 커스텀 색상을 선택합니다. 소스 컨트롤 Push 및 Pull 버튼 옆 메뉴에 표시됩니다. 사용자가 자신이 어떤 인스턴스에 있는지 알 수 있도록 도와줍니다.
5. Save settings를 선택합니다.