본문으로 건너뛰기

GitHub 통합

자동 분석을 위해 GitHub 저장소를 연결하세요.

기능​

  • 자동 인덱싱 메인 브랜치에 푸시할 때
  • 풀 리퀘스트 분석 아키텍처 피드백 포함
  • Webhook 알림 분석 결과용

설정​

1단계: GitHub 연결​

  1. ArchiCore로 이동
  2. 프로젝트 추가 → GitHub 탭 클릭
  3. GitHub 연결 클릭
  4. ArchiCore가 저장소에 액세스하도록 승인

2단계: 저장소 선택​

  1. 저장소 검색
  2. 브랜치 선택 (보통 main 또는 master)
  3. 옵션 활성화:
    • 푸시 시 자동 분석 - 매 푸시마다 인덱싱
    • 풀 리퀘스트 분석 - PR에 코멘트

3단계: 구성 (선택사항)​

저장소에 .archicore/config.json 생성:

{
  "github": {
    "autoIndex": true,
    "analyzePRs": true,
    "branches": ["main", "develop"]
  }
}

풀 리퀘스트 분석​

활성화되면 ArchiCore가 PR에 코멘트:

  • 아키텍처 영향 - 변경으로 영향받는 파일
  • 복잡성 변화 - 복잡성이 증가한 경우
  • 보안 경고 - 새로 도입된 취약점
  • 모범 사례 - 개선 제안

필요한 권한​

권한이유
코드 읽기코드 분석을 위해
PR 읽기풀 리퀘스트 분석을 위해
PR 코멘트 쓰기결과 게시를 위해
Webhooks푸시 알림 수신을 위해

연결 해제​

GitHub 연결을 해제하려면:

  1. 설정 → 연결된 계정으로 이동
  2. GitHub 옆의 연결 해제 클릭

문제 해결​

"저장소를 찾을 수 없음"​

  • 저장소가 비공개가 아닌지 확인하거나
  • 비공개 저장소 액세스로 ArchiCore 재인증

"Webhook이 실행되지 않음"​

  1. GitHub → 저장소 → 설정 → Webhooks로 이동
  2. ArchiCore webhook 상태 확인
  3. 실패한 전달 확인