GitLab을 Notion에 연결하기

Workers는 Notion의 인프라에서 동기화를 실행합니다. 교체를 설정하려면 Notion AI와의 채팅에서 기존에 동기화된 데이터베이스를 @-멘션하고 GitLab 동기화 스킬을 포함하세요.

다음 항목을 준비하세요:

• Notion에 이미 동기화된 GitLab 데이터베이스. Notion AI가 해당 데이터베이스에 사용 권한이 있는지 확인하세요.

• 포함할 GitLab 프로젝트의 전체 리스트. 프로젝트 URL, 숫자 ID 또는 my-team/my-project와 같은 경로를 제공할 수 있습니다. GitLab에서 프로젝트를 보는 방법 →을 알아보세요.

• read_api 권한이 있고 선택한 모든 프로젝트에 사용 권한이 있는 GitLab 개인 또는 프로젝트 액세스 토큰.

• Workers에 대한 사용 권한 및 Notion AI가 워크스페이스에서 Worker를 생성하고 배포하는 데 필요한 도구.

• Notion 계정에 복사할 이 스킬 페이지: GitLab 가이드: 워커 동기화. 이 스킬은 GitLab.com용입니다. 자체 관리형 GitLab 인스턴스를 사용하는 경우 설정 전에 Notion AI에게 알려주세요. 가이드의 API 주소와 인증서 구성은 인스턴스에 맞게 조정 및 검증이 필요합니다.

기존 동기화 데이터베이스가 있는 워크스페이스에서 Notion AI와 채팅을 시작하세요.

아래 프롬프트를 복사하세요. @를 입력하고 멘션 메뉴에서 실제 데이터베이스를 선택하여 @기존 GitLab 동기화 데이터베이스를 교체하세요. 이슈와 병합 요청이 별도의 동기화 데이터베이스에 있는 경우 둘 다 멘션하세요.

프롬프트에서 실제 데이터베이스 @멘션을 선택하세요. 데이터베이스 이름만 입력하면 Notion AI가 검토할 수 있는 링크가 제공되지 않습니다.

현재 Notion 보기의 필터로 숨겨진 프로젝트를 포함하여 전체 프로젝트 리스트를 확인하세요. 하나의 프로젝트로 제한된 토큰은 다른 프로젝트에 대한 사용 권한도 필요한 동기화에는 충분하지 않습니다.

Notion AI의 지침에 따라 보안 인증서 입력을 통해 GitLab 토큰을 제공하세요. 토큰에는 read_api 권한과 선택한 프로젝트에 대한 사용 권한이 필요합니다.

토큰을 채팅, Notion 페이지 또는 데이터베이스 속성에 붙여넣지 마십시오. Worker는 중개된 인증서를 사용하므로 해당 코드가 원시 토큰을 읽을 필요가 없습니다.

이 설정은 새로운 Worker 인증서를 사용합니다. 기존 GitLab 연결은 이를 자동으로 제공하지 않습니다.

Notion AI가 스킬이나 Worker 도구에 사용 권한이 없는 경우, 해당 사용 권한 문제를 먼저 해결하십시오. 링크된 가이드에는 Notion CLI를 사용할 수 있는 팀원을 위한 에이전트 지침도 포함되어 있습니다.

이 스킬은 다섯 개의 동기화된 데이터베이스와 대시보드가 포함된 개인 GitLab Sync 페이지를 생성합니다:

GitLab 대시보드는 이러한 레코드를 차트와 작업 대기열로 통합합니다. 여기에는 열린 이슈, 열린 병합 요청, 실패한 파이프라인, 최근 릴리스 및 프로젝트 활동이 포함됩니다.

5개의 동기화된 데이터베이스에 녹음이 포함되어 있습니다. 대시보드는 해당 녹음의 보기를 표시합니다. 기존 이슈 또는 병합 요청 데이터베이스는 이 스킬의 기본 설정보다 적은 데이터 유형을 다루었을 수 있습니다.

전환하기 전에 이러한 차이점을 확인하십시오:

• 사용자 및 라벨: 작성자, 담당자 및 라벨은 이 가이드에서 텍스트로 저장됩니다. Notion의 사용자 속성이나 다중 선택 속성이 아닙니다.

• 프로젝트 관계: 이슈, 병합 요청, 파이프라인 및 릴리스는 선택한 프로젝트 녹음에 연결되어야 합니다.

• 녹음 식별: 서로 다른 프로젝트의 녹음은 동일한 프로젝트 로컬 이슈 또는 병합 요청 번호를 사용하더라도 별도로 유지되어야 합니다.

