YAML 中隐藏的可重用块

Question

我正在尝试在 docker-compose.yml 文件中定义可重用块，使可重用块定义本身不包含在最终（评估的）YAML 中。

我知道如何用这种语法定义一个可重用的块：

services:
  default: &default
    image: some/image

  dashboard:
    <<: *default
    command: run dashboard
    ports: ["3000:3000"]

但是，上面还在服务下创建了一个名为default 的条目，我想避免这种情况。换句话说，我需要最终的 YAML 结果只在 services 属性下包含 dashboard。

这可以用 YAML 实现吗？我找不到任何足够清楚地讨论此结构的参考资料。

直觉上，我尝试了以下的一些变体，但也没有奏效。

services:
  &default:
    image: some/image

  dashboard:
    <<: *default
    command: run dashboard
    ports: ["3000:3000"]

Answer 1

这在 YAML 1.2（或任何以前的版本）中是不可能的。这背后的原因是 YAML 被设计为一种序列化语言，而不是一种配置语言。

Anchor/Alias 结构非常适合序列化循环数据结构。它从未打算用于声明将在多个地方使用的变量。因此，目前，创建可在多个地方使用的可重用结构的唯一方法是在使用它的第一个地方定义结构。例如：

services:
  dashboard:
    <<: &default
      image: some/image
    command: run dashboard
    ports: ["3000:3000"]
  some_other_service:
    <<: *default
    other_props: ...

另外，请注意合并键 << 不是 YAML 规范的一部分，仅定义为 YAML 1.1 的附加功能。它没有为 YAML 1.2 定义，将在即将推出的 YAML 1.3 中明确弃用。

我们（例如：目前从事 YAML 1.3 工作的人）已经意识到这个缺失的功能，并计划为 YAML 1.3 提供更好的解决方案。

Answer 2

Docker Compose 文件格式 3.4 添加了对扩展字段的支持：以 x- 开头的顶级键被 Docker Compose 和 Docker 引擎忽略。

例如：

version: '3.4'
x-default: &default
  image: some/image
services:
  dashboard:
    <<: *default
    command: run dashboard
    ports: ["3000:3000"]

来源：King Chung Huang https://link.medium.com/N5DFdiC3F0 的“不要在 Docker Compose 文件中重复使用锚点、别名和扩展名”