これは、docker-compose.ymlでのドキュメントに無い機能でしょうか？

Question

railsアプリをdockerで作成中で
rails本体と、sidekiqを立ち上げるdockerイメージの設定を共通化しようと調べています。
ちょっと質問に答えていただければ

まず最初に、本家のドキュメントを調べで出てきた方法で、common.ymlなどの他のファイルに設定を切り分けることができのを見つけました。

https://docs.docker.jp/compose/extends.html

こういうふうに書けばやりたいことは実現できました。

version: '3'
services:
  # app、sidekiq共通の構築設定
  app:
    build:
      context: .
      dockerfile: dockerfiles/app/Dockerfile
    environment:
      DATABASE_URL: "mysql2://---"
      REDIS_URL: "redis://redis:6379/"
      DB_HOST: 'db'
      DB_REPLICA_HOST: 'db'

version: '3'
services:
  app:
    extends:
      file: common.yml
      service: app
    command: bundle exec rails s
    ports:
      - 3000:3000
    depends_on:
      - db
      - redis
  sidekiq:
    extends:
      file: common.yml
      service: app
    command: bundle exec sidekiq
    depends_on:
      - db
      - redis

問題はここからなんですが、x-という接頭語をつければ、docker-compose.ymlの中でも共通の設定を書けるのを知ったのですが
これって、何処かドキュメントのあるものなんでしょうか？

例としては以下のようなものです。

version: '3'
# ms-app、sidekiq共通の構築設定
x-app: &app-template
  build:
    context: .
    dockerfile: dockerfiles/app/Dockerfile
  environment:
    DATABASE_URL: "mysql2://root@db:3306/db_name
    REDIS_URL: "redis://redis:6379/"
    DB_HOST: 'db'
    DB_REPLICA_HOST: 'db'
  depends_on:
    - db
    - redis
services:
  app:
    <<: *app-template
    command: bundle exec rails s
    ports:
      - 3000:3000
  sidekiq:
    <<: *app-template
    command: bundle exec sidekiq

自分はアンカー貼れないか試しに書いてみたところ、以下のメッセージが出て気づきました。

> docker-compose up -d
ERROR: The Compose file './docker-compose.yml' is invalid because:
'app' does not match any of the regexes: '^x-'

どこかにドキュメントがあって、隠し機能になっていないなら、使って行こうかと考えています。

Answer 1

Extension fields????Added in version 3.4 file format.

まず最初に、本家のドキュメントを調べで出てきた方法で、common.ymlなどの他のファイルに設定を切り分けることができのを見つけました。

質問の一番下に書いた例と併せて.envでも使うのが良いんじゃないかと思いますが、思想次第ですね