GitHub 워크플로우 연동 가이드

GIIP 플랫폼과 GitHub 저장소를 연결하여 소스 코드 변경 사항을 모니터링하고 인프라 작업과 연동하는 방법을 안내합니다.

🔄 GitHub 워크플로우 페이지로 이동 →

📋 개요

GitHub 워크플로우 연동을 통해 시스템 관리자와 개발자는 인프라의 변화가 어떤 코드 변경에서 기인했는지 쉽게 파악할 수 있습니다. GIIP 내에서 직접 GitHub의 커밋 이력과 Pull Request 상태를 확인할 수 있어 업무 컨텍스트 전환을 최소화합니다.

🔍 주요 기능

1. 저장소(Repository) 연결

OAuth 인증: GitHub 계정을 연동하여 접근 가능한 저장소 목록을 가져옵니다.
프로젝트 맵핑: 특정 GitHub Repo를 GIIP 내의 프로젝트와 연결하여 자산(서버 등)과 코드를 매칭시킵니다.

2. 실시간 Webhook 알림

이벤트 수집: Push, Pull Request, Release 등의 이벤트가 발생하면 GIIP 이슈 관리 시스템에 자동으로 기록됩니다.
자동 이슈 업데이트: 특정 커밋 메시지에 GIIP 이슈 번호를 포함하면(예:
```
fix #123
```
), 해당 이슈의 상태가 자동으로 업데이트됩니다.

3. CI/CD 및 코드 품질 연동

Action 상태 확인: GitHub Actions의 빌드 및 배포 성공 여부를 GIIP 대시보드에서 즉시 확인합니다.
보안 스캔 결과: 코드 내 보안 취약점 스캔 결과(Dependabot 등)를 GIIP 보안 센터와 공유합니다.

🛠️ 설정 방법

GIIP [환경 설정] > [GitHub 연동] 메뉴로 이동합니다.
[Connect GitHub] 버튼을 눌러 권한을 승인합니다.
연동할 저장소를 선택하고 [프로젝트 할당]을 완료합니다.
필요 시 Webhook URL을 복사하여 GitHub Repo 설정에 추가합니다.

💡 활용 팁

장애 원인 추적: 서버 부하가 급증한 시점에 어떤 코드가 머지되었는지 GitHub 이력 탭에서 즉시 대조해 보세요.
협업 강화: 인프라 변경이 필요한 PR의 경우, GIIP의 에이전트 작업 결과 링크를 PR 코멘트에 남겨 리뷰 효율을 높이세요.

API 참조

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 GitHub 연동 API 가이드

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:

giipv3/public/help/github-workflow.ko.md