docker-composer 4.0.2

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at tudvari@tudvari.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tibor Udvari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,74 @@
+# docker-composer
+
+Generate Docker Compose descriptor from a JSON document.
+
+![Node.js CI](https://github.com/tudvari/docker-composer/workflows/Node.js%20CI/badge.svg)
+[![npm version](https://badge.fury.io/js/docker-composer.svg)](https://badge.fury.io/js/docker-composer)
+
+## About the package
+
+The reason behind this package is support the Docker Compose descriptor generation from Javascript. You are able to use all Docker Compose keyword to describe your containers and services.
+
+
+Docker Compose Reference is [HERE](https://docs.docker.com/compose/compose-file/).
+
+###  Changes of the Latest Release
+
+## Version 4.0.2 (27.09.2021)
+- Maintenance release, dependency updates
+
+You can find all Release Notes [HERE](https://github.com/tudvari/docker-composer/blob/master/ReleaseNotes.md).
+
+## Usage
+
+```javascript
+
+  const composer = require('docker-composer')
+    .
+  var generatedYML = composer.generate( inputJSON )
+```
+
+## Full Example
+
+### Input
+
+```json
+{
+"version" : "3",
+"services" :
+    {
+        "nginx" : {
+            "ports" : [
+                "80"
+                        ],
+            "image" : "nginx:latest"
+        },
+        "http" : {
+            "ports" : [
+                "443"
+            ],
+            "image" : "apache:latest"
+        }
+    }
+}
+```
+### Result
+```yml
+---
+  version: "3"
+  services:
+    nginx:
+      ports:
+      - "80"
+      image: "nginx:latest"
+    http:
+      ports:
+      - "443"
+      image: "nginx:latest"
+```
+
+### License
+
+Copyright (c) 2015 Tibor Udvari. Released under the MIT license. See [LICENSE](https://github.com/tudvari/docker-composer/blob/master/LICENSE) for details.
+
+

package/ReleaseNotes.md

@@ -0,0 +1,102 @@
+# Release Notes
+
+## Version 4.0.2 (27.09.2021)
+- Maintenance release, dependency updates
+
+## Version 4.0.1 (31.03.2021)
+- Maintenance release, dependency updates
+
+## Version 4.0.0 (31.12.2020)
+- Typescript type definitions
+
+## Version 3.1.13 (23.10.2020)
+- Maintenance release, dependency updates
+
+## Version 3.1.12 (17.10.2020)
+- Maintenance release, dependency updates
+
+## Version 3.1.11 (11.10.2020)
+- Maintenance release, dependency updates
+
+## Version 3.1.10 (08.10.2020)
+- Maintenance release, dependency updates
+
+## Version 3.1.9 (30.09.2020)
+- Maintenance release, dependency updates
+
+## Version 3.1.8 (02.04.2020)
+- Dependency update
+
+## Version 3.1.7 (21.03.2020)
+- Vulnerable dependency update
+    * More details: https://github.com/advisories/GHSA-7fhm-mqm4-2wp7
+
+#### Version 3.1.6 (2019.12.01)
+- Update dependencies
+
+#### Version 3.1.5 (2019.11.24)
+- Update dependencies
+- Use nyc instead of istanbul
+- Published package optimalization
+
+#### Version 3.1.4 ( 2019.07.11)
+- Update dependencies for security reason
+
+#### Version 3.1.3 ( 2019.06.05)
+- Update dependencies
+
+## Version 3.1.2 ( 2019.01.06)
+- Update dependencies
+
+## Version 3.1.1 ( 2018.12.12 )
+- Schema loading fix (thanks for andrepurnomo)
+
+## Version 3.1.0 ( 2018.12.09 )
+- Introduce JSON schema for input validation
+- Version 3 Compose file format support
+
+## Version 3.0.1 (2018.04.15)
+- Remove npm package from dependencies.
+
+## Version 3.0.0 (2018.04.15)
+- Change from callback to Promise for async/await support.
+
+## Version 2.0.2 (2017.12.29)
+- Refresh dependencies.
+
+## Version 2.0.1 (2017.01.03)
+- Code Quality improvements, new eslint ruleset, editorconfig, etc..
+
+## Version 2.0.0 (2016.05.03)
+- Tons of new implemented keywords many thanks to Alex.
+
+## Version 1.0.7 (2016.04.29)
+
+- Fixed a bug that was preventing the docker-compose to read array/object variables from the generated YML file
+- New implemented keywords: volumes
+
+## Version 1.0.6 (2015.11.08)
+
+- New implemented keywords: cpu_shares
+
+## Version 1.0.5 (2015.10.29)
+
+- New implemented keywords: mem_limit, memswap_limit
+
+## Version 1.0.4 (2015.10.21)
+
+- Small fixes
+
+## Version 1.0.3 (2015.10.21)
+
+- New implemented keywords: dns, dns_search
+
+## Version 1.0.2 (2015.10.20)
+
+- Small js fixes
+- New implemented keywords: expose, command
+
+## Version 1.0.0 and Version 1.0.1 (2015.10.14)
+
+- First public version released
+- Supported keywords: ports, environment, extra_hosts, image

package/index.d.ts

@@ -0,0 +1,270 @@
+export type DefinitionsDeployment = {
+  mode?: string;
+  replicas?: number;
+  labels?: Labels;
+  update_config?: {
+    parallelism?: number;
+    delay?: string;
+    failure_action?: string;
+    monitor?: string;
+    max_failure_ratio?: number;
+  };
+  resources?: {
+    limits?: DefinitionsResource;
+    reservations?: DefinitionsResource;
+  };
+  restart_policy?: {
+    condition?: string;
+    delay?: string;
+    max_attempts?: number;
+    window?: string;
+  };
+  placement?: {
+    constraints?: string[];
+  };
+} & ({
+  mode?: string;
+  replicas?: number;
+  labels?: Labels;
+  update_config?: {
+    parallelism?: number;
+    delay?: string;
+    failure_action?: string;
+    monitor?: string;
+    max_failure_ratio?: number;
+  };
+  resources?: {
+    limits?: DefinitionsResource;
+    reservations?: DefinitionsResource;
+  };
+  restart_policy?: {
+    condition?: string;
+    delay?: string;
+    max_attempts?: number;
+    window?: string;
+  };
+  placement?: {
+    constraints?: string[];
+  };
+} | null);
+export type Labels =
+  | {
+      /**
+       * This interface was referenced by `undefined`'s JSON-Schema definition
+       * via the `patternProperty` ".+".
+       */
+      [k: string]: string;
+    }
+  | string[];
+export type ListOrDict =
+  | {
+      /**
+       * This interface was referenced by `undefined`'s JSON-Schema definition
+       * via the `patternProperty` ".+".
+       */
+      [k: string]: string | number | null;
+    }
+  | string[];
+export type ListOfStrings = string[];
+export type StringOrList = string | ListOfStrings;
+/**
+ * This interface was referenced by `PropertiesNetworks`'s JSON-Schema definition
+ * via the `patternProperty` "^[a-zA-Z0-9._-]+$".
+ */
+export type DefinitionsNetwork = {
+  driver?: string;
+  driver_opts?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^.+$".
+     */
+    [k: string]: string | number;
+  };
+  ipam?: {
+    driver?: string;
+    config?: {
+      subnet?: string;
+    }[];
+  };
+  external?:
+    | boolean
+    | {
+        name?: string;
+      };
+  internal?: boolean;
+  labels?: Labels;
+} & ({
+  driver?: string;
+  driver_opts?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^.+$".
+     */
+    [k: string]: string | number;
+  };
+  ipam?: {
+    driver?: string;
+    config?: {
+      subnet?: string;
+    }[];
+  };
+  external?:
+    | boolean
+    | {
+        name?: string;
+      };
+  internal?: boolean;
+  labels?: Labels;
+} | null);
+/**
+ * This interface was referenced by `PropertiesVolumes`'s JSON-Schema definition
+ * via the `patternProperty` "^[a-zA-Z0-9._-]+$".
+ */
+export type DefinitionsVolume = {
+  driver?: string;
+  driver_opts?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^.+$".
+     */
+    [k: string]: string | number;
+  };
+  external?:
+    | boolean
+    | {
+        name?: string;
+      };
+  labels?: Labels;
+} & ({
+  driver?: string;
+  driver_opts?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^.+$".
+     */
+    [k: string]: string | number;
+  };
+  external?:
+    | boolean
+    | {
+        name?: string;
+      };
+  labels?: Labels;
+} | null);
+
+export interface ConfigSchemaV30Json {
+  version: string;
+  services?: PropertiesServices;
+  networks?: PropertiesNetworks;
+  volumes?: PropertiesVolumes;
+}
+export interface PropertiesServices {
+  [k: string]: DefinitionsService;
+}
+/**
+ * This interface was referenced by `PropertiesServices`'s JSON-Schema definition
+ * via the `patternProperty` "^[a-zA-Z0-9._-]+$".
+ */
+export interface DefinitionsService {
+  deploy?: DefinitionsDeployment;
+  build?:
+    | string
+    | {
+        context?: string;
+        dockerfile?: string;
+        args?: ListOrDict;
+      };
+  cap_add?: string[];
+  cap_drop?: string[];
+  cgroup_parent?: string;
+  command?: string | string[];
+  container_name?: string;
+  depends_on?: ListOfStrings;
+  devices?: string[];
+  dns?: StringOrList;
+  dns_search?: StringOrList;
+  domainname?: string;
+  entrypoint?: string | string[];
+  env_file?: StringOrList;
+  environment?: ListOrDict;
+  expose?: (string | number)[];
+  external_links?: string[];
+  extra_hosts?: ListOrDict;
+  healthcheck?: DefinitionsHealthcheck;
+  hostname?: string;
+  image?: string;
+  ipc?: string;
+  labels?: Labels;
+  links?: string[];
+  logging?: {
+    driver?: string;
+    options?: {
+      /**
+       * This interface was referenced by `undefined`'s JSON-Schema definition
+       * via the `patternProperty` "^.+$".
+       */
+      [k: string]: string | number | null;
+    };
+  };
+  mac_address?: string;
+  network_mode?: string;
+  networks?:
+    | ListOfStrings
+    | {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-zA-Z0-9._-]+$".
+         */
+        [k: string]: {
+          aliases?: ListOfStrings;
+          ipv4_address?: string;
+          ipv6_address?: string;
+        } | null;
+      };
+  pid?: string | null;
+  ports?: (string | number)[];
+  privileged?: boolean;
+  read_only?: boolean;
+  restart?: string;
+  security_opt?: string[];
+  shm_size?: number | string;
+  sysctls?: ListOrDict;
+  stdin_open?: boolean;
+  stop_grace_period?: string;
+  stop_signal?: string;
+  tmpfs?: StringOrList;
+  tty?: boolean;
+  ulimits?: {
+    /**
+     * This interface was referenced by `undefined`'s JSON-Schema definition
+     * via the `patternProperty` "^[a-z]+$".
+     */
+    [k: string]:
+      | number
+      | {
+          hard: number;
+          soft: number;
+        };
+  };
+  user?: string;
+  userns_mode?: string;
+  volumes?: string[];
+  working_dir?: string;
+}
+export interface DefinitionsResource {
+  cpus?: string;
+  memory?: string;
+}
+export interface DefinitionsHealthcheck {
+  disable?: boolean;
+  interval?: string;
+  retries?: number;
+  test?: string | string[];
+  timeout?: string;
+}
+export interface PropertiesNetworks {
+  [k: string]: DefinitionsNetwork;
+}
+export interface PropertiesVolumes {
+  [k: string]: DefinitionsVolume;
+}

package/index.js

@@ -0,0 +1,18 @@
+const fs = require('fs')
+const path = require('path')
+const YAML = require('json2yaml')
+const Validator = require('jsonschema').Validator
+const v = new Validator()
+
+function generateCompose ( inputJSON ) {
+	let schema = JSON.parse(fs.readFileSync(path.resolve(__dirname, './schema.json')))
+
+	if ( !v.validate(inputJSON, schema).valid )
+		throw new Error('Invalid input!')
+
+	return YAML.stringify( inputJSON )
+}
+
+module.exports = {
+	generate: generateCompose
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "docker-composer",
+  "version": "4.0.2",
+  "description": "NodeJS module for generating docker-compose.yml from a json document.",
+  "main": "index.js",
+  "scripts": {
+    "test": "./node_modules/mocha/bin/mocha *Test.js",
+    "coverage": "nyc npm run test",
+    "generate-ts-types": "./node_modules/gulp-cli/bin/gulp.js"
+  },
+  "keywords": [
+    "gulp",
+    "docker",
+    "compose",
+    "docker-compose.yml"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tudvari/docker-composer.git"
+  },
+  "author": {
+    "name": "Tibor Udvari",
+    "email": "tudvari@tudvari.com"
+  },
+  "contributors": [
+    {
+      "name": "Alex Lamba (@laalex)",
+      "email": "alex@codesilk.com",
+      "url": "https://github.com/laalex"
+    }
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "json2yaml": "^1.1.0",
+    "jsonschema": "^1.4.0"
+  },
+  "devDependencies": {
+    "ansi-regex": "^5.0.1",
+    "atob": ">=2.1.2",
+    "eslint": "7.32.0",
+    "gulp": "^4.0.2",
+    "gulp-cli": "^2.3.0",
+    "js-yaml": "^4.0.0",
+    "json-schema-to-typescript": "^10.1.4",
+    "mixin-deep": ">=2.0.1",
+    "mocha": "9.1.2",
+    "nyc": "^15.1.0",
+    "set-value": "^4.0.1",
+    "should": "13.2.3"
+  },
+  "nyc": {
+    "all": true,
+    "exclude": [
+      "*Test.js"
+    ]
+  }
+}

package/schema.json

@@ -0,0 +1,399 @@
+{
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "id": "config_schema_v3.0.json",
+    "type": "object",
+    "required": ["version"],
+
+    "properties": {
+      "version": {
+        "type": "string"
+      },
+
+      "services": {
+        "id": "#/properties/services",
+        "type": "object",
+        "patternProperties": {
+          "^[a-zA-Z0-9._-]+$": {
+            "$ref": "#/definitions/service"
+          }
+        },
+        "additionalProperties": false
+      },
+
+      "networks": {
+        "id": "#/properties/networks",
+        "type": "object",
+        "patternProperties": {
+          "^[a-zA-Z0-9._-]+$": {
+            "$ref": "#/definitions/network"
+          }
+        }
+      },
+
+      "volumes": {
+        "id": "#/properties/volumes",
+        "type": "object",
+        "patternProperties": {
+          "^[a-zA-Z0-9._-]+$": {
+            "$ref": "#/definitions/volume"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+
+    "additionalProperties": false,
+
+    "definitions": {
+
+      "service": {
+        "id": "#/definitions/service",
+        "type": "object",
+
+        "properties": {
+          "deploy": {"$ref": "#/definitions/deployment"},
+          "build": {
+            "oneOf": [
+              {"type": "string"},
+              {
+                "type": "object",
+                "properties": {
+                  "context": {"type": "string"},
+                  "dockerfile": {"type": "string"},
+                  "args": {"$ref": "#/definitions/list_or_dict"}
+                },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "cap_add": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "cap_drop": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "cgroup_parent": {"type": "string"},
+          "command": {
+            "oneOf": [
+              {"type": "string"},
+              {"type": "array", "items": {"type": "string"}}
+            ]
+          },
+          "container_name": {"type": "string"},
+          "depends_on": {"$ref": "#/definitions/list_of_strings"},
+          "devices": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "dns": {"$ref": "#/definitions/string_or_list"},
+          "dns_search": {"$ref": "#/definitions/string_or_list"},
+          "domainname": {"type": "string"},
+          "entrypoint": {
+            "oneOf": [
+              {"type": "string"},
+              {"type": "array", "items": {"type": "string"}}
+            ]
+          },
+          "env_file": {"$ref": "#/definitions/string_or_list"},
+          "environment": {"$ref": "#/definitions/list_or_dict"},
+
+          "expose": {
+            "type": "array",
+            "items": {
+              "type": ["string", "number"],
+              "format": "expose"
+            },
+            "uniqueItems": true
+          },
+
+          "external_links": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "extra_hosts": {"$ref": "#/definitions/list_or_dict"},
+          "healthcheck": {"$ref": "#/definitions/healthcheck"},
+          "hostname": {"type": "string"},
+          "image": {"type": "string"},
+          "ipc": {"type": "string"},
+          "labels": {"$ref": "#/definitions/labels"},
+          "links": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+
+          "logging": {
+              "type": "object",
+
+              "properties": {
+                  "driver": {"type": "string"},
+                  "options": {
+                    "type": "object",
+                    "patternProperties": {
+                      "^.+$": {"type": ["string", "number", "null"]}
+                    }
+                  }
+              },
+              "additionalProperties": false
+          },
+
+          "mac_address": {"type": "string"},
+          "network_mode": {"type": "string"},
+
+          "networks": {
+            "oneOf": [
+              {"$ref": "#/definitions/list_of_strings"},
+              {
+                "type": "object",
+                "patternProperties": {
+                  "^[a-zA-Z0-9._-]+$": {
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "aliases": {"$ref": "#/definitions/list_of_strings"},
+                          "ipv4_address": {"type": "string"},
+                          "ipv6_address": {"type": "string"}
+                        },
+                        "additionalProperties": false
+                      },
+                      {"type": "null"}
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "pid": {"type": ["string", "null"]},
+
+          "ports": {
+            "type": "array",
+            "items": {
+              "type": ["string", "number"],
+              "format": "ports"
+            },
+            "uniqueItems": true
+          },
+
+          "privileged": {"type": "boolean"},
+          "read_only": {"type": "boolean"},
+          "restart": {"type": "string"},
+          "security_opt": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "shm_size": {"type": ["number", "string"]},
+          "sysctls": {"$ref": "#/definitions/list_or_dict"},
+          "stdin_open": {"type": "boolean"},
+          "stop_grace_period": {"type": "string", "format": "duration"},
+          "stop_signal": {"type": "string"},
+          "tmpfs": {"$ref": "#/definitions/string_or_list"},
+          "tty": {"type": "boolean"},
+          "ulimits": {
+            "type": "object",
+            "patternProperties": {
+              "^[a-z]+$": {
+                "oneOf": [
+                  {"type": "integer"},
+                  {
+                    "type":"object",
+                    "properties": {
+                      "hard": {"type": "integer"},
+                      "soft": {"type": "integer"}
+                    },
+                    "required": ["soft", "hard"],
+                    "additionalProperties": false
+                  }
+                ]
+              }
+            }
+          },
+          "user": {"type": "string"},
+          "userns_mode": {"type": "string"},
+          "volumes": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "working_dir": {"type": "string"}
+        },
+        "additionalProperties": false
+      },
+
+      "healthcheck": {
+        "id": "#/definitions/healthcheck",
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "disable": {"type": "boolean"},
+          "interval": {"type": "string"},
+          "retries": {"type": "number"},
+          "test": {
+            "oneOf": [
+              {"type": "string"},
+              {"type": "array", "items": {"type": "string"}}
+            ]
+          },
+          "timeout": {"type": "string"}
+        }
+      },
+      "deployment": {
+        "id": "#/definitions/deployment",
+        "type": ["object", "null"],
+        "properties": {
+          "mode": {"type": "string"},
+          "replicas": {"type": "integer"},
+          "labels": {"$ref": "#/definitions/labels"},
+          "update_config": {
+            "type": "object",
+            "properties": {
+              "parallelism": {"type": "integer"},
+              "delay": {"type": "string", "format": "duration"},
+              "failure_action": {"type": "string"},
+              "monitor": {"type": "string", "format": "duration"},
+              "max_failure_ratio": {"type": "number"}
+            },
+            "additionalProperties": false
+          },
+          "resources": {
+            "type": "object",
+            "properties": {
+              "limits": {"$ref": "#/definitions/resource"},
+              "reservations": {"$ref": "#/definitions/resource"}
+            },
+            "additionalProperties": false
+          },
+          "restart_policy": {
+            "type": "object",
+            "properties": {
+              "condition": {"type": "string"},
+              "delay": {"type": "string", "format": "duration"},
+              "max_attempts": {"type": "integer"},
+              "window": {"type": "string", "format": "duration"}
+            },
+            "additionalProperties": false
+          },
+          "placement": {
+            "type": "object",
+            "properties": {
+              "constraints": {"type": "array", "items": {"type": "string"}}
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      },
+
+      "resource": {
+        "id": "#/definitions/resource",
+        "type": "object",
+        "properties": {
+          "cpus": {"type": "string"},
+          "memory": {"type": "string"}
+        },
+        "additionalProperties": false
+      },
+
+      "network": {
+        "id": "#/definitions/network",
+        "type": ["object", "null"],
+        "properties": {
+          "driver": {"type": "string"},
+          "driver_opts": {
+            "type": "object",
+            "patternProperties": {
+              "^.+$": {"type": ["string", "number"]}
+            }
+          },
+          "ipam": {
+            "type": "object",
+            "properties": {
+              "driver": {"type": "string"},
+              "config": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "subnet": {"type": "string", "format": "subnet_ip_address"}
+                  },
+                  "additionalProperties": false
+                }
+              }
+            },
+            "additionalProperties": false
+          },
+          "external": {
+            "type": ["boolean", "object"],
+            "properties": {
+              "name": {"type": "string"}
+            },
+            "additionalProperties": false
+          },
+          "internal": {"type": "boolean"},
+          "labels": {"$ref": "#/definitions/labels"}
+        },
+        "additionalProperties": false
+      },
+
+      "volume": {
+        "id": "#/definitions/volume",
+        "type": ["object", "null"],
+        "properties": {
+          "driver": {"type": "string"},
+          "driver_opts": {
+            "type": "object",
+            "patternProperties": {
+              "^.+$": {"type": ["string", "number"]}
+            }
+          },
+          "external": {
+            "type": ["boolean", "object"],
+            "properties": {
+              "name": {"type": "string"}
+            },
+            "additionalProperties": false
+          },
+          "labels": {"$ref": "#/definitions/labels"}
+        },
+        "additionalProperties": false
+      },
+
+      "string_or_list": {
+        "oneOf": [
+          {"type": "string"},
+          {"$ref": "#/definitions/list_of_strings"}
+        ]
+      },
+
+      "list_of_strings": {
+        "type": "array",
+        "items": {"type": "string"},
+        "uniqueItems": true
+      },
+
+      "list_or_dict": {
+        "oneOf": [
+          {
+            "type": "object",
+            "patternProperties": {
+              ".+": {
+                "type": ["string", "number", "null"]
+              }
+            },
+            "additionalProperties": false
+          },
+          {"type": "array", "items": {"type": "string"}, "uniqueItems": true}
+        ]
+      },
+
+      "labels": {
+        "oneOf": [
+          {
+            "type": "object",
+            "patternProperties": {
+              ".+": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          },
+          {"type": "array", "items": {"type": "string"}, "uniqueItems": true}
+        ]
+      },
+
+      "constraints": {
+        "service": {
+          "id": "#/definitions/constraints/service",
+          "anyOf": [
+            {"required": ["build"]},
+            {"required": ["image"]}
+          ],
+          "properties": {
+            "build": {
+              "required": ["context"]
+            }
+          }
+        }
+      }
+    }
+  }