Compose: propiedades especificadas por el usuario y / o dónde almacenar los metadatos (autor, descripción)

Con los archivos de la versión 1, tengo dos comentarios al comienzo del archivo docker-compose:

# author: Anthon van der Neut <[email protected]>
# description: mongo container

que luego extraigo en dc2service usando ruamel.yaml e incluyo esta información en el archivo de servicio para Systemd / Upstart. Por supuesto, podría seguir el principio YACF (Otro archivo de configuración más) que se ve tan a menudo en los proyectos de Python, pero con 1.6.0 y el formato de archivo de la versión 2.0, podría hacer fácilmente:

version: '2'
user-data:
  author: Anthon van der Neut <[email protected]>
  description: mongo container
services:
   .......

Desafortunadamente, docker-compose queja de que user-data es una propiedad adicional inesperada.

Para el mapeo de nivel superior en la versión 2, propongo que obtengamos una o más claves reservadas para datos específicos del usuario, con el único requisito de que el valor correspondiente sea una construcción YAML válida, es decir, todo el archivo permanece analizable YAML. Esta podría ser una clave, con la recomendación de que su valor correspondiente sea un mapeo (por flexibilidad), o alternativamente, docker-compose podría ignorar todas las claves de nivel superior que tengan un prefijo determinado ("datos de usuario-")

Algo similar se hace, por ejemplo, en formatos de archivo contenedor como TIFF para permitir la inclusión de información adicional (específica del proveedor). El nombre de esa clave, por supuesto, debería ser algo que ciertamente no se usará en docker-compose, por lo que "datos de usuario", "datos que no son de CC".

Los desarrolladores de docker-compose siempre pueden seleccionar la información que consideren útil para otros proyectos (con suerte, como mi autor / descripción) y decidir que se inserten bajo alguna otra propiedad, o tal vez incluso garantizar su propia propiedad de nivel superior.