InfoGrab DocsInfoGrab Docs

Generic Git

요약

Generic Git 제공자는 GitHub와 Bitbucket의 리포지터리를 포함해 URL로 지정한 모든 Git 리포지터리에 환경을 연결합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다.

Generic Git 제공자는 GitHub와 Bitbucket의 리포지터리를 포함해 URL로 지정한 모든 Git 리포지터리에 환경을 연결합니다. SSH 키 또는 사용자 이름과 액세스 토큰으로 인증합니다.

Note

Preview 상태

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

Generic Git이 지원하는 기능#

기능 지원 여부
인증 SSH 키, 또는 사용자 이름과 액세스 토큰
목록에서 리포지터리와 브랜치 선택 아니요. 리포지터리 URL과 브랜치를 직접 입력합니다.
프로모트할 때마다 기능 브랜치로 푸시 예
프로모션 리뷰 아니요. 누군가 Git 호스트에서 기능 브랜치를 수동으로 머지해야 합니다.

SSH 키로 연결#

  1. Connect Generic Git 대화 상자에서 Name을 입력하고 Authentication을 SSH key로 설정합니다.
  2. SSH key type을 선택합니다. n8n이 키 쌍을 생성합니다.
  3. Continue를 선택한 다음 Copy deploy key를 선택합니다.
  4. Git 호스트에서 쓰기 권한이 있는 배포 키(deploy key)로 리포지터리에 해당 키를 추가합니다.

Bitbucket Cloud는 읽기 전용 리포지터리 액세스 키만 제공하므로, Bitbucket Cloud에는 사용자 이름과 액세스 토큰으로 연결하거나 리포지터리 대신 Bitbucket 계정에 배포 키를 추가합니다. 계정 키는 n8n에 해당 계정이 접근할 수 있는 모든 리포지터리에 대한 접근 권한을 부여하므로 전용 계정을 사용하는 것이 좋습니다.

Warning

ssh://git@github.com/acme/n8n.git처럼 ssh://로 시작하는 SSH 리포지터리 URL을 사용합니다. Environments (Classic)에서 허용되던 git@github.com:acme/n8n.git 형식은 동작하지 않습니다.

키를 교체하려면 제공자를 편집하고 Generate a new key를 선택합니다. 새 키를 Git 호스트에 추가한 다음 이전 키를 Git 호스트에서 제거합니다.

사용자 이름과 액세스 토큰으로 연결#

  1. Connect Generic Git 대화 상자에서 Name을 입력하고 Authentication을 Username and password로 설정합니다.
  2. Username을 입력하고, Password or access token에는 리포지터리에 대한 쓰기 권한이 있는 액세스 토큰을 입력합니다.
  3. Continue를 선택합니다.

https://github.com/acme/n8n.git처럼 자격 증명이 포함되지 않은 HTTPS 리포지터리 URL을 사용합니다.

토큰에 필요한 권한#

Generic Git은 Git 명령만 실행합니다. Git 호스트의 API는 호출하지 않습니다. 토큰에는 리포지터리 코드에 대한 읽기 및 쓰기 권한이 필요합니다. 프로모트할 때마다 기능 브랜치로 푸시한다면 브랜치를 생성할 권한도 필요합니다.

주요 Git 호스트별 설정은 다음과 같습니다.

Git 호스트 사용자 이름 토큰
GitHub GitHub 사용자 이름 Contents: Read and write 권한이 있는 해당 리포지터리용 세분화된(fine-grained) 개인 액세스 토큰. 브랜치 생성 권한도 포함됩니다.
GitLab GitLab 사용자 이름 write_repository 스코프가 있는 개인, 그룹 또는 프로젝트 액세스 토큰. 세분화된 개인 액세스 토큰에는 Code: Download, Push와 Branch: Create를 추가합니다.
Bitbucket Cloud Bitbucket 사용자 이름 read:repository:bitbucket과 write:repository:bitbucket 스코프가 있는 API 토큰.

제공자의 인증 방식은 변경할 수 없습니다. 인증 방식을 바꾸려면 다른 제공자를 생성합니다.

관련 리소스#

