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

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

사전 준비 사항#

n8n에서 소스 컨트롤을 사용하려면 다음 중 하나의 방식을 지원하는 Git 리포지터리가 필요합니다:

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

이 문서는 사용자가 Git 및 사용 중인 Git 제공업체에 익숙하다고 가정합니다.

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

새로 설정하는 경우:

1. n8n에서 사용할 새 리포지터리를 생성합니다.
2. 필요한 브랜치를 생성합니다. 예를 들어 테스트 환경과 프로덕션 환경을 별도로 두려는 경우, 각 환경에 맞는 브랜치를 설정합니다.

사용 사례에 어떤 브랜치가 필요한지 결정하는 데 도움이 필요하면 브랜치 패턴을 참고하세요.

2단계: n8n에서 Git 구성#

3단계: 인증 설정#

선택한 연결 방식에 따라 인증을 구성합니다.

SSH 인증(배포 키 사용)#

n8n의 SSH 키를 사용하여 리포지터리에 대한 배포 키를 생성함으로써 SSH 접근을 설정합니다. 이 키에는 쓰기 권한이 있어야 합니다.

세부 단계는 사용 중인 Git 제공업체에 따라 다릅니다. 주요 제공업체별 도움말 링크는 다음과 같습니다:

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

HTTPS 인증(개인 액세스 토큰 사용)#

리포지터리 접근 권한이 있는 개인 액세스 토큰(PAT)을 생성합니다.

주요 제공업체별 PAT 생성 도움말 링크는 다음과 같습니다:

• GitHub | 개인 액세스 토큰 관리
• GitLab | 개인 액세스 토큰
• Bitbucket | 앱 비밀번호

토큰에 필요한 권한:

• 리포지터리 읽기/쓰기 접근 권한
• Contents 읽기/쓰기(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)**을 선택합니다.