services.Jenkins Additional property tags is not allowed

今天需要给Jenkins server添加几个tag，于是就在docker的compose文件中添加了如下的tags，

version: "3.9" 

services:
  jenkins:
    image: test
    build: 
      context: services/jenkins
      args:
        - jenkins_version=2.346.2
        - plugin_cli_version=2.9.3
    volumes:
      - jenkins-home:/var/jenkins_home
    ports:
      - 443:443
	enviroments:
		- JAVA_OPT=-XMx4096m
tags:
	project: test_project
	maintainer: [email protected]

添加之后，再执行以下docker命令：

docker stack deploy -c docker-compose.yml testtags

得到的错误是：

services.Jenkins Additional property tags is not allowed

查阅了很多信息，得到错误的解决方案可能如下：

1） 在tags前面加一个空行，就可以解决了。没有空行的话，可能会把tags认为是services.Jenkins的属性；

2） 有些属性是跟版本有关的，有些版本里不支持，有些版本里支持。如果不支持的元素出现在了compose 文件里，也会报类似的：Additional property xxx is not allowed的错误。 例如：在3.x里添加runtime，也会报类似错误，如果上面的代码改成如下：

version: "3.9" 

services:
  jenkins:
    image: test
    runtime: testx-runc
    build: 
      context: services/jenkins
      args:
        - jenkins_version=2.346.2
        - plugin_cli_version=2.9.3
    volumes:
      - jenkins-home:/var/jenkins_home
    ports:
      - 443:443
	enviroments:
		- JAVA_OPT=-XMx4096m

tags:
	project: test_project
	maintainer: [email protected]

原因就是：docker compose schema version 3.x 没有runtime: 元素。所以不能识别这个属性。

总之，如果出现Additional property xxx is not allowed，就可能有两种原因：第一、属性不支持，需要考虑是否切换版本，或者使用新版本支持的属性；第二、属性的位置不对。

具体版本支持哪些元素，可以参考：https://docs.docker.com/compose/compose-file/03-compose-file/。