• 추가 콘텐츠: 이 가이드는 이슈 댓글, 병합 요청 토론, 리포지토리 파일 또는 작업 로그를 동기화하지 않습니다. 기존 워크플로에 필요한 추가 필드가 있는지 Notion AI에 평가를 요청하십시오.

Notion AI가 5개의 동기화가 모두 정상이며 초기 가져오기가 완료되었음을 확인할 때까지 기다리십시오.

1. 선택한 각 프로젝트를 GitLab과 비교하십시오. 열린 이슈와 닫힌 이슈, 병합 요청, 파이프라인 및 릴리스 샘플을 확인하십시오.

2. 프로젝트 관계 및 대시보드 보기에 예상한 녹음이 표시되는지 확인하십시오.

3. 성공적인 새로 고침 후 최근 GitLab 변경 사항이 대체 항목에 반영되는지 확인하십시오.

4. 이전 데이터베이스의 사용자 지정 속성과 Notion 전용 값을 Notion AI와 함께 검토하십시오. 안정적인 GitLab 녹음 ID를 사용하여 필요한 항목을 전송하십시오.

5. 대체 항목을 사용해야 하는 링크, 링크된 데이터베이스 보기, 관계 및 자동화를 업데이트하십시오. 새 페이지의 공유 권한을 검토하십시오.

6. 팀에서 대체 항목을 사용하기 시작하면 Notion AI에 요청하여 이전 데이터베이스를 참조용으로 유지하면서 이전 동기화를 중단하십시오.

Worker를 사용하기 위해 이전 데이터베이스를 삭제할 필요는 없습니다. 팀의 정보와 워크플로가 모두 확인될 때까지 보관하십시오.

이 스킬은 데이터 유형별로 하나씩, 총 5개의 시간 단위 동기화를 설정합니다. 다른 데이터베이스가 녹음을 올바른 프로젝트와 연결할 수 있도록 설정 중에 프로젝트가 먼저 동기화됩니다.

성공적으로 새로 고침이 완료될 때마다 구성된 프로젝트의 모든 결과 페이지를 읽고 일치하는 Notion 데이터베이스를 업데이트합니다. Notion이 닫혀 있어도 Worker는 계속 실행됩니다.

업데이트는 GitLab에서 Notion으로 흐릅니다. 동기화된 값은 GitLab에서 변경하십시오. Notion에서 변경한 내용은 다시 기록되지 않습니다.

시간 단위는 일정일 뿐, 모든 새로 고침이 정해진 시간 내에 완료된다는 보장은 없습니다. 프로젝트 기록이 방대하거나 GitLab 요청 제한이 있는 경우 완료가 지연될 수 있습니다.

이 스킬은 개인 페이지 GitLab Sync로 시작합니다. 가져온 녹음을 확인해야 하는 사용자와만 공유하십시오.

Notion의 권한이 동기화된 데이터에 대한 사용 권한을 제어합니다. GitLab 프로젝트의 Visibility 속성이나 이슈의 Confidential 속성은 Notion에서 해당 소스 권한을 강제하지 않습니다. 페이지를 공유하기 전에 토큰에 포함된 데이터를 검토하십시오.

전체 프로젝트 리스트와 토큰 사용 권한을 확인하세요. 경로가 변경된 경우 Notion AI에게 프로젝트의 URL 또는 숫자 ID를 제공하세요. 사용 권한 오류를 해결하기 위해 리스트를 줄여서 실행하지 마세요.

Notion AI에게 프로젝트 선택, 모든 상태의 이슈 및 병합 요청 확인 여부, 그리고 모든 결과 페이지를 확인하도록 요청하세요. Notion 보기의 필터도 함께 확인하세요.

대시보드를 다시 빌드하기 전에 Notion AI에게 소스 데이터베이스, 최신 동기화 결과 및 프로젝트 관계를 확인하도록 요청하세요. 초기 가져오기가 진행 중일 때는 대시보드가 비어 있을 수 있습니다.

Notion AI에게 다른 작업을 수행하기 전에 기존 Worker, 데이터베이스 URL 및 페이지 구조를 검사하도록 요청하세요. 이 스킬을 사용하려면 GitLab Sync 아래에 5개의 실제 동기화된 데이터베이스와 1개의 대시보드가 필요합니다. Notion AI가 중복 항목을 식별하게 한 후 제거하세요.

Notion AI에게 Worker의 최근 실행 기록, 토큰 만료 여부, 토큰 권한, 선택한 모든 프로젝트에 대한 사용 권한을 확인하도록 요청하세요. 자체 관리형 인스턴스의 경우, 구성된 GitLab 호스트도 확인하세요. 요청 제한으로 인해 업데이트가 지연될 수 있습니다.

• 다른 도구의 데이터를 Notion으로 동기화

• Asana 연결