jenkins-lib/resources/schema.json

{
  "type" : "object",
  "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:JobConfiguration",
  "properties" : {
    "v8version" : {
      "type" : "string",
      "description" : "Версия платформы 1С:Предприятие в формате 8.3.хх.хххх."
    },
    "srcDir" : {
      "type" : "string",
      "description" : "Путь к корневому каталогу с исходниками конфигурации, в случае хранения исходников в формате EDT, необходимо указать путь к проекту"
    },
    "sourceFormat" : {
      "type" : "string",
      "description" : "Формат исходников конфигурации",
      "enum" : [ "edt", "designer" ]
    },
    "defaultBranch" : {
      "type" : "string",
      "description" : "Имя ветки по умолчанию. Значение по умолчанию - main."
    },
    "secrets" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:Secrets",
      "description" : "Идентификаторы сохраненных секретов",
      "properties" : {
        "storagePath" : {
          "type" : "string",
          "description" : "Путь к хранилищу конфигурации"
        },
        "storage" : {
          "type" : "string",
          "description" : "Данные авторизации в хранилище конфигурации"
        }
      }
    },
    "stages" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:StageFlags",
      "description" : "Включение этапов сборок",
      "properties" : {
        "sonarqube" : {
          "type" : "boolean",
          "description" : "Анализ SonarQube включен"
        },
        "syntaxCheck" : {
          "type" : "boolean",
          "description" : "Синтаксический контроль включен"
        },
        "edtValidate" : {
          "type" : "boolean",
          "description" : "Валидация EDT включена"
        },
        "smoke" : {
          "type" : "boolean",
          "description" : "Дымовые тесты включены"
        },
        "initSteps" : {
          "type" : "boolean",
          "description" : "Предварительные шаги инициализации включены"
        },
        "bdd" : {
          "type" : "boolean",
          "description" : "Запуск BDD сценариев включен"
        }
      }
    },
    "timeout" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:TimeoutOptions",
      "description" : "Настройка таймаутов для шагов",
      "properties" : {
        "edtToDesignerFormatTransformation" : {
          "type" : "integer",
          "description" : "Таймаут шага трансформации исходников из формата EDT в формат Конфигуратора, в минутах.\n    По умолчанию содержит значение 60.\n    "
        },
        "createInfoBase" : {
          "type" : "integer",
          "description" : "Таймаут шага создания информационной базы, в минутах.\n    По умолчанию содержит значение 60.\n    "
        },
        "initInfoBase" : {
          "type" : "integer",
          "description" : "Таймаут шага инициализации информационной базы, в минутах.\n    По умолчанию содержит значение 60.\n    "
        },
        "zipInfoBase" : {
          "type" : "integer",
          "description" : "Таймаут шага архивирования информационной базы, в минутах.\n    По умолчанию содержит значение 60.\n    "
        },
        "designerToEdtFormatTransformation" : {
          "type" : "integer",
          "description" : "Таймаут шага трансформации исходников из формата Конфигуратора в формат EDT, в минутах.\n    По умолчанию содержит значение 60.\n    "
        },
        "edtValidate" : {
          "type" : "integer",
          "description" : "Таймаут шага валидации EDT, в минутах.\n    По умолчанию содержит значение 240.\n    "
        },
        "resultTransformation" : {
          "type" : "integer",
          "description" : "Таймаут шага трансформации результатов EDT, в минутах.\n    По умолчанию содержит значение 10.\n    "
        },
        "bdd" : {
          "type" : "integer",
          "description" : "Таймаут шага проверки сценариев поведения, в минутах.\n    По умолчанию содержит значение 120.\n    "
        },
        "syntaxCheck" : {
          "type" : "integer",
          "description" : "Таймаут шага синтаксического контроля, в минутах.\n    По умолчанию содержит значение 240.\n    "
        },
        "smoke" : {
          "type" : "integer",
          "description" : "Таймаут шага дымовых тестов, в минутах.\n    По умолчанию содержит значение 240.\n    "
        },
        "sonarqube" : {
          "type" : "integer",
          "description" : "Таймаут шага статического анализа SonarQube, в минутах.\n    По умолчанию содержит значение 90.\n    "
        }
      }
    },
    "initInfobase" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:InitInfobaseOptions",
      "description" : "Настройки шага инициализации ИБ",
      "properties" : {
        "initMethod" : {
          "type" : "string",
          "description" : "\n    Способ инициализации информационной базы.\n    Поддерживается три варианта:\n        * fromStorage - инициализация информационной базы из хранилища конфигурации;\n        * fromSource - инициализация информационной базы из исходников конфигурации;\n        * defaultBranchFromStorage - инициализация основной ветки из хранилища конфигурации, остальных - из исходников конфигурации.\n    По умолчанию содержит значение \"fromStorage\".",
          "enum" : [ "fromStorage", "fromSource", "defaultBranchFromStorage" ]
        },
        "runMigration" : {
          "type" : "boolean",
          "description" : "Запустить миграцию ИБ"
        },
        "additionalInitializationSteps" : {
          "type" : "array",
          "description" : "Дополнительные шаги, запускаемые через vrunner.\n    В каждой строке передается отдельная команда \n    vrunner и ее аргументы (например, \"vanessa --settings ./tools/vrunner.first.json\")\n    ",
          "items" : {
            "type" : "string"
          }
        }
      }
    },
    "bdd" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:BddOptions",
      "description" : "Настройки шага запуска BDD сценариев",
      "properties" : {
        "vrunnerSteps" : {
          "type" : "array",
          "description" : "Шаги, запускаемые через vrunner.\n    В каждой строке передается отдельная команда \n    vrunner и ее аргументы (например, \"vanessa --settings ./tools/vrunner.json\").\n    По умолчанию содержит одну команду \"vanessa --settings ./tools/vrunner.json\".\n    ",
          "items" : {
            "type" : "string"
          }
        }
      }
    },
    "sonarqube" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:SonarQubeOptions",
      "description" : "Настройки анализа SonarQube",
      "properties" : {
        "sonarQubeInstallation" : {
          "type" : "string",
          "description" : "Имя настроенного SonarQube-сервера (SonarQube installations).\nЕсли настроен только один сервер, то может быть оставлено пустым."
        },
        "useSonarScannerFromPath" : {
          "type" : "boolean",
          "description" : "Использовать sonar-scanner, доступный в PATH"
        },
        "sonarScannerToolName" : {
          "type" : "string",
          "description" : "Имя настроенной утилиты sonar-scanner.\nПрименяется, если useSonarScannerFromPath установлено в false."
        },
        "infoBaseUpdateModuleName" : {
          "type" : "string",
          "description" : "Имя общего модуля (например, ОбновлениеИнформационнойБазыXXX), в котором указана версия библиотеки.\n    Версия должна задаваться в виде присвоения `Описание.Версия = \"ваш номер версии\";`\n    "
        },
        "useBranchPlugin" : {
          "type" : "boolean",
          "description" : "Используется ли Branch-plugin в SonarQube"
        }
      }
    },
    "syntaxCheck" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:SyntaxCheckOptions",
      "description" : "Настройки синтаксического контроля",
      "properties" : {
        "pathToJUnitReport" : {
          "type" : "string",
          "description" : "Путь к файлу отчета jUnit\n    По умолчанию содержит значение \"./build/out/jUnit/syntax.xml\"\n    "
        },
        "groupErrorsByMetadata" : {
          "type" : "boolean",
          "description" : "Группировать выявленные ошибки по объектам метаданных.\n    По умолчанию включено.\n    "
        },
        "checkModes" : {
          "type" : "array",
          "description" : "Режимы проверки конфигурации",
          "items" : {
            "type" : "string"
          }
        },
        "exceptionFile" : {
          "type" : "string",
          "description" : "Путь к файлу с указанием пропускаемых ошибок.\n    Формат файла: в каждой строке файла указан текст пропускаемого исключения или его часть\n    Кодировка: UTF-8\n    "
        },
        "vrunnerSettings" : {
          "type" : "string",
          "description" : "Путь к конфигурационному файлу vanessa-runner.\n    По умолчанию содержит значение \"./tools/vrunner.json\".\n    "
        }
      }
    },
    "smoke" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:SmokeTestOptions",
      "description" : "Настройки дымового тестирования",
      "properties" : {
        "vrunnerSettings" : {
          "type" : "string",
          "description" : "Путь к конфигурационному файлу vanessa-runner.\n    По умолчанию содержит значение \"./tools/vrunner.json\".\n    "
        },
        "xddConfigPath" : {
          "type" : "string",
          "description" : "Путь к конфигурационному файлу для xddTestRunner.\n    По умолчанию содержит значение \"./tools/xUnitParams.json\".\n    "
        },
        "publishToAllureReport" : {
          "type" : "boolean",
          "description" : "Выполнять публикацию результатов в отчет Allure.\n    По умолчанию выключено.\n    "
        },
        "publishToJUnitReport" : {
          "type" : "boolean",
          "description" : "Выполнять публикацию результатов в отчет JUnit.\n    По умолчанию включено.\n    "
        }
      }
    },
    "resultsTransform" : {
      "type" : "object",
      "id" : "urn:jsonschema:ru:pulsar:jenkins:library:configuration:ResultsTransformOptions",
      "description" : "Настройки трансформации результатов анализа",
      "properties" : {
        "removeSupport" : {
          "type" : "boolean",
          "description" : "Фильтровать замечания по уровню поддержки модуля. По умолчанию включено."
        },
        "supportLevel" : {
          "type" : "integer",
          "description" : "Настройка фильтрации замечаний по уровню поддержки.\n        0 - удалить файлы на замке;\n        1 - удалить файлы на замке и на поддержке;\n        2 - удалить файлы на замке, на поддержке и снятые с поддержки.\n    "
        }
      }
    },
    "logosConfig" : {
      "type" : "string",
      "description" : "Конфигурация библиотеки logos. Применяется перед запуском каждой стадии сборки"
    }
  }
}