GitLab
n8n v2.47요약
GitLab 제공자는 환경을 GitLab.com 또는 셀프 호스팅 GitLab 인스턴스의 리포지터리에 연결합니다. Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. n8n에는 GitLab 토큰 하나가 필요합니다.
GitLab 제공자는 환경을 GitLab.com 또는 셀프 호스팅 GitLab 인스턴스의 리포지터리에 연결합니다. 리포지터리와 브랜치 목록을 보여 주며, n8n에서 시각적으로 검토하는 머지 리퀘스트 기반 프로모션 리뷰를 지원합니다.
Preview 상태
Environments는 Preview 상태이며 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 인스턴스에 설정하기 전에 테스트 인스턴스에서 먼저 사용해 보세요.
GitLab이 지원하는 기능#
| 기능 | 지원 여부 |
|---|---|
| 인증 | 액세스 토큰 |
| 목록에서 리포지터리와 브랜치 선택 | 예 |
| 프로모트할 때마다 기능 브랜치로 푸시 | 예, 머지 리퀘스트와 함께 |
| 프로모션 리뷰 | 예: n8n에 동기화된 GitLab 머지 리퀘스트를 Reviews에서 변경 사항의 시각적 diff로 확인 |
액세스 토큰 생성#
n8n에는 GitLab 토큰 하나가 필요합니다. 클래식 액세스 토큰 또는 세분화된(fine-grained) 개인 액세스 토큰 중 하나를 생성합니다. 어느 쪽을 선택하든 토큰의 사용자는 리포지터리에서 최소한 Developer 역할이 있어야 합니다. n8n은 사용자가 해당 역할을 가진 리포지터리만 나열하기 때문입니다. 프로모션 리뷰를 보호된 브랜치에 머지하려면 사용자에게 브랜치 보호가 머지를 허용하는 역할도 필요하며, 기본값은 Maintainer입니다.
클래식 액세스 토큰#
api 및 write_repository 범위를 가진 개인, 그룹 또는 프로젝트 액세스 토큰을 생성합니다. 그룹 액세스 토큰은 퇴사할 수 있는 개인에게 묶이지 않으므로 n8n에서는 그룹 액세스 토큰을 권장합니다.
세분화된 개인 액세스 토큰#
사용 중인 GitLab 버전이 지원하는 경우 세분화된 개인 액세스 토큰을 사용합니다.
- GitLab에서 새 세분화된 개인 액세스 토큰을 시작합니다. GitLab 문서의 세분화된 개인 액세스 토큰을 참조하세요.
- Group and project access에서 Only specific groups or projects that I'm a member of를 선택하고 리포지터리의 프로젝트 또는 해당 그룹을 추가합니다.
- Add resource permissions에서 다음 표의 모든 리소스를 추가하고 각 리소스의 권한을 선택합니다. 토큰에는 모든 항목이 필요합니다. 리소스 선택기에서 각 리소스는 Resource access 탭과 카테고리 아래에 있습니다.
- Generate token을 선택하고 토큰을 복사합니다.
| Resource access 탭 | 카테고리 | 리소스 | 권한 | n8n의 사용 목적 |
|---|---|---|---|---|
| User | System Access | User | Read | 토큰 확인 |
| User | Projects | Project | Read | 리포지터리 목록 조회 |
| Group and project | Repository | Branch | Create, Read, Delete | 브랜치 목록 조회, 기능 브랜치 푸시, 머지 후 브랜치 삭제 |
| Group and project | Repository | Code | Download, Push | 리포지터리에서 읽기 및 리포지터리로 푸시 |
| Group and project | Repository | Merge Request | Create, Read, Approve, Merge | 프로모션 리뷰 생성, 승인, 머지 |
| Group and project | Project Planning | Work Item | Create, Read | 머지 리퀘스트에 승인 노트 추가 및 코멘트 읽기 |
GitLab 제공자 설정#
- Connect GitLab 대화 상자에서 Name,
https://gitlab.com또는https://gitlab.example.com같은 GitLab base URL, Access token을 입력합니다. - Continue를 선택합니다.
- 환경 설정에서 목록의 Repository와 Branch를 선택합니다.
내부 네트워크에 있거나 사설 인증 기관을 사용하는 셀프 호스팅 GitLab 인스턴스는 Git 기반 프로모션을 참조하세요.
머지 리퀘스트를 사용한 프로모션 리뷰#
프로모션을 머지 리퀘스트로 검토하려면 프로모트 대상 환경에서 Open a merge request in GitLab을 켭니다. 검토 및 승인 방법은 GitLab을 사용한 프로모션 리뷰를 참조하세요.