推送受限问题

代码库文件推送大小限制

概览：为了保证系统性能与稳定性，云效对单个文件上传设定了明确的大小限制，并针对不同推送方式提供了相应的指导。

• Web上传限制：单个文件不得超过50MB。

• 命令行上传限制：单个文件不得超过200MB。

• 大文件处理建议：对于超过限制的二进制大文件，请参阅Codeup Git LFS 功能简介了解如何正确管理。

常见问题及解决方案：

• 推送单个大文件报错：如果收到“object exceeds maximum allowed size”的错误提示，说明文件超过了允许的最大尺寸，推荐使用Git LFS来管理大文件。

• 推送数据量大失败：若因整体数据量过大导致HTTPS推送失败，建议切换至SSH协议尝试。

• 推送和克隆超时时间：推送操作超时时间为60分钟，克隆为30分钟。如果遇到超时问题，检查仓库大小和网络状况是关键。

详情，请参见代码库文件推送是否有大小限制？

代码推送的限流阈值

背景：为了保障服务公平性和资源合理分配，云效平台对用户账号和SSH Key设置了推送限流规则。

• 用户账号限流：每个用户最多同时推拉10个仓库。

• SSH Key限流：同一SSH Key每分钟最多调用50次API接口。

这些限制有助于维持系统的稳定运行，同时也提醒用户合理规划并发操作，避免不必要的冲突或延迟。详情，请参见代码推送的限流阈值是多少？

修改提交历史信息

场景描述：在版本控制实践中，有时需要调整已有的提交记录，比如修正拼写错误、移除敏感信息或优化提交日志格式等。具体操作，请参见如何修改提交历史信息 ？

操作指南：

• 修改最后一次提交注释：简单地使用git commit --amend命令即可更新最近一次提交的信息。

• 修改多个提交信息：利用交互式变基（git rebase -i）功能可以一次性编辑多条历史记录，但需谨慎对待已推送至远程仓库的变更，以免造成混淆。

• 修改提交作者/邮箱：无论是单独还是批量更改提交者信息，都可以通过上述变基方式结合特定参数完成。此外，对于大规模的历史修订，建议使用专门工具如git-filter-repo进行高效处理。

• 本地预设自检规则：为了避免频繁修改历史带来的麻烦，推荐使用Git钩子（githooks）机制，在本地提前实施预期的提交规则检查，确保所有推送内容均符合规范要求。

使用git-filter-repo修改 Commit 历史

工具介绍：git-filter-repo是一个官方推荐的强大工具，用于高效且安全地修改Git仓库中的提交历史，包括但不限于替换提交者邮箱、编辑提交消息等高级操作。具体操作，请参见git-filter-repo。

安装与配置：

• 依赖条件：确保您的环境满足最低版本要求（git >= 2.22.0， python3 >= 3.5），并按照官方文档指引完成安装。

• 执行示例：以下是一些常用的命令模板，展示了如何运用Python回调函数实现精准的历史修改。例如，将某分支上的部分提交邮箱后缀由alibaba-inc.com改为example.com，或者在指定范围内添加前缀到提交消息中。

  # 修改邮箱示例
  git-filter-repo --email-callback 'return email.replace(b"alibaba-inc.com", b"example.com")' --force --refs master~2..master
  
  # 修改提交消息示例 最近 1 次提交的 message 已经从原来的“3”变成了“hi”
  git-filter-repo --message-callback 'return message.replace(b"3", b"hi")' --force --refs master~1..master
  
  # 添加前缀示例，最近 1 次提交message之前加上“bugfix: ”
  git-filter-repo --message-callback 'message=b"bugfix: " + message return message' --refs master~1..master --force

注意事项：每次修改都会生成新的提交ID，因此建议先创建备份分支保存当前状态，再执行实际的修改命令。

希望以上内容能帮助您更好地理解和应对云效平台上推送受限的各种情况。如果您还有其他疑问或需要进一步的帮助，请随时联系我们。