VSCode Remote-Container配置databricksruntime镜像时的启动错误问题

问题1：databricksruntime/dbfsfuse:experimental镜像不存在 #

databricksruntime/dbfsfuse的官方镜像仓库里没有experimental这个标签，直接导致构建失败。解决步骤：

• 确认该镜像的有效标签（比如latest或具体版本号）
• 修改Dockerfile里的镜像引用，把databricksruntime/dbfsfuse:experimental替换成存在的标签，比如databricksruntime/dbfsfuse:latest

问题2：容器内无vscode用户导致启动失败 #

用root用户运行容器不符合合规要求，正确做法是在容器内创建vscode用户，有两种方式：

方式1：在Dockerfile中手动创建用户 #

在Dockerfile里添加以下代码，创建带sudo权限的vscode用户：

# 创建vscode用户并生成家目录
RUN useradd -m vscode && \
    # 给vscode用户添加无密码sudo权限
    echo "vscode ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/vscode && \
    # 设置sudo配置文件权限
    chmod 0440 /etc/sudoers.d/vscode

如果镜像里没有sudo工具，先加一行安装命令：

RUN apt-get update && apt-get install -y sudo

方式2：通过devcontainer.json自动创建用户 #

在devcontainer.json中添加以下配置，让VSCode自动创建并匹配vscode用户：

"remoteUser": "vscode",
"updateRemoteUserUID": true,
"containerUser": "vscode"

注意：如果镜像缺少基础用户管理工具，还是需要先在Dockerfile里安装sudo和useradd相关包。

完整配置示例 #

修改后的Dockerfile #

FROM databricksruntime/dbfsfuse:latest

# 安装必要工具（按需添加）
RUN apt-get update && apt-get install -y sudo

# 创建vscode用户
RUN useradd -m vscode && \
    echo "vscode ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/vscode && \
    chmod 0440 /etc/sudoers.d/vscode

devcontainer.json配置 #

{
    "name": "Databricks Runtime Dev Container",
    "build": {
        "dockerfile": "Dockerfile"
    },
    "remoteUser": "vscode",
    "updateRemoteUserUID": true
}

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