buildMountOptions warns "should not define `bind` option" for named volumes carrying only an SELinux relabel flag, which compose itself consumes
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
从 buildMountOptions() 开始,该函数在 mount 的类型为 volume 且 Bind 非 nil 时触发警告。检查 buildContainerVolumes() 和 toBindString() 如何为命名卷使用 v.Bind.SELinux,使警告只跳过 Bind 仅设置 SELinux 的情况。对于 propagation 和 create_host_path 等其他 Bind 字段,保留警告。完成标准是:带 z/Z 的命名卷挂载不产生警告,而带其他 Bind 字段的卷挂载仍会警告,并由 buildMountOptions 的测试覆盖。
由索引模型根据 Issue 内容生成。
描述
Description
A named-volume mount written with the documented short syntax vol:/path:z
canonicalises to type: volume + bind: {selinux: z}; bind.selinux is the
compose model's only slot for a relabel flag (volume: {selinux: z} is a schema
error, so there is no long-syntax alternative). buildMountOptions() then warns
unconditionally on volume.Type != VolumeTypeBind && volume.Bind != nil,
so every such mount emits a warning on every container create.
The warning is a false positive here, because compose itself consumes the
option it is warning about: two functions later buildContainerVolumes()
routes plain named-volume mounts through the legacy HostConfig.Binds string
API via toBindString(), which appends v.Bind.SELinux (the modern Mounts
API cannot express relabels). Support for bind.selinux on named volumes was
added deliberately in compose-spec/compose-go#213 (fixing #9072, where the
flags were silently dropped). So the configuration is correct, compose honours
it, and the user is told it is wrong.
Steps to reproduce
services:
probe:
image: busybox:latest
command: ["true"]
volumes:
- probevol:/data:z,rw
volumes:
probevol:
docker compose up prints, once per z/Z-flagged named-volume mount per create:
time="..." level=warning msg="mount of type `volume` should not define `bind` option"
docker inspect confirms the flag was honoured:
Binds: ["proj_probevol:/data:rw,z"].
Expected
No warning when the bind: struct on a type: volume mount sets only
selinux, since that field is both the sole supported spelling and one compose
acts on. A bind: struct setting other fields (propagation,
create_host_path) on a volume mount should keep warning.
Impact
On SELinux-enforcing hosts the flags are load-bearing, so the warning cannot be
avoided by dropping them, and --log-level error suppresses all warnings rather
than this one. Deployment tooling ends up filtering the line out of compose's
stderr. It also breaks machine-readable output for downstream consumers:
ansible-collections/community.docker#846 is the same line failing an event
parser.
Versions
Reproduced on Compose v5.1.3 / Engine 29.4.1 (2026-07-19) and Compose v5.5.0 /
Engine 29.7.2 (2026-09-06). buildMountOptions() on main is unchanged.
- 主要语言
- Go
- 星标
- 38.9k
- 派生
- 6k
- 平均合并
- 2 天 22 小时
- 30 天内合并 PR
- 81
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
docker/compose 的其他 Issue
-
[BUG] `docker compose port` prints `:0` (exit 0) for a port the image exposes but the service does not publish可能已有人在做 @ndeloof 于 1 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
[BUG] deploy.restart_policy without condition drops the restart policy可能重新可做 @akshat-lakhera 于 25 天前认领,目前没有进行中的 PR。 未关闭
难度 2/5 1-3 小时 新手友好度 82/100
docker/compose#14383 · 3 条评论 ·
维护者通常 1 天内回复
-
[BUG] up: an optional (required: false) service_healthy dependent is not started when a required dependent shares the failing wait可能已有人在做 @ndeloof 于 2 天前认领。 未关闭
难度 4/5 3-5 天 新手友好度 58/100
docker/compose#14507 · 2 条评论 ·
维护者通常 1 天内回复
-
[BUG] Negative replica count in scale flags (docker compose scale / --scale) is accepted without validation可能已有人在做 @arsalanyavari 于 8 天前认领。 未关闭kind/bug status/approved
难度 2/5 1-3 小时 新手友好度 30/100
维护者通常 1 天内回复
-
[BUG] pre_stop hooks are skipped when up or scale stops a container可能已有人在做 @htoyoda18 于 11 天前认领。 未关闭kind/bug status/approved
难度 4/5 3-5 天 新手友好度 53/100
维护者通常 1 天内回复
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 86/100
fluxcd/notification-controller#1441 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
OneBusAway/maglev#2145 ·
维护者通常 2 天内回复
-
priority/medium status/ready type/chore
难度 2/5 1-3 小时 新手友好度 84/100
discobox-ai/discobox#1357 ·
维护者通常 1 天内回复
-
TestPseudoLocaleRemote fails now and then: it types the code before the laptop asks for it可能已有人在做 @fzn0x 今天认领。 未关闭bug priority: low
难度 2/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
-
edit_file diff rendering panics on invalid UTF-8 text可能已有人在做 @TDnorthgarden 今天认领。 未关闭area/tui
难度 2/5 1-3 小时 新手友好度 85/100
docker/docker-agent#4955 ·
维护者通常 1 天内回复