Azure ML Notebook执行ray_env_build_details时遇GIT_DISCOVERY_ACROSS_FILESYSTEM错误

问题根源 #

报错日志显示两个关键失败原因：

• 镜像构建时尝试扫描Git依赖，但当前上下文非Git仓库
• Dockerfile格式不符合预期，触发依赖扫描失败

修复步骤 #

1. 禁用Git依赖扫描（优先推荐） #

Azure ML默认启用Git依赖检测，直接关闭该功能即可绕过此问题：

from azureml.core import Environment

# 加载已创建的Ray环境（替换为你的环境名和工作区对象）
ray_env = Environment.get(workspace=ws, name="ray-environment")
# 添加构建参数禁用Git检测
ray_env.docker.build_args = {"DISABLE_GIT_REPO_DETECTION": "true"}
# 重新注册并触发构建
ray_env_build_details = ray_env.register(workspace=ws)
ray_env_build_details.wait_for_completion(show_output=True)

2. 修复Dockerfile格式 #

如果使用自定义Dockerfile，检查以下内容：

• 确保首行是FROM基础镜像指令，比如FROM mcr.microsoft.com/azureml/openmpi4.1.0-ubuntu20.04
• 避免语法错误，比如指令拼写错误、缺少空格
• 若使用默认环境，重新创建环境以重置Dockerfile：

ray_env = Environment.from_pip_requirements(
    name="ray-environment",
    file_path="requirements.txt"  # 确保此文件存在且格式正确
)
ray_env.docker.base_image = "mcr.microsoft.com/azureml/openmpi4.1.0-ubuntu20.04"
ray_env_build_details = ray_env.register(workspace=ws)
ray_env_build_details.wait_for_completion(show_output=True)

3. 正确初始化Git仓库（可选） #

若必须保留Git依赖扫描，需在Notebook工作目录执行：

cd /path/to/your/notebook/folder
git init
git add .
git commit -m "Initial commit"

注意：此操作需确保构建上下文包含该Git仓库。

验证 #

执行修复步骤后，重新运行ray_env_build_details.wait_for_completion(show_output=True)，确认构建日志无Git和Dockerfile相关错误。

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