2 min read

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 가이드

문제 해결

증상	원인	해결
연동할 저장소 목록이 나타나지 않는다	GitHub OAuth 인증 또는 권한 승인이 완료되지 않음	[Connect GitHub] 버튼을 눌러 권한을 다시 승인합니다.
커밋해도 GIIP 이슈 상태가 자동으로 변경되지 않는다	커밋 메시지에 이슈 번호(예: `fix #123`)가 포함되지 않음	커밋 메시지에 올바른 형식으로 이슈 번호를 포함시켜 다시 커밋합니다.
Push/PR 이벤트가 GIIP에 기록되지 않는다	GitHub Repo에 Webhook URL이 등록되지 않음	설정 화면의 Webhook URL을 복사해 GitHub Repo 설정에 추가합니다.
GitHub Actions 상태가 대시보드에 보이지 않는다	저장소가 GIIP 프로젝트에 할당되지 않음	저장소 선택 후 [프로젝트 할당]을 완료합니다.

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일: giipv3/public/help/github-workflow.ko.md

Back to OverviewKnowledge Center