Manifest version 06

What's new

• pipeline: Declares this image as a pipeline image.

Overview

Manifests of version io.batchx.manifest-06 are JSON documents containing for following information:

Field Name	Description	Required
name	Image name.	true
version	Image version.	true
title	Short description of the purpose of the image.	true
readme	Detailed image documentation. Markdown supported.	false
scm	Source code repository URL.	false
author	Image creator.	true
schema	Section where image inputs and outputs must be defined.	true
errorCodes	Error codes that might be returned. Keys must be integer numbers.	false
warningCodes	Warning codes that might be returned. Keys must be integer numbers.	false
runtime	Section that defines the minimum resident set size (RSS) memory assigned to the container (in MB) and GPU usage.	true
changeLog	Description of how this version improves the previous one.	false
pipeline	Declares this image as a pipeline image.	false

Definition

More precisely, io.batchx.manifest-06 manifests are JSON documents adhering to the following JSON schema:

JSON Schema for io.batchx.manifest-06

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": [
    "name",
    "title",
    "schema",
    "author",
    "version",
    "runtime",
    "changeLog"
  ],
  "additionalProperties": false,
  "properties": {
    "name": {
      "type": "string",
      "description": "Image name",
      "maxLength": 60
    },
    "version": {
      "type": "string",
      "description": "Semantic version of the image",
      "maxLength": 15,
      "pattern": "^\\d+\\.\\d+\\.\\d+$"
    },
    "title": {
      "type": "string",
      "description": "Short description of the purpose of the image",
      "maxLength": 100
    },
    "readme": {
      "type": "string",
      "description": "Detailed image documentation. Markdown supported"
    },
    "changeLog": {
      "type": "string",
      "description": "Short description of what news this version brings, compared to the previous one",
      "maxLength": 80
    },
    "schema": {
      "type": "object",
      "required": ["input", "output"],
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "object",
          "description": "JSON-Schema of the input data",
          "additionalProperties": true
        },
        "output": {
          "type": "object",
          "description": "JSON-Schema of the output data",
          "additionalProperties": true
        }
      }
    },
    "errorCodes": {
      "description": "Error codes that might be returned. Keys must be integer numbers",
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "warningCodes": {
      "description": "Warning return codes that might be returned. Keys must be integer numbers",
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "author": {
      "type": "string",
      "description": "Individual or environment",
      "maxLength": 40
    },
    "scm": {
      "type": "string",
      "description": "Source code repository URL",
      "maxLength": 70
    },
    "pipeline": {
      "type": "boolean",
      "description": "Whether this image implements a pipeline or a single tool"
    },
    "runtime": {
      "type": "object",
      "required": ["minMem"],
      "additionalProperties": false,
      "properties": {
        "gpus": {
          "type": "string",
          "description": "Indicates whether the image requires at least one gpu to run",
          "enum": ["required", "supported"]
        },
        "minMem": {
          "type": "integer",
          "description": "Minimum RSS limit for the container (in MB)"
        }
      }
    }
  }
}