Lib2GitSharp在Docker中触发mmap Permission denied报错如何解决？

针对当前LibGit2Sharp报错的修复方案 #

• 关闭libgit2的mmap功能
  无需修改底层实现，可直接在克隆时传入配置项禁用mmap，示例代码如下：

  var cloneOptions = new CloneOptions
  {
      CredentialsProvider = (url, usernameFromUrl, types) => 
          new UsernamePasswordCredentials 
          { 
              Username = "git", 
              Password = token 
          },
      // 新增配置关闭mmap
      RepositoryConfiguration = new RepositoryConfiguration
      {
          { "core.useMmap", "false" }
      }
  };
  Repository.Clone(gitServer, path, cloneOptions);
  

• 切换LibGit2Sharp正式版本
  你当前使用的0.27.0-preview为未正式发布的预览版本，存在大量不稳定的原生绑定问题，建议降级到官方正式发布的0.26.2版本，可自动匹配debian 9的原生依赖，无需手动配置LD_LIBRARY_PATH环境变量。
• 调整Docker运行配置
  1. 若/mountedfeatures为宿主机挂载目录，可在docker run的挂载参数后添加z/Z标签，修复SELinux上下文权限问题：-v 宿主机路径:/mountedfeatures:z
  2. 可临时添加--user root参数启动容器，排除容器默认用户（www-data）的权限不足问题，注意生产环境需按需配置合理的用户权限。
• 补充镜像依赖
  在Dockerfile的base阶段添加git运行时依赖，修复缺失的系统级依赖问题：

  FROM mcr.microsoft.com/dotnet/aspnet:5.0-buster-slim AS base
  RUN apt update && apt install -y --no-install-recommends git libgit2-27
  # 其余原有配置
  

可替代的.NET平台Git类库推荐 #

• CliWrap封装原生Git命令：稳定性最高的方案，通过调用系统安装的原生Git命令行完成所有操作，完全避开LibGit2Sharp的原生绑定问题。只需在Dockerfile中安装git包，即可通过CliWrap快速封装克隆、推送等所有Git操作，支持所有Git原生特性。
• Git-Cmd：轻量级的Git命令行封装库，已预制了绝大多数常用Git操作的封装方法，无需手动拼接命令行参数，上手成本低，兼容性强。
• LibGit2Sharp.NativeBinaries：官方维护的LibGit2原生二进制独立包，若需继续使用LibGit2Sharp的编程接口，可单独引用该包，自动适配不同系统的原生依赖，无需手动处理动态库路径配置。

内容的提问来源于stack exchange，提问作者Chris Surfleet