GitHub Workflow Integration Guide
Learn how to connect the GIIP platform with GitHub repositories to monitor source code changes and integrate them with infrastructure tasks.
📋 Overview
GitHub Workflow integration allows system administrators and developers to easily identify which code changes led to infrastructure shifts. By viewing GitHub commit history and Pull Request statuses directly within GIIP, you can minimize context switching.
🔍 Key Features
1. Repository Connection
- OAuth Authentication: Connect your GitHub account to retrieve a list of accessible repositories.
- Project Mapping: Link specific GitHub Repos to projects within GIIP to match code with assets (servers, etc.).
2. Real-time Webhook Notifications
- Event Collection: Events such as Pushes, Pull Requests, and Releases are automatically recorded in the GIIP Issue Management system.
- Automatic Issue Updates: Including a GIIP issue number in a commit message (e.g.,
fix #123) will automatically update the status of that issue.
3. CI/CD & Code Quality Integration
- Action Status Verification: Instantly check the success or failure of GitHub Actions builds and deployments from the GIIP dashboard.
- Security Scan Results: Share scan results for security vulnerabilities in code (e.g., Dependabot) with the GIIP Security Center.
🛠️ Setup Steps
- Navigate to the GIIP [Environment Settings] > [GitHub Integration] menu.
- Click the [Connect GitHub] button to authorize permissions.
- Select the repository to integrate and complete the [Project Assignment].
- If necessary, copy the Webhook URL and add it to your GitHub Repo settings.
💡 Tips
- Failure Root Cause Tracking: When server load spikes, check the GitHub history tab immediately to see what code was merged at that time.
- Enhanced Collaboration: For PRs requiring infrastructure changes, improve review efficiency by leaving a link to a GIIP agent work result in the PR comment.
API Reference
For detailed API specifications of this feature, refer to the separate guide.
Troubleshooting
| Symptom | Cause | Solution |
|---|---|---|
| The list of repositories to integrate does not appear | GitHub OAuth authentication or permission authorization is not complete | Click the [Connect GitHub] button to re-authorize permissions. |
| The GIIP issue status does not update automatically after a commit | The commit message does not include an issue number (e.g., fix #123) | Include the issue number in the correct format in the commit message and commit again. |
| Push/PR events are not recorded in GIIP | The Webhook URL is not registered in the GitHub Repo | Copy the Webhook URL from the settings screen and add it to your GitHub Repo settings. |
| GitHub Actions status does not appear on the dashboard | The repository is not assigned to a GIIP project | Select the repository and complete the [Project Assignment]. |
Version: 1.0
Last Updated: 2026-03-19
Source: giipv3/public/help/github-workflow.en.md