Generic Git

n8n v2.47
원문 보기

요약

Generic Git 제공자는 GitHub와 Bitbucket의 리포지터리를 포함해 URL로 지정한 모든 Git 리포지터리에 환경을 연결합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다.

Generic Git 제공자는 GitHub와 Bitbucket의 리포지터리를 포함해 URL로 지정한 모든 Git 리포지터리에 환경을 연결합니다. SSH 키 또는 사용자 이름과 액세스 토큰으로 인증합니다.

Note

Preview 상태

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

Generic Git이 지원하는 기능#

기능 지원 여부
인증 SSH 키, 또는 사용자 이름과 액세스 토큰
목록에서 리포지터리와 브랜치 선택 아니요. 리포지터리 URL과 브랜치를 직접 입력합니다.
프로모트할 때마다 기능 브랜치로 푸시 예
프로모션 리뷰 아니요. 누군가 Git 호스트에서 기능 브랜치를 수동으로 머지해야 합니다.

SSH 키로 연결#

  1. Connect Generic Git 대화 상자에서 Name을 입력하고 Authentication을 SSH key로 설정합니다.
  2. SSH key type을 선택합니다. n8n이 키 쌍을 생성합니다.
  3. Continue를 선택한 다음 Copy deploy key를 선택합니다.
  4. Git 호스트에서 쓰기 권한이 있는 배포 키(deploy key)로 리포지터리에 해당 키를 추가합니다.

Bitbucket Cloud는 읽기 전용 리포지터리 액세스 키만 제공하므로, Bitbucket Cloud에는 사용자 이름과 액세스 토큰으로 연결하거나 리포지터리 대신 Bitbucket 계정에 배포 키를 추가합니다. 계정 키는 n8n에 해당 계정이 접근할 수 있는 모든 리포지터리에 대한 접근 권한을 부여하므로 전용 계정을 사용하는 것이 좋습니다.

Warning

ssh://git@github.com/acme/n8n.git처럼 ssh://로 시작하는 SSH 리포지터리 URL을 사용합니다. Environments (Classic)에서 허용되던 git@github.com:acme/n8n.git 형식은 동작하지 않습니다.

키를 교체하려면 제공자를 편집하고 Generate a new key를 선택합니다. 새 키를 Git 호스트에 추가한 다음 이전 키를 Git 호스트에서 제거합니다.

사용자 이름과 액세스 토큰으로 연결#

  1. Connect Generic Git 대화 상자에서 Name을 입력하고 Authentication을 Username and password로 설정합니다.
  2. Username을 입력하고, Password or access token에는 리포지터리에 대한 쓰기 권한이 있는 액세스 토큰을 입력합니다.
  3. Continue를 선택합니다.

https://github.com/acme/n8n.git처럼 자격 증명이 포함되지 않은 HTTPS 리포지터리 URL을 사용합니다.

토큰에 필요한 권한#

Generic Git은 Git 명령만 실행합니다. Git 호스트의 API는 호출하지 않습니다. 토큰에는 리포지터리 코드에 대한 읽기 및 쓰기 권한이 필요합니다. 프로모트할 때마다 기능 브랜치로 푸시한다면 브랜치를 생성할 권한도 필요합니다.

주요 Git 호스트별 설정은 다음과 같습니다.

Git 호스트 사용자 이름 토큰
GitHub GitHub 사용자 이름 Contents: Read and write 권한이 있는 해당 리포지터리용 세분화된(fine-grained) 개인 액세스 토큰. 브랜치 생성 권한도 포함됩니다.
GitLab GitLab 사용자 이름 write_repository 스코프가 있는 개인, 그룹 또는 프로젝트 액세스 토큰. 세분화된 개인 액세스 토큰에는 Code: Download, Push와 Branch: Create를 추가합니다.
Bitbucket Cloud Bitbucket 사용자 이름 read:repository:bitbucket과 write:repository:bitbucket 스코프가 있는 API 토큰.

제공자의 인증 방식은 변경할 수 없습니다. 인증 방식을 바꾸려면 다른 제공자를 생성합니다.

관련 리소스#