需配置github个人访问令牌、在mulerun导入仓库并绑定令牌、设置webhook实现自动同步、配置分支与环境映射、可选ssh密钥替代pat以提升安全性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在MuleRun中实现与GitHub仓库的代码同步与管理联动，则需要完成身份验证、仓库授权及Webhook配置等关键步骤。以下是完成此配置的具体操作流程：
一、配置GitHub个人访问令牌（PAT）
GitHub已弃用基于用户名密码的Git操作，MuleRun需通过个人访问令牌进行身份认证，该令牌将作为Git克隆、推送和拉取操作的身份凭证。
1、登录GitHub账户，进入Settings > Developer settings > Personal access tokens > Tokens (classic)。
2、点击Generate new token > Generate new token (classic)。
3、填写Note字段（如“MuleRun-integration”），勾选以下权限：repo（完整仓库权限）、admin:org_hook（用于管理Webhook）、delete_repo（如需自动清理测试分支）。
4、点击Generate token按钮，立即复制生成的令牌字符串，关闭页面后将无法再次查看。
二、在MuleRun中添加GitHub源代码仓库
MuleRun支持通过Git URL方式导入项目，需手动输入仓库地址并绑定已生成的PAT，以建立安全连接。
1、登录MuleRun控制台，进入Projects > Create New Project > Import from Git Repository。
2、在Repository URL字段中填入GitHub仓库的HTTPS地址（例如：https://github.com/username/my-mule-app.git）。
3、在Authentication Type下拉菜单中选择Personal Access Token。
4、在Token字段中粘贴此前复制的GitHub PAT，确保不包含任何前后空格或换行符。
5、点击Validate Connection，确认显示“Connection successful”后，继续完成项目创建。
三、配置GitHub Webhook实现变更自动同步
Webhook使GitHub能在代码推送、分支创建或Pull Request触发时，向MuleRun发送HTTP通知，从而驱动自动化构建与部署流程。
1、进入GitHub仓库主页，点击Settings > Webhooks > Add webhook。
2、在Payload URL字段中填入MuleRun提供的Webhook接收端点（格式通常为：https://api.mulerun.io/v1/webhook/github），该地址可在MuleRun项目设置页的Integrations > GitHub Webhook区域获取。
3、Content type选择application/json。
4、勾选“Just the push event”或根据需要启用“Pull requests”、“Branches & tags”等事件类型。
5、点击Add webhook，保存后立即测试：向仓库推送一次空提交（git commit --allow-empty -m "test webhook" && git push）以验证响应状态。
四、设置MuleRun分支策略与环境映射
MuleRun支持将GitHub分支与运行环境（如dev/staging/prod）绑定，确保不同分支的代码自动部署至对应环境实例。
1、在MuleRun项目内，进入Environments > Branch Mapping。
2、点击Add Mapping，输入GitHub分支名称（如main、develop、feature/login）。
3、为每个分支选择目标环境（例如：main → prod，develop → staging）。
4、启用Auto-deploy on push选项，该设置将使每次推送到匹配分支的操作立即触发构建与部署流水线。
五、启用SSH密钥替代PAT（可选高安全性方案）
对于企业级部署或对凭证安全性要求更高的场景，可使用SSH密钥对替代PAT，避免令牌泄露风险，并支持细粒度仓库级权限控制。
1、在本地终端执行ssh-keygen -t ed25519 -C "mulerun@company.com"，生成密钥对，默认路径为~/.ssh/id_ed25519。
2、将公钥内容（cat ~/.ssh/id_ed25519.pub）添加至GitHub账户的SSH and GPG keys设置中。
3、在MuleRun导入仓库时，改用SSH URL（如：git@github.com:username/my-mule-app.git）。
4、在MuleRun侧配置SSH私钥：进入Project Settings > Secrets > Add Secret，Key设为GIT_SSH_KEY，Value粘贴私钥全文（含-----BEGIN OPENSSH PRIVATE KEY-----起止行），务必勾选“Hide value in logs”并确认私钥未被截断或格式化